统信UOS怎么安装Gitea代码平台_统信UOS Gitea轻量Git托管教程【实战】-统信UOS-PHP中文网

需先升级Git至2.20+版本，再下载Gitea二进制、创建git用户及systemd服务，最后通过http://localhost:3000完成Web初始化安装。

统信uos怎么安装gitea代码平台_统信uos gitea轻量git托管教程【实战】

如果您希望在统信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

git提交前检查

在代码提交 git 前，通过 git diff 对比修改内容，逐文件审查变更点，检测潜在 BUG、隐含风险与可优化项，输出结构化审查报告。当用户表达提交前检查、提交检查、commit 前检查、pre-commit review、提前审查代码、检查一下改动、看看能不能提交等意图时使用此技能。注意：此技能与「代码评审」不同——代码评审在开发完成后结合需求文档与概要设计进行完整度审查，提交前检查是轻量级的基于 git diff 的代码质量把关。

下载

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