小团队需要管理代码,不一定要先搭一套带网页界面的代码平台。在阿里云ECS上安装Git,再通过SSH密钥访问裸仓库,就能完成日常的克隆和推送。仓库放在自己的云主机上,访问方式和目录权限都能自行安排;系统更新、备份和安全维护也要由团队负责。
本文以常见的阿里云Linux实例为例,介绍从准备环境到团队使用的基本做法。命令适用于常见的Ubuntu或Alibaba Cloud Linux环境,软件包管理命令可能因系统版本而异。若团队需要网页浏览、合并请求、代码审查或持续集成,可以再评估GitLab等平台;这类服务对资源和运维能力的要求更高。
一、先确定部署方式
Git支持通过SSH访问远程仓库,轻量部署不需要额外安装网页管理平台。个人或小团队通常可以采用“专用git用户+SSH公钥+裸仓库”的方式:
- 裸仓库:只保存Git版本数据,不直接在仓库目录里编辑项目文件。
- SSH认证:通过公钥验证用户身份,避免用账号密码进行Git访问。
- 专用账号:将仓库访问和日常系统管理分开,减少权限混用。
如果团队要在网页上审批合并、管理议题或运行流水线,裸仓库不会自动提供这些功能,需要另行设计流程或使用具备相关能力的平台。先按实际协作需求选方案,能避免服务器搭好后才发现功能不够用。
二、准备阿里云ECS
创建Linux实例时,配置可以从项目实际规模出发,再根据仓库体积、并发访问和构建任务调整。磁盘除了存放代码,还要预留备份空间;重要数据可以放在独立数据盘,避免系统盘写满后影响服务。
在阿里云控制台的安全组中,只开放必要端口。SSH默认使用22端口;如果更改了端口,安全组和客户端连接配置也要同步调整。管理端口不要对所有来源开放,条件允许时将SSH来源限制为团队固定出口IP。成员网络地址经常变化时,可以考虑通过VPN或堡垒机管理入口。
登录实例后先更新系统并安装Git。Ubuntu可执行:
apt update && apt install git
Alibaba Cloud Linux使用对应的yum或dnf命令。安装后运行git --version确认结果,再检查系统时间、磁盘空间和网络状态。
三、创建Git账号、配置密钥和仓库
创建专用用户git,并准备统一的仓库存放目录。下面以/srv/git为例:
sudo useradd -m -s /bin/bash git
sudo mkdir -p /srv/git
sudo chown git:git /srv/git
每位开发者在自己的电脑上生成SSH密钥,例如运行ssh-keygen -t ed25519,再把公钥内容交给管理员。公钥可以写入服务器git用户的authorized_keys文件;私钥由开发者本人保管,不要上传到服务器,也不要通过群聊传递。
设置SSH目录和授权文件权限,避免权限过宽导致认证失败:
sudo -u git mkdir -p /home/git/.ssh
sudo chown -R git:git /home/git/.ssh
sudo chmod 700 /home/git/.ssh
sudo chmod 600 /home/git/.ssh/authorized_keys
不同系统上的用户家目录可能不同,配置前先确认git用户实际使用的路径。管理员新增成员时登记其公钥;成员离职或设备遗失时,应及时从authorized_keys中移除对应公钥。
创建裸仓库,例如项目名为demo.git:
sudo -u git git init –bare /srv/git/demo.git
开发者在本地添加远程地址:
git remote add origin git@服务器公网IP:/srv/git/demo.git
首次连接时,客户端会要求确认服务器主机指纹。先通过可信渠道核对指纹,再接受连接。确认后即可使用git push推送,或使用git clone克隆仓库。若SSH使用非默认端口,需要通过SSH配置文件或相应连接参数指定端口。
四、五人团队迁移内部项目的做法
一个五人开发团队原先用移动硬盘和共享网盘交换代码,出现过版本覆盖、提交记录不完整等问题。迁移时,他们把已有项目整理成Git仓库,在ECS上为每个项目建立独立裸仓库,统一放在/srv/git下,再由管理员登记五名成员的公钥。
团队没有让所有开发者都拥有Linux管理员权限,而是只开放Git SSH访问。开发者通过各自的密钥提交代码,系统管理员负责服务器维护和成员授权。项目负责人另行约定分支规则,例如main分支只接受检查过的改动,日常开发使用功能分支。
要留意,原生Git SSH访问不会自带网页审批或代码审查。团队可以通过内部约定落实检查流程;如果需要分支保护、合并审批等功能,就要采用相应工具或评估带网页管理能力的平台。
运行一段时间后,团队也发现,仓库在一台服务器上并不等于有了可靠备份。他们定期将仓库打包或镜像到另一块磁盘,并把加密副本同步到独立存储位置。备份任务要记录执行结果,还应定期在临时目录中测试恢复,确认文件能用,而不只是确认任务曾经运行。
五、安全与日常维护
- 限制访问范围:安全组只开放必要端口,并尽量限制SSH来源。若要关闭SSH密码认证,先确认公钥登录正常,且留有可用的应急管理通道。
- 分开管理权限:git账号用于仓库访问,不用于日常sudo管理。检查仓库目录和授权文件的所有者与权限,避免为了解决推送问题而随意放宽权限。
- 定期更新系统:安装安全更新,并查看SSH登录日志和系统告警。更改SSH端口可能减少扫描噪声,但不能代替密钥认证和访问控制。
- 安排备份和恢复:明确备份频率、保留周期和存放位置。备份应尽量与源服务器分开,并实际做恢复测试。
- 检查磁盘空间:仓库会随提交历史和大文件增加而变大。定期检查磁盘使用情况,避免空间耗尽后推送失败或影响系统运行。
六、常见问题排查
遇到Permission denied (publickey),先确认客户端使用的是正确私钥,再检查对应公钥是否完整写入authorized_keys,以及服务器上的文件所有者和权限是否正确。连接用户名也应是git,而不是实例默认登录账号。
提示仓库不存在或无法写入时,核对远程地址、仓库目录名称,以及git用户对目标目录的访问权限。如果报错与分支有关,先检查本地分支名、远端分支状态和团队约定的推送方式,不要直接通过放宽服务器目录权限来绕过问题。
连接超时则依次检查实例运行状态、SSH服务、安全组、系统防火墙和客户端网络。排查时不要长期开放全部端口,问题定位后应恢复为只开放必要端口。
结语
阿里云Linux Git服务器适合希望自行管理代码存放位置、并具备基本Linux维护能力的个人和小团队。部署本身不复杂,后续要持续管理密钥、访问权限、系统更新和备份恢复。随着团队人数或协作流程增加,再评估是否需要迁移到带网页管理和审查功能的平台。