把代码放在 GitHub、把应用运行在阿里云服务器,是个人开发者和小团队常见的部署方式。GitHub 用来保存代码、管理版本和协作,服务器负责运行网站或接口。两边建立连接后,代码不会自动变成可访问的网站:还要处理仓库权限、运行环境、发布步骤和故障回退。
一条常见的部署链路是:开发者把代码推送到 GitHub,服务器获取指定版本,安装依赖并构建,再启动或重启应用。刚开始可以先手动完成这套流程,确认服务能正常运行后再自动化。这样出了问题,比较容易分清是代码、服务器环境还是部署脚本导致的。
案例:部署一个 Node.js 网站
假设一家小型工作室要上线产品介绍网站,项目使用 Node.js,代码存放在 GitHub 私有仓库。团队希望尽量减少初期配置,同时避免把服务器账号和敏感信息放进代码仓库。可以按下面的顺序准备。
准备服务器和运行环境
先确认阿里云服务器的操作系统、网络和登录方式。Linux 发行版可以选团队熟悉的版本;通过 SSH 登录后更新系统软件,并安装与项目要求匹配的 Node.js 版本。版本号要对照项目文档和依赖文件核实,别只看系统软件源里默认提供什么。
接着检查阿里云安全组和系统防火墙。只开放业务需要的端口:常见配置是开放 SSH 管理端口,以及网站使用的 80、443 端口。Node.js 应用可以只监听本机或内网端口,再由 Nginx 接收公网请求并转发过去。SSH 不宜长期向所有来源开放;条件允许时,可以限制来源 IP,并使用密钥登录。
配置 GitHub 仓库访问权限
公开仓库可以通过 HTTPS 获取代码;私有仓库需要授权。服务器单独生成一组 SSH 密钥,再将公钥添加到对应 GitHub 仓库的只读 Deploy Key,是一种权限范围较小的做法。服务器凭据即使发生泄露,读取权限也能限制在指定仓库。
不要把 GitHub 账号密码、访问令牌或 SSH 私钥写进代码、配置文件或部署命令。数据库密码、云服务密钥等信息也不应提交到仓库。应用运行所需的环境变量可以保存在服务器上受控的配置文件中,设置适当的文件权限;如果使用密钥管理方案,也要限制可读取这些配置的账号。
拉取代码并启动应用
仓库授权完成后,在服务器上克隆项目,按项目文档安装依赖、配置环境变量并执行构建。应用启动后,可用 PM2 或 systemd 等进程管理工具维持运行,避免 SSH 会话结束时进程也退出。Nginx 则可以把域名请求转发给本机的 Node.js 服务,并配合配置 HTTPS。
部署时要核对项目自己的启动要求:入口文件是否正确,应用端口是否与 Nginx 配置一致,静态文件是否生成,数据库是否能够连接。别只确认命令没有报错就直接切换正式流量。可以先用测试域名或临时端口检查页面、接口和应用日志,确认正常后再开放给用户。
什么时候从手动部署改为自动发布
手动部署适合项目刚开始运行时使用。更新变多以后,每次登录服务器、拉取代码、安装依赖和重启应用,容易漏掉步骤。此时可以用 GitHub Actions 等 CI/CD 工具,在代码推送或合并到指定分支后自动运行测试和部署任务。
一条常见的自动发布流程是:先做代码检查和测试,再构建部署文件,通过安全的连接方式传到服务器,最后执行发布脚本。GitHub Actions 所需的密钥应放在仓库或组织的 Secrets 中,不要直接写进工作流文件。自动部署最好使用专用账号,并限制它能执行的操作;不需要系统管理员权限时,就不要授予。
自动化也不等于每次提交都直接上线。业务网站可以只在代码合并到主分支后部署;对稳定性要求更高的项目,可以先发到预发布环境,检查通过后再切换正式版本。保留上一版可运行程序或镜像,发布异常时才有条件尽快回退。
上线后要检查的事项
网络与安全
核对域名解析、公网地址、安全组和系统防火墙规则是否一致,关闭不需要的端口。系统和依赖需要定期更新,也要留意 SSH 登录记录。面向公众提供服务时,应配置 HTTPS,并根据业务需要检查访问日志和基础防护措施。
备份与恢复
GitHub 仓库能帮助恢复代码,但不包含所有运行数据。数据库、用户上传文件、服务器配置和证书可能需要分别备份。提前确定备份频率和保存位置,并实际演练恢复步骤;只有文件在备份目录里,还不能证明故障时一定能恢复。
监控与费用
留意 CPU、内存、磁盘空间、网络流量和应用错误日志。磁盘写满、进程意外退出或证书过期,都可能导致服务中断。阿里云服务器的配置和带宽应按实际负载选择,也要定期检查账单、快照和公网流量等资源使用情况,及时处理不再需要的资源。
阿里云服务器连接 GitHub 后,可以先用手动方式跑通代码获取、环境配置和应用启动,再根据更新频率加入自动测试与部署。把仓库权限、敏感配置、备份和回退提前安排好,后续排查故障和维护服务会省去不少麻烦。