代码已经推到 Git 仓库,网站却还没上线?还需要让服务器拿到代码、安装依赖并运行应用。下面以 Ubuntu 阿里云 ECS、Git、Nginx 和 Node.js 为例,说明一套适合个人项目或小团队的 git 阿里云部署流程:开发者通过 SSH 推送代码,服务器接收后更新项目,再由进程管理工具运行应用。
一、准备 ECS、域名和运行环境
在阿里云控制台创建 ECS 实例,操作系统和配置按项目需要选择。安全组至少要放行 SSH 端口,以及网站对外使用的 80、443 端口。SSH 访问范围尽量限制在固定 IP 或办公网络,避免长期向所有地址开放。
登录服务器后安装 Git 和 Nginx:
sudo apt update
sudo apt install -y git nginx
Node.js 项目还需要安装与项目要求匹配的 Node.js 版本。服务器版本和本地开发环境差异过大时,依赖可能安装失败,应用也可能启动不了。部署前检查项目的启动命令、依赖锁文件,并确认域名已解析到 ECS 公网 IP。
二、创建部署账户和裸仓库
不要直接用 root 账户运行应用。可以单独创建一个部署账户,再准备 Git 裸仓库和网站目录:
sudo adduser deploy
sudo mkdir -p /srv/git /var/www/myapp
sudo chown -R deploy:deploy /srv/git /var/www/myapp
sudo -u deploy git init --bare /srv/git/myapp.git
/srv/git/myapp.git 是裸仓库,只存放 Git 版本数据,不是网站运行目录。实际代码会检出到 /var/www/myapp。
本地开发电脑需要通过 SSH 连接服务器。把本机公钥加入部署账户的 ~/.ssh/authorized_keys,并先测试能否登录。私钥应留在本地或可信的 CI 密钥管理服务中,不能提交到项目仓库,也不要复制到网站目录。
三、配置 Git 推送后的更新钩子
在裸仓库里添加 post-receive 钩子。收到推送后,钩子会把指定分支的代码检出到运行目录,并安装项目依赖:
sudo -u deploy nano /srv/git/myapp.git/hooks/post-receive
写入以下内容:
#!/bin/bash
set -e
GIT_WORK_TREE=/var/www/myapp git --git-dir=/srv/git/myapp.git checkout -f main
cd /var/www/myapp
npm ci
然后赋予钩子执行权限:
sudo chmod +x /srv/git/myapp.git/hooks/post-receive
示例使用 main 分支。如果仓库默认分支叫 master 或其他名称,要同步修改钩子中的分支名。npm ci 根据锁文件安装依赖,适合部署时保持依赖版本一致。钩子是在非交互式环境中运行的,服务器必须能找到 npm;如果后续推送时报“找不到命令”,需要检查钩子的运行环境和命令路径。
数据库密码、API 密钥等敏感配置不要写进 Git 仓库或钩子文件。把它们放在服务器上权限受控的环境文件中,并确保应用启动时能够读取。
四、从本地推送代码并启动应用
在本地项目目录添加服务器仓库地址。把示例中的公网 IP 换成实际地址,用户名、端口和仓库路径也要与服务器配置一致:
git remote add production deploy@服务器公网IP:/srv/git/myapp.git
git push production main
推送成功后,钩子会将代码检出到 /var/www/myapp 并执行 npm ci。这一步只更新文件和依赖,应用还需要通过进程管理工具持续运行。可以为项目配置 systemd 服务,在服务文件中指定运行用户、工作目录和启动命令,再执行:
sudo systemctl enable myapp
sudo systemctl start myapp
sudo systemctl status myapp
Node.js 应用通常监听本机端口,例如 127.0.0.1:3000,再由 Nginx 反向代理请求。这样公网流量经过 Nginx,应用端口不必直接开放到公网。首次上线后,检查 systemd 服务状态、Nginx 配置和错误日志,再通过域名确认页面可以正常访问。需要 HTTPS 时,还要为域名配置证书。
五、小型企业展示站的部署流程
例如,一个团队维护 Node.js 企业展示站,开发者在本地完成修改后推送到 main。服务器收到代码后安装锁文件中的依赖,systemd 管理应用进程,Nginx 再把域名请求转发到应用端口。相比每次登录服务器手动复制文件,这种做法操作更固定,也能通过 Git 提交记录查到代码变更。
要留意,前面的示例钩子只检出代码和安装依赖,并不会自动重启应用。若希望每次推送后更新生效,需要在钩子中加入经过测试的重启命令,或者交给 CI/CD 流程处理构建、测试、部署和重启。修改自动部署脚本前,先在测试环境验证;生产发布前保留可回滚的 Git 提交,避免新版本异常时只能临时手工修复。
六、排查常见问题并做好安全检查
- 推送时报权限错误:确认本机公钥已加入部署账户,仓库目录的所有者是
deploy,并检查 SSH 登录是否正常。 - 钩子执行失败:钩子没有交互式终端,命令路径可能和登录后的环境不同。检查服务器日志,必要时在脚本中使用命令的绝对路径。
- 推送成功但网站打不开:推送成功不代表应用已经运行。检查服务状态、应用监听端口、Nginx 配置、安全组规则和域名解析。
- 担心新版本影响线上:先在测试环境部署,确认测试通过后再发布;重要版本要保留回滚方案,不要只依赖手动改回文件。
个人项目可以先用 SSH 和 Git 钩子完成 git 阿里云部署,减少重复的手工操作。多人协作或业务影响较大的项目,则应逐步加入自动测试、发布记录和回滚流程,并明确部署账户权限、密钥存放位置及谁可以触发上线。