飞牛 NAS 部署 Gitea 私有代码托管指南

二、关键问题排查：SSH 服务未启动

安装完成后，部分版本默认未开启 SSH 监听，导致无法通过 Git 命令拉取代码。请按以下步骤检查并修复。

1. 状态检查

打开终端（若未预装，请在应用中心搜索终端工具），执行以下命令确认服务状态：

# 检查 Gitea 进程是否在运行
ps aux | grep gitea | grep -v grep

# 检查 2022 端口是否被监听
sudo netstat -tlnp | grep :2022

通常进程会显示运行中，但端口监听可能为空。此时不要惊慌，我们需要手动启用 SSH 服务。

2. 修改配置文件

停止当前服务，编辑配置文件：

# 强制停止 Gitea 进程
sudo pkill -9 gitea

# 打开配置文件
sudo nano /vol1/@appdata/Gitea/conf.ini

在文件中添加或修改以下行，确保 SSH 服务被显式开启：

START_SSH_SERVER = true

保存退出（Nano 编辑器按 Ctrl+X，输入 Y 回车）。

3. 重启验证

切换目录并以 Gitea 用户身份重新启动服务：

# 切换到 Gitea 工作目录
cd /vol1/@appcenter/Gitea

# 以 gitea 用户身份启动
sudo -u gitea ./bin/gitea web --config /vol1/@appdata/Gitea/conf.ini &

再次执行端口检查命令，若能看到 :2022 处于 LISTEN 状态，则说明配置成功。

三、连通性测试

在 Windows 命令行中测试内网连通性（请将 IP 替换为实际地址）：

Test-NetConnection 192.168.1.x -Port 2022

返回 TcpTestSucceeded : True 即表示 SSH 端口可达。

四、仓库创建与密钥配置

1. 创建仓库 登录 Web 界面，点击右上角新建仓库，填写基本信息后即可创建。

2. 添加 SSH 公钥 进入个人设置 -> SSH/GPG 密钥，复制本地的公钥内容粘贴进去。

3. 本地配置 在工程目录下配置远程地址，即可正常推送到私有仓库。