本地写好代码后,常见做法是推送到代码仓库,再由阿里云服务器拉取并运行。配置好阿里云服务器 git 环境,可以省去反复上传文件的步骤;但 Git 只负责管理和同步代码,项目依赖、服务启动和网络配置仍要单独处理。下面以 Linux 服务器为例,说明从安装 Git 到更新项目的基本流程。
先分清 Git、服务器和代码仓库
Git 用来记录代码变更,阿里云服务器负责运行项目,代码仓库则用于保存和共享代码,可以托管在 GitHub、GitLab、Gitee 等平台,也可以自建。通常,开发者先把代码推送到远程仓库,再让服务器克隆项目或拉取更新。
代码已经拉到服务器,不等于网站已经上线。项目可能还需要安装运行环境和依赖、填写环境变量、构建文件并启动服务;网站无法访问时,也要检查安全组、防火墙和服务监听端口。排查时把这些环节分开看,比较容易找到问题所在。
登录服务器并安装 Git
先通过 SSH 登录阿里云服务器。连接前确认实例的公网连接方式和安全组规则。SSH 默认端口通常是 22;如果实例改过端口,连接时也要使用对应端口。管理端口不宜长期对所有来源开放,最好按实际管理需要限制来源地址。
登录后,根据服务器发行版安装 Git。以下命令适用于常见系统,具体命令可能随系统版本有所不同:
- Ubuntu 或 Debian:执行
sudo apt update更新软件包索引,再运行sudo apt install git -y。 - Alibaba Cloud Linux、CentOS 或 RHEL 系:可运行
sudo dnf install git -y。较旧版本可能使用yum。
安装后执行 git --version,终端显示版本号就表示 Git 已可使用。若服务器上还要提交代码,可以配置提交者名称和邮箱:
git config --global user.name "你的名称"git config --global user.email "你的邮箱"
这两项用于标记提交记录。服务器只负责克隆和拉取代码时,一般不需要配置提交者信息。
连接代码仓库:HTTPS 或 SSH
公开仓库通常可以直接使用 HTTPS 地址克隆。先进入准备存放项目的目录,再执行:
git clone 仓库HTTPS地址
私有仓库需要验证访问权限。不要把账号密码或访问令牌写进部署脚本、项目文件或容易留存的命令中。服务器需要持续访问仓库时,SSH 密钥通常更方便,也便于单独控制部署权限。
用 SSH 密钥访问私有仓库
- 在服务器上生成一组部署用密钥,例如执行
ssh-keygen -t ed25519 -C "deploy-key"。按提示选择保存位置,并保护好生成的私钥。 - 用
cat ~/.ssh/id_ed25519.pub查看公钥内容。 - 将公钥添加到代码托管平台的部署密钥设置中。如果服务器只需要下载代码,尽量使用只读权限。
- 按平台说明测试 SSH 连接,再使用仓库提供的 SSH 地址执行
git clone。
私钥留在服务器上,不要放进网站目录、代码仓库或聊天记录。多人共用服务器时,也要避免多个项目随意共用权限过大的密钥。
克隆项目并拉取更新
首次部署时使用 git clone 下载仓库。之后进入项目目录,先运行 git status 查看工作区状态,再拉取远程更新。可以明确指定分支,例如 git pull origin main;如果仓库使用的默认分支不是 main,就替换成实际分支名。
执行拉取前,先确认服务器上的文件有没有本地修改。若本地改动与远程版本冲突,Git 可能要求解决冲突;未保存的修改也可能影响更新。生产环境尽量不要直接在服务器上改业务代码,通常应在本地完成修改和测试、推送到仓库,再由服务器拉取。
示例:更新阿里云服务器上的网站
假设小李在 Gitee 维护一个网站项目,服务器安装的是 Ubuntu。首次部署时,他先安装 Git,再把服务器生成的只读 SSH 公钥添加到仓库部署密钥中。随后进入应用目录的上一级目录,运行 git clone,把项目下载到服务器。
代码下载后,小李按照项目说明安装依赖、填写环境配置,并用项目规定的方式启动服务。上线前,他检查阿里云安全组,只开放网站实际需要的访问端口,没有把数据库端口直接暴露给公网。
之后要更新网站,他先在本地完成修改、测试并推送代码,再登录服务器执行:
cd /项目路径git statusgit pull origin main
代码拉取成功后,还要根据项目要求重新构建或重启应用,并访问网站确认页面正常。Git 完成的是代码同步;依赖、服务管理和网络设置仍要结合项目架构处理。
常见报错怎么查
- Permission denied:检查当前用户是否有项目目录的读写权限。使用 SSH 时,确认公钥已添加到仓库,并检查客户端是否使用了对应私钥。
- Repository not found:核对仓库地址和项目是否存在,再确认当前账号或密钥是否有权限访问。私有仓库权限不足时,也可能出现这类提示。
- 连接仓库超时:检查服务器网络、DNS 和到代码托管平台的连通情况。如果出站访问受到限制,需要结合服务器的网络策略排查。
- 拉取时出现冲突:先看
git status,备份要保留的本地修改,再按 Git 提示处理冲突。不要没确认改动内容就使用强制覆盖命令。 - 代码更新了,网站却没变化:确认项目是否需要重新构建或重启,也要检查 Web 服务指向的目录是否就是当前仓库目录。
部署时别忽略权限和验证
部署账号和密钥应只拥有完成工作所需的权限,并定期检查是否仍在使用。生产环境发布前保留可回滚的版本,更新后查看服务状态并实际访问网站。数据库密码、访问令牌等配置应与代码分开保存,不要提交到公开仓库。
如果项目更新频繁,可以考虑用 CI/CD 工具自动测试和部署,但自动化也需要设置权限边界、失败回滚方式和日志监控。刚开始部署时,把手动流程跑通并确认每一步的结果,再逐步自动化,通常更容易排查问题。
阿里云服务器 git 部署的基本过程是安装 Git、配置仓库访问、克隆项目、拉取更新,再按项目要求构建和启动。密钥权限、网络规则和发布后的检查,都会影响网站能否安全稳定地运行。