树莓派运行系统sshd时Gitea内置SSH服务无法启动问题咨询

问题原因 #

Gitea 内置 SSH 服务完全可以和系统自带 sshd 服务独立共存，二者监听不同端口不会出现冲突。你遇到的问题是配置项缺失导致内置SSH服务没有被启动。

你使用的1.15.5版本属于Gitea的旧版本，默认配置下DISABLE_SSH = false仅代表不关闭SSH功能，但不会主动启动内置SSH服务，需要额外添加启动参数。

修复步骤 #

• 编辑Gitea配置文件app.ini，在[server]配置段新增如下参数：

START_SSH_SERVER = true

添加后的[server]段示例如下：

[server]
SSH_DOMAIN       = myaddress.com
DOMAIN           = myaddress.com
HTTP_PORT        = 3000
ROOT_URL         = https://myaddress.com/
DISABLE_SSH      = false
SSH_PORT         = 2222
START_SSH_SERVER = true

• 重启Gitea服务，若你使用systemd管理服务，执行命令：
  sudo systemctl restart gitea
• 验证端口监听状态，执行命令：
  sudo lsof -i -P -n | grep LISTEN
  此时可以看到gitea进程已经监听2222端口，再执行SSH测试命令ssh -p 2222 git@myaddress.com即可正常返回Gitea的SSH欢迎信息。

异常排查 #

如果重启后依然无法监听2222端口，可查看Gitea运行日志排查具体报错，常见异常原因包括：

• 2222端口被其他进程占用
• 运行Gitea的git用户没有权限绑定对应端口
• 配置文件路径错误，修改的配置没有被Gitea加载

内容的提问来源于stack exchange，提问作者Heppi