需先升级Git至2.20+版本，再下载Gitea二进制、创建git用户及systemd服务，最后通过http://localhost:3000完成Web初始化安装。
如果您希望在统信UOS系统上部署轻量级自托管Git代码平台Gitea，但尚未完成安装或服务启动失败，则可能是由于Git版本不兼容、依赖缺失、权限配置错误或服务未正确注册所致。以下是解决此问题的步骤：
一、确认并安装满足要求的Git版本
Gitea明确要求Git 2.0以上版本，UOS默认源中部分旧版D系列可能仅提供Git 1.8.x，将导致Gitea初始化失败或Web界面报错“Git version too old”。需优先验证并升级Git至2.20+版本。
1、打开终端，执行命令检查当前Git版本：git --version
2、若输出版本低于2.20（如1.8.3），且系统为D系列UOS（如专业版20/23），执行以下命令更新APT源并安装新版Git：sudo apt update && sudo apt install git
3、若apt仍无法安装高版本Git，手动添加Debian backports源（适用于D系列）：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
4、验证升级结果：git --version 应返回类似 git version 2.39.2 的输出。
二、下载并部署Gitea二进制文件
Gitea官方提供跨架构Linux二进制包，无需编译，适用于x86_64及ARM64（如鲲鹏、飞腾）平台。部署路径需具备可执行权限与写入能力，推荐使用非root用户（如git）隔离运行环境。
1、创建专用运行目录并切换用户：sudo mkdir -p /usr/local/gitea && sudo chown -R $USER:$USER /usr/local/gitea
2、下载最新稳定版Gitea（以v1.22.2为例）：wget -O /usr/local/gitea/gitea https://dl.gitea.io/gitea/1.22.2/gitea-1.22.2-linux-amd64
3、赋予可执行权限：chmod +x /usr/local/gitea/gitea
4、验证二进制完整性：/usr/local/gitea/gitea --version 应输出Gitea版本信息。
三、创建系统服务并启用后台运行
将Gitea注册为systemd服务可实现开机自启、日志管理与进程守护。服务配置需指定运行用户、工作目录及配置文件路径，避免以root身份直接运行造成安全风险。
1、创建Gitea专用系统用户：sudo adduser --disabled-login --gecos "Gitea" --home /home/git git
2、设置目录归属：sudo chown -R git:git /usr/local/gitea
Notion Sites
Notion 推出的AI网站构建工具，允许用户将 Notion 页面直接发布为完整网站。
3、新建systemd服务文件：sudo nano /etc/systemd/system/gitea.service
4、写入以下内容（注意替换WorkingDirectory和ExecStart路径）：[Unit]\nDescription=Gitea\nAfter=network.target\n[Service]\nType=simple\nUser=git\nGroup=git\nWorkingDirectory=/usr/local/gitea\nExecStart=/usr/local/gitea/gitea web -c /usr/local/gitea/custom/conf/app.ini\nRestart=always\nRestartSec=3\nEnvironment=HOME=/home/git GITEA_WORK_DIR=/usr/local/gitea\n[Install]\nWantedBy=multi-user.target
5、重载服务配置并启用：sudo systemctl daemon-reload && sudo systemctl enable gitea && sudo systemctl start gitea
四、初始化Gitea Web安装向导
Gitea首次启动时会自动进入Web安装流程，需通过浏览器访问其监听地址完成数据库配置、管理员账户创建等关键步骤。默认端口为3000，需确保防火墙放行且无其他服务占用该端口。
1、检查服务状态：sudo systemctl status gitea 确认状态为active (running)。
2、查看监听端口：sudo ss -tuln | grep :3000 应显示gitea进程绑定127.0.0.1:3000或0.0.0.0:3000。
3、在UOS自带浏览器中访问：http://localhost:3000
4、在安装页面中选择数据库类型（推荐SQLite3，免额外安装）、设置域名（填http://localhost:3000）、填写管理员用户名与密码，点击立即安装按钮。
五、配置反向代理与HTTPS（可选）
若需通过标准HTTP/HTTPS端口（80/443）访问Gitea，或集成至企业内网统一入口，应配置Nginx反向代理。此步骤可绕过端口暴露限制，并支持SSL证书绑定。
1、安装Nginx：sudo apt install nginx
2、编辑站点配置：sudo nano /etc/nginx/sites-available/gitea
3、填入反向代理规则（含Header透传）：server {\n listen 80;\n server_name your-domain.com;\n location / {\n proxy_pass http://127.0.0.1:3000;\n proxy_set_header Host $host;\n proxy_set_header X-Real-IP $remote_addr;\n proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n proxy_set_header X-Forwarded-Proto $scheme;\n }\n}
4、启用配置并重启Nginx：sudo ln -sf /etc/nginx/sites-available/gitea /etc/nginx/sites-enabled/ && sudo systemctl restart nginx
