Synology 部署开源 Git 服务平台 Gitea

序言

2020 年的时候， 我写过一篇 Gitea 的部署文章， 当时是 Windows 服务器， 直接运行的二进制文件。

今天打算在群晖 Synology 上部署 Gitea， 因为发现确实没必要暴露到公网， 还是在内网比较好。

安装

下载映像

直接使用群晖的 docker 下载映像。 当前的 Gitea 1.22.6 (2025.01.03) 版本， 直接下载带版本号的映像， 方便检查 Gitea 版本。

等下载完毕， 就可以进行下一步操作了。

设置 Docker 容器

网络

直接选择默认的 bridge 就行

常规设置

修改一下容器名称并勾选启用自动重新启动。

端口设置

映射一下端口， 填写的端口指的是你 NAS 主机的端口， 可以自选。 容器 3000 端口对应的本地端口就是 Gitea 的 WebUI。

存储空间设置

设置到默认的 docker 共享文件夹就行， 如果设置到其他文件夹， 请注意可能存在权限问题， 会导致容器无限重启， 本人实测， 因为设置到其他路径下， 我设置的同步会将数据同时同步到所有硬盘里面， 相当于备份了。

说一句题外话， 因为我没有组 raid 阵列， 所以就重要数据所有的硬盘都存一份。 4 盘同时损毁的概率还是很低的。

我猜测可能使用 1.22.6-rootless 这种带有 rootless 的映像才能在我这种情况下正常工作。 仅仅是猜测， 并没有实际验证。

在最后的摘要里面点击完成就可以了。

设置 Gitea

访问 Gitea 的 WebUI 进行设置。

数据库设置

由于是本人自己使用， 所以选择默认的 SQLite 数据库即可。

一般设置

可以酌情自行修改， 对我来说， 不需要修改。 不过可以勾选启用更新检查， Gitea 有更新了可以通知到我们。

邮箱设置

邮箱我也设置了， 用的是 QQ 邮箱。

发件人和 SMTP 用户名都可以用自己的 QQ 邮箱， SMTP 密码则是 QQ 邮箱的授权码， 不是 QQ 邮箱的密码。

服务器和第三方服务设置

这个地方也不用修改， 不过我为了安全设置， 就勾选了页面访问限制和启用注册验证码

管理员账号设置

最后一步设置一个管理员账号。 按照自己的想法来就行， 后面用这个账号进行登录。

最后点击那个立即安装就 OK 了。

结语

到此 Gitea 安装完毕， 但是我发现在我的 NAS 上 1.22.6 版本发送测试邮件的时候， Gitea 报如下错误：

gomail: could not send email 1: short response: ������

在 Github 的 issues 中找了一下， 删除监控面板中队列里面的 mail 的 worker 也不管用， 算了， 就自己用， 对邮件需求不大， 先这样吧， 应该很快就会恢复。

先到官方那边提个 issue 吧。

如有错误， 敬请指出， 感谢指正！  — 2025-01-03  23:15:21