Skip to content

群晖 DS220+ 通过 Container Manager 安装 Gitea

阿里云服务器部署 Gitea 终究不是长久之事,迁移到群晖内更安全。


环境信息

  • Gitea 1.25.3
  • Container Manager 24.0.2-1606
  • 群晖 DS220+ (DSM 7.3.2-86009, 2C10G)

准备工作

创建文件夹

  • 确保已经安装好了 Container Manager 套件,安装好后会自动创建一个 docker 文件夹
  • 在 docker 文件夹内创建一个 gitea 文件夹:用于存储 Gitea 配置和数据
  • 在 docker 文件夹同级创建一个 git 文件夹:用于存储 Gitea 存储库

创建用户组

为 Container Manager 创建一个统一的用户组:docker,仅分配 docker、git 两个文件夹的读写权限。可根据需要对其他文件夹、应用都设置禁止访问。

20260119-01

20260119-02

创建用户

再创建一个 gitea 用户,加入到 docker 用户组。

20260119-03

20260119-04

然后 SSH 登录下群晖,查看下用户组和用户的 ID。

bash
id gitea

记录下 ID。gitea:1028,docker:65537。

bash
uid=1028(gitea) gid=100(users) groups=100(users),65537(docker)

配置镜像仓库

在安装好 Container Manager 套件之后,由于国内无法访问镜像仓库,需要为其设置其他可用存储库。

20260119-05

添加镜像仓库并切换过来。

https://docker.1ms.run

20260119-06

20260119-07

重新打开 Container Manager 就可以看到镜像列表了。

20260119-08

下载镜像

搜索并下载 Gitea 镜像。

20260119-09

20260119-10

创建容器

配置自动重新启动。

20260119-11

配置端口映射,根据你的情况配置即可。

存储空间映射,配置两个:

  • Gitea 配置和数据:/data/gitea
  • Gitea 存储库:/data/git/repositories

环境变量,配置上方创建的用户组合用户 ID:

  • USER_UID
  • USER_GID

20260119-12

确认完成即可。

20260119-13

20260119-14

迁移 Gitea

如果你是新装,直接按要求配置即可,可参考之前文章:Docker 安装 Gitea

我是迁移,而且用的原来的数据库,所以直接恢复下存储库和 gitea 配置即可。

配置主题

正好发现 Gitea GitHub 主题更新了,配置下主题。

下载好对应版本的 base 主题包,在 /data/gitea/public/assets/css 下放好主题文件。

然后在 /data/gitea/conf/app.ini 中修改或新增主题配置,进入页面后切换下主题即可,这次感觉 GitHub 主题细腻多了。

ini
[ui]
THEMES = gitea-auto, gitea-light, gitea-dark, github-auto, github-light, github-dark, github-soft-dark

参考资料

  1. 群晖安装Gitea(代码托管工具):https://zhuanlan.zhihu.com/p/26495576639
  2. Synology搭建Gitea(Docker) :https://www.cnblogs.com/gaoyang3513/p/18854519
  3. 从旧版 Gitea 升级 | Gitea Documentation:https://docs.gitea.com/zh-cn/installation/upgrade-from-gitea
  4. 配置说明 | Gitea Documentation:https://docs.gitea.com/zh-cn/administration/config-cheat-sheet
  5. Gitea GitHub Theme:https://github.com/lutinglt/gitea-github-theme