飞牛 OS 部署 Gitea 私有代码仓库指南

飞牛 OS 部署 Gitea 私有代码仓库指南

在飞牛 OS（Feiniu OS）六盘位固态 NAS 环境下，搭建 Gitea 私有代码仓库是提升团队协作效率的不错选择。经测试，内网访问稳定，外网推送因服务器中转可能存在延迟或异常，建议优先在内网环境使用。

安装与基础配置

进入 Web 管理界面并登录账号后，在应用中心搜索并安装 Gitea。安装过程中选择存储位置，确认后即可开始初始化。

安装完成后，点击'打开'进入配置页面。主要需关注以下三项设置：

1. 数据库类型：初期建议使用内置数据库，若网络通畅且数据量大，可后续迁移至 MySQL。
2. 站点名称：自定义便于识别的名称。
3. SSH 服务端口：务必设置为 1024 以上，避免与系统保留端口冲突。

关于邮箱通知，若无需接收邮件提醒可不填发件人信息，但管理员账户和密码必须设置，也可根据需求开启外部注册功能。

配置完成弹出成功界面即表示服务已启动。

SSH 端口监听问题排查

服务启动后，建议先通过终端检查进程状态及端口监听情况。若未开启终端，可在应用中心查找相关工具。

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

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

通常进程会显示存在，但端口监听可能为空。这是默认配置所致，无需惊慌，按以下步骤修复：

1. 停止当前服务：

   sudo pkill -9 gitea
   

2. 编辑配置文件：

   sudo nano /vol1/@appdata/Gitea/conf.ini
   

3. 找到 START_SSH_SERVER 项，确保其值为 true。若不存在则手动添加：
   保存退出（Ctrl+X，输入 Y，回车）。