群晖NAS搭建Git Server避坑指南：为什么你的SSH连接总是失败？

群晖NAS搭建Git Server避坑指南：为什么你的SSH连接总是失败？

当你第一次尝试在群晖NAS上搭建Git Server时，可能会遇到各种SSH连接问题。明明按照官方文档一步步操作，却总是在git clone或git push时遭遇"Permission denied"或"Connection refused"。这些问题往往源于几个关键配置点的疏忽，本文将深入解析这些"坑点"并提供完整的解决方案。

1. 基础环境配置的常见误区

许多用户在安装Git Server套件后直接开始创建仓库，却忽略了底层权限系统的复杂性。群晖的DSM系统虽然提供了图形化界面，但其本质仍是基于Linux的权限体系。

最容易出错的三个环节：

1. SSH服务未正确启用
   在控制面板 > 终端机和SNMP中，不仅要勾选"启用SSH服务"，还需注意：

   • 默认端口22可能被运营商屏蔽，建议改为50000-65535之间的高端口
   • 勾选"允许root用户登录"（临时性措施，后期可关闭）

2. 用户权限配置不完整
   在Git Server套件界面勾选用户只是第一步，还需要：

   # 检查用户是否被添加到正确的用户组
   sudo vim /etc/group
   # 确认包含类似内容：
   # users:x:100:user1,user2,gitadmin
   

3. 家目录权限问题
   新建用户时如果未勾选"创建家目录"，会导致git-shell无法正常工作：

   # 补救措施
   sudo mkdir -p /var/services/homes/username
   sudo chown username