团队要托管代码,未必需要马上购买商业代码平台。如果已经有一台阿里云ECS,可以把它配置成Git远程仓库:开发者通过SSH推送、拉取代码,服务器保存仓库数据。本文以Ubuntu为例,说明从准备服务器到首次推送的基本做法,也会提到权限、安全和备份中容易忽略的地方。
一、先看这种方案是否适合团队
自建Git服务器适合小团队、内部项目,或需要自行管理代码存储位置的场景。它可以复用现有云服务器,仓库位置和访问方式也由团队自己掌握。不过,账号管理、仓库权限、备份和故障处理都要自行负责。如果团队需要合并请求、网页代码评审或持续集成,裸Git仓库提供的功能就不够了,可以考虑部署Gitea、GitLab等代码平台。
下面采用裸仓库方案。裸仓库保存Git版本数据,不带可直接编辑的工作目录,适合作为多人共同使用的远程仓库。示例环境为Ubuntu 22.04阿里云ECS,通过SSH连接,使用默认的22端口;仓库由专用git用户管理,名称为project.git。
二、准备阿里云ECS
在阿里云控制台创建或选择一台ECS,使用仍在维护周期内的Linux发行版,并为系统盘留出足够空间。团队成员需要通过公网IP连接服务器;如果实例没有公网IP,则要先配置合适的内网接入方式。
检查实例安全组的入方向规则。如果SSH使用默认端口22,就需要允许团队实际使用的来源IP访问。办公网络有固定公网IP时,优先限制来源范围,不要为了方便把SSH端口对所有来源开放。登录服务器后更新软件包并安装Git:
sudo apt update
sudo apt install -y git
其他Linux发行版的安装命令可能不同,按对应系统的软件包管理器执行即可。
三、创建专用Git账号和仓库
建议单独创建仓库服务账号,不要直接用个人日常登录账号管理代码。创建git用户,并准备SSH配置目录和授权文件:
sudo adduser --disabled-password --gecos "" git
sudo install -d -o git -g git -m 700 /home/git/.ssh
sudo touch /home/git/.ssh/authorized_keys
sudo chown git:git /home/git/.ssh/authorized_keys
sudo chmod 600 /home/git/.ssh/authorized_keys
接着创建裸仓库。示例把仓库放在/home/git/repos下,后续有多个项目时也可以在这个目录中分类管理:
sudo -u git mkdir -p /home/git/repos
sudo -u git git init --bare /home/git/repos/project.git
project.git就是之后远程地址指向的目录。不要把它当作普通项目文件夹,在服务器上直接编辑文件;开发者应在自己的工作目录中修改代码,再通过Git与远程仓库同步。
四、配置开发者SSH公钥
每位开发者使用自己的SSH密钥,不要多人共用一把私钥。如果电脑上还没有密钥,可以在本地生成一对:
ssh-keygen -t ed25519 -C "developer@example.com"
生成后,把公钥文件的内容交给服务器管理员。公钥通常位于~/.ssh/id_ed25519.pub。管理员先将公钥文件上传到服务器,再追加到授权文件中:
sudo sh -c 'cat /tmp/developer.pub >> /home/git/.ssh/authorized_keys'
sudo chown git:git /home/git/.ssh/authorized_keys
sudo chmod 600 /home/git/.ssh/authorized_keys
示例中的/tmp/developer.pub要替换成实际上传后的文件路径。授权文件可以有多行,每位开发者的公钥各占一行。私钥只留在开发者自己的设备上,不要上传到服务器,也不要通过聊天工具随意转发。
五、首次连接并推送代码
公钥配置完成后,开发者可以先测试SSH连接:
ssh git@你的ECS公网IP
第一次连接时,SSH可能会提示确认服务器指纹。确认指纹来源可信后再接受。连接正常后,在本地已有项目目录中添加远程仓库并推送分支:
git remote add origin git@你的ECS公网IP:/home/git/repos/project.git
git push -u origin main
如果本地分支名是master,把命令中的main改成master。其他成员可以用下面的命令克隆仓库:
git clone git@你的ECS公网IP:/home/git/repos/project.git
连接失败时,可以按顺序检查安全组是否放行SSH、服务器的sshd服务是否正常、公钥是否完整写入authorized_keys,以及相关目录和文件权限是否正确。需要查看连接细节时,可运行ssh -v git@服务器地址。
六、三人团队迁移内部工具项目
例如,一个三人团队原先通过压缩包传递内部脚本,经常分不清哪个文件才是最新版本。团队在阿里云ECS上创建project.git裸仓库,为三名开发者分别收集公钥并加入授权文件。负责人先推送代码,其他成员再通过SSH地址克隆项目。日常开发时,成员在本地提交后执行git push同步。提交历史可以帮助团队追踪改动,使用分支也能减少直接覆盖文件的情况。
需要分清的是,公钥配置解决的是“谁能通过SSH登录”,这套简单设置并没有提供精细的仓库级权限控制。如果不同项目需要不同的读写权限,或需要方便地撤销某位成员的访问权,可以给成员配置独立密钥和受限SSH规则,也可以部署Gitea、GitLab等管理平台。团队扩大后,不宜只依靠多人共用一个权限宽泛的git账号。
七、安全与日常维护
- 限制访问:安全组只开放必要端口,尽量将SSH访问限制在团队使用的来源IP范围内;系统和OpenSSH也要及时更新。
- 保护密钥:私钥设置密码并妥善保管。成员离职或设备遗失后,及时从
authorized_keys中移除对应公钥。 - 备份仓库:定期备份裸仓库目录,并把备份复制到独立存储位置。只保存在同一台ECS上的备份,无法充分应对实例故障或误删。
- 留意磁盘空间:提交、附件和分支都会增加仓库占用。定期检查磁盘使用率,并为实例和云盘留出余量。
- 检查恢复结果:备份完成不代表恢复一定可用。定期在测试环境中恢复仓库,确认能够正常克隆和读取。
阿里云服务器搭建Git服务器,主要步骤是准备ECS和SSH访问、安装Git、创建专用用户及裸仓库、配置公钥,再从本地推送代码。小团队可以先用裸仓库管理提交和同步;随着代码评审、成员管理和自动化需求增加,再考虑使用带网页管理界面的Git服务。无论采用哪种方式,都要把访问权限和备份安排好,避免仓库只存在于一台服务器上。