环境说明与前置准备
本文基于飞牛 NAS（六盘位固态存储）进行演示。在应用中心完成基础环境配置并登录 Web 界面后，即可开始安装。
经测试，内网连接推送功能正常。外网访问目前因服务器中转机制存在延迟，建议等待官方修复后再尝试外网部署，当前以内网使用为主。
一、安装流程
-
进入应用中心 打开飞牛 Web 管理界面，找到应用中心并搜索
Gitea。 -
选择安装位置 点击安装，根据提示选择存储路径。若只有一个数据盘，直接确认即可。
-
基础配置 安装完成后，进入配置页面，主要调整以下三项：
- 数据库类型：默认 SQLite 最简单，适合个人使用；若需更高性能且网络通畅，可后续迁移至 MySQL。
- 站点名称：自定义你的 Git 服务标识。
- SSH 端口：务必设置为 1024 以上。低于 1024 的端口属于系统保留特权端口，普通用户进程无法绑定。
-
账户设置 设置管理员账号密码。若无需邮件通知，发件人邮箱可不填。支持外部注册的用户可在后续开启。
-
启动服务 确认配置后点击确定，服务将自动启动。
二、关键问题排查：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 端口可达。
四、仓库创建与密钥配置
- 创建仓库 登录 Web 界面，点击右上角新建仓库，填写基本信息后即可创建。
- 添加 SSH 公钥 进入个人设置 -> SSH/GPG 密钥，复制本地的公钥内容粘贴进去。
- 本地配置 在工程目录下配置远程地址，即可正常推送到私有仓库。
