事情背景

自己在群晖主机上使用Docker搭建了一个gitea的服务，已经使用多年了。主要是用来托管一些自己的代码，或者是和朋友们协同开发搞点事情。但是由于网络拓扑相对较为复杂，git的ssh鉴权功能一直没有解决。

这多年了，一直是用https协议来拉取和推送代码，虽然也能记录账号和密码不需要每次登录，又不是不能用；但是，这终究是没有ssh更好用（更有逼格），这也让人如鲠在喉想起来就不爽。

前段时间正好升级了nas主机，借此机会来研究一番，尝试把gitea的ssh能力搞定他。

开搞第一步：创建本地git账户

首先去查阅了gitea的官方指导文档。其中“安装——使用Docker安装——ssh容器直通”条目中有详细的记录，很值的参考。

文档要求第一步先在主机上创建一个名为git的账户，对于我这等多年熬成打的菜鸟，这还不是和开关机一样简单的事情吗？

一战被挫：

• 打开群晖"控制面板 – 用户与群组" 创建 git 用户。
• 下一步。
• what fuck！居然报错： "出于安全原因禁止创建"。

账号名2不让取 git就很蛋疼啊，比如创建一个fuck用户，然后你的ssh链接就会变成这样：

##克隆仓库时 SSH 正常协议地址
git@xxxx.com:<username>/<repository name>.git

##如果是 fuck 的话，就成了:
fuck@xxxx.com:<username>/<repository name>.git

你看，这样是不是很别扭？起码逼格少了一半啊。这怎么能忍。

再战再挫：

UI界面不让搞，是不是命令行可以绕过去呢？毕竟群晖也就是个Linux，ssh登录走起：打开群晖ssh端口，然后ssh登录上去试试，不就是个adduser嘛：

What fuck x2！群晖居然没有 useradd 和 adduser命令!!!我感觉整个人都不好了。。。

三战功成：

好吧，李敖大师说过，搞研究的人要有“上穷碧落下黄泉，动手动脚找东西”的精神，那我们也来发扬一下。

终于，在群晖官网的 CLI Administrator Guide 里提到了一个命令 synouser，按照文档中的说明，我执行了下面的命令，成功了创建了 git 用户。

synouser --add git "passwd" "" 0 "" 0

因为 git 用户要将 SSH 连接转发到容器，所以还要去控制面板把 git 添加到 administrators 群组，否则没有权限。至此拦路虎搞定！

开搞第二步：修改docker-compose.yaml文件重新部署gitea服务

第一个小问题：按文档需要给容器设置uid和gid，文档中默认的都是1000；

environment:

- USER_UID=1000

- USER_GID=1000

我们需要在群晖上通过ssh登录查看下git账号的uid和gid

nas@nas:~ id git

## 输出类似这样
uid=1029(git) gid=100(git) groups=100(git),101(users)

来查询出git账号的uid和gid，把yaml文件修改成正确的uid和gid。

然后第二个问题：

文档中提示需要将主机的 /home/git/.ssh 装入容器。否则，SSH 身份验证将无法在容器内运行。

volumes:

- /home/git/.ssh/:/data/git/.ssh

实际上在群晖上是找不到对应的目录的，群晖自己对Linux目录结构做了很大改动。

群晖的git用户home目录是在/var/services/homes/git；所以对应修改yaml文件：

volumes:

- /var/services/homes/git/.ssh/:/data/git/.ssh

剩下的就不说了，完全安装gitea官方文档抄作业就好了。

搞定，Happy3分钟！

至此，拦路多年的大石头终于搬掉了，可以愉快的使用`git@[servername]:[user]/[demo].git`的形式来拉取代码了。