gitea是为统信uos设计的轻量私有代码托管平台，部署前必须确保git≥2.20，否则web界面报错退出；需验证升级git、下载gitea二进制、创建专用用户及systemd服务，最后通过浏览器访问localhost:3000完成sqlite3初始化配置。
您刚在统信UOS上部署完Git，现在需要一个轻量、可控、可内网运行的私有代码托管平台，Gitea正是为此设计——它不依赖数据库、单二进制文件即可启动，但安装前必须确认Git版本≥2.20，否则Web界面会报“Git version too old”错误并拒绝初始化。
验证并升级Git版本（Gitea硬性前提）
打开终端（Ctrl+Alt+T），执行：
git --version
若输出版本号低于2.20（例如1.8.3或2.19.3），必须升级：
— D系列UOS（个人版2024/专业版23等）：sudo apt update && sudo apt install git
— A系列UOS（服务器版A23等）：sudo dnf makecache && sudo dnf install git
若APT/DNF仍无法提供2.20+版本，D系列用户需手动添加backports源：
echo "deb http://archive.debian.org/debian buster-backports main" | sudo tee -a /etc/apt/sources.list && sudo apt update && sudo apt -t buster-backports install git
【这一步不可跳过，Gitea启动时会主动检测Git版本，失败即退出且无明确错误提示】
再次运行 git --version，确认输出类似 git version 2.39.2 的结果。
下载并部署Gitea二进制文件
方法一：直接下载官方稳定版（推荐）
创建部署目录：sudo mkdir -p /usr/local/gitea && sudo chown -R $USER:$USER /usr/local/gitea
下载v1.22.2（适配x86_64及ARM64鲲鹏/飞腾）：wget -O /usr/local/gitea/gitea https://dl.gitea.io/gitea/1.22.2/gitea-1.22.2-linux-amd64
赋予执行权限：chmod +x /usr/local/gitea/gitea
验证：/usr/local/gitea/gitea --version 应输出 Gitea 1.22.2
方法二：使用curl替代wget（网络受限时）
curl -L https://dl.gitea.io/gitea/1.22.2/gitea-1.22.2-linux-amd64 -o /usr/local/gitea/gitea
创建专用系统用户并配置服务
第一步：新建隔离运行账户
sudo adduser --disabled-login --gecos "Gitea" --home /home/git git
第二步：变更目录归属权
sudo chown -R git:git /usr/local/gitea
第三步：新建systemd服务文件
sudo nano /etc/systemd/system/gitea.service
第四步：粘贴以下内容（注意核对路径）：
[Unit]
Description=Gitea
After=network.target
[Service]
Type=simple
User=git
Group=git
WorkingDirectory=/usr/local/gitea
ExecStart=/usr/local/gitea/gitea web -c /usr/local/gitea/custom/conf/app.ini
Restart=always
RestartSec=3
Environment=HOME=/home/git GITEA_WORK_DIR=/usr/local/gitea
[Install]
WantedBy=multi-user.target
第五步：重载服务并启用
sudo systemctl daemon-reload → sudo systemctl enable gitea → sudo systemctl start gitea
首次访问与初始化配置
在浏览器中访问 http://localhost:3000（或服务器IP:3000）
页面将自动跳转至安装向导，填写以下关键项：
— 数据库类型：SQLite3（默认，无需额外安装）
— 项目根URL：http://localhost:3000（若用域名，请填完整协议+域名）
— 管理员账号：输入您计划使用的管理员用户名、邮箱、密码
— SSH端口：留空或填22（如未修改SSH服务）
【邮箱必须与后续Git全局配置的user.email完全一致，否则仓库SSH推送会失败】
点击“立即安装”，Gitea将自动生成配置文件、初始化数据库并跳转至登录页。
用刚设置的管理员账号登录，进入后台管理 → 管理员面板 → 配置 → 修改“站点名称”“默认语言”等基础信息。
