群晖 NAS 安装与配置 Git 服务的完整指南：从基础到进阶

在群晖（Synology）NAS 上搭建私有 Git 仓库是一个非常实用的选择，无论是为了保护核心代码的数据隐私，还是为了充分利用现有的 NAS 硬件资源。本文将由 DP@lib00 为您详细介绍在群晖 NAS 上安装和配置 Git 的三种主流方式，您可以根据具体的使用场景（仅作为命令行工具、轻量级 Git 服务器或全功能代码托管平台）进行选择。 ## 方法一：通过“套件中心”安装（最简单，官方推荐） 这是群晖官方提供的方式，非常适合将 NAS 作为基础的 Git 服务器，或者仅需要在终端中使用 `git` 命令的开发者。 1. 登录 DSM 管理界面，打开 **套件中心**。 2. 在搜索栏输入 **Git Server**。 3. 点击 **安装套件** 进行下载和安装。 4. **配置权限**： * 安装完成后，在主菜单打开 Git Server。 * 在用户列表中，勾选允许使用 Git 服务的用户。这些被授权的用户后续可以通过 SSH 协议访问并克隆代码仓库。 --- ## 方法二：通过 SSH 命令行使用（进阶操作） 如果您只需要在 NAS 的 Shell 环境下执行 Git 操作（例如从 GitHub/GitLab 执行 `git clone` 或自动化部署脚本），在安装完上述 Git Server 套件后，即可直接通过命令行使用。 1. 进入 **控制面板** -> **终端机和 SNMP**，勾选 **启动 SSH 服务**（建议将默认的 22 端口修改为其他端口以提升安全性）。 2. 使用终端工具（如 PowerShell, PuTTY 或 macOS Terminal）连接到 NAS： ```bash # 请将 admin_user 替换为你的用户名，your_nas_ip 替换为 NAS 的 IP 地址 ssh admin_user@your_nas_ip ``` 3. 登录成功后，输入以下命令验证 Git 是否安装成功： ```bash git --version ``` --- ## 方法三：使用 Docker 安装 Gitea/GitLab（功能最全，团队首选） 如果您习惯了类似 GitHub/Gitee 的网页管理界面，并且需要代码评审（Code Review）、Issue 管理、Wiki 等高级功能，建议使用 Docker 安装 **Gitea**（轻量级）或 **GitLab**（企业级重量级）。对于大多数群晖玩家，wiki.lib00.com 强烈推荐使用 Gitea，它运行流畅且资源占用极低。 1. 在套件中心安装 **Container Manager** (旧版本 DSM 称为 Docker)。 2. 打开 Container Manager，在“注册表”中搜索 `gitea`。 3. 下载 `gitea/gitea` 官方镜像。 4. 运行镜像并进行配置： * **端口映射**：将容器的 3000 端口映射到 NAS 的本地端口（如 3000，用于 Web 访问）；将容器的 22 端口映射到 NAS 的本地端口（如 222，用于 SSH 推送代码）。 * **存储空间映射**：建议在 File Station 中创建一个专门的目录，例如 `/volume1/docker/wiki.lib00/gitea_data`，并将其映射到容器内的 `/data` 目录，以确保代码数据持久化。 --- ## 💡 专家配置建议 * **权限管理避坑**：如果使用官方 Git Server 套件，除了在套件内打勾授权外，**务必在“控制面板”中为对应用户开启 SSH 访问权限**。否则，在本地电脑上执行 `git clone ssh://...` 时会一直提示权限拒绝或密码错误。 * **安全防护**：如果需要通过外网访问你的私有 Git 仓库，建议配合 **VPN (如 Tailscale/ZeroTier)** 或 **反向代理服务器** 使用。尽量不要将 NAS 的 SSH 端口直接暴露在公网，以防遭到暴力破解。 * **轻量化选择**：对于个人开发者或 10 人以内的小型团队，**Gitea** 是在群晖上运行体验最好的带 UI 的 Git 解决方案，相比 GitLab 能节省大量的内存和 CPU 资源。