在个人服务器或家庭NAS上搭建代码托管服务，已经成为许多开发者和小团队的标配。群晖NAS内置的Git Server套件，不仅能实现代码的版本控制，还能配合Web Station打造专属的代码管理中心。本文将用大白话带你一步步在群晖上跑通Git流程，从零配置到日常推代码，全程无废话，直接上手。
第一步：安装与启用Git Server套件
打开群晖DSM系统，进入套件中心，搜索Git Server。找到官方套件后点击安装。安装过程通常只需要几分钟，无需额外依赖。安装完成后，在套件列表中双击打开它。首次运行会提示创建管理员账户，建议直接使用你常用的SSH登录账号，避免权限混乱。接着设置Git仓库的存储路径，默认会创建一个名为Git的文件共享文件夹，里面会自动生成所有版本库。如果你习惯把代码存在其他目录，可以在这里自定义路径，但务必确保该目录有读写权限。
第二步：创建第一个代码仓库
回到Git Server主界面，点击新增按钮。输入仓库名称，比如my_project。注意名称不要带空格和特殊符号，否则后续命令行操作容易报错。勾选允许用户提交代码和启用SSH，这一步非常关键。SSH是本地电脑与NAS通信的标准协议，开启后你才能通过终端安全传输文件。保存后，系统会在指定路径下生成一个隐藏版本库文件。此时仓库已经就绪，等待你的代码入库。
第三步：配置SSH免密登录与端口映射
为了连接方便，建议关闭密码登录，改用密钥认证。在群晖控制面板中进入终端机和SNMP，启用SSH功能，默认端口是二十二。如果你的路由器公网访问受限，或者家里网络限制二十二号端口，可以修改为备用端口如两千二百二十二。打开本地电脑的终端，执行ssh-keygen命令生成密钥对，一路回车即可。然后用cat命令查看公钥内容，复制到剪贴板。回到群晖Git Server界面，点击编辑刚才创建的仓库，在SSH公钥栏粘贴内容并保存。这样下次推送代码时就不需要反复输入密码了。
第四步：本地电脑拉取与推送代码
现在一切准备就绪，切换到本地项目文件夹。初始化Git环境，执行git init和git add命令将文件加入追踪列表。接着设置远程地址，格式为git remote add origin ssh加斜杠斜杠用户名加at群晖IP冒号端口加斜杠Git斜杠my_project点git。这里的用户名必须是你群晖系统的登录账号，IP填内网地址或公网IP加域名，端口填之前设置的SSH端口。验证连接无误后，执行git commit命令提交初始版本，再用git push命令推送。如果一切顺利，终端会显示成功写入对象的数量，群晖上的仓库也会同步更新。
第五步：日常维护与实用技巧
代码量变大后，定期备份是关键。群晖的快照复制功能可以为Git仓库提供即时恢复点，防止误删或损坏。建议在定时任务中设置每日快照，保留最近七天的历史数据。另外，Git Server本身不提供网页可视化界面，如果需要在线浏览代码，可以搭配Docker部署Gitea。Gitea轻量且开源，占用资源极少，只需一条docker-compose指令就能跑起来，并且能自动读取群晖Git仓库的数据目录，实现无缝切换。遇到分支冲突时，先用git pull合并最新改动，再提交推送，能有效减少历史记录混乱。
常见问题排查
推送失败时，先检查防火墙是否放行SSH端口，以及网络路由是否正常。权限报错通常是因为本地生成的密钥未正确上传，重新核对公钥字符串。仓库体积增长过快时，执行git gc压缩文件，释放磁盘空间。若需多人协作，务必在群晖用户管理中为每个成员分配独立账号，并在Git Server中分别绑定他们的公钥，这样既能追溯提交者身份，又能控制仓库访问范围。整个流程跑通后，你就拥有了一个稳定、私密、完全自主控制的代码管理中心，不再依赖第三方平台。
