gitea是适配麒麟os的轻量自托管git平台，支持预编译包部署、systemd服务、docker容器、软件商店/apt安装及nginx反向代理https五种方式。
如果您希望在麒麟操作系统（Kylin OS）上部署一个轻量、自托管的 Git 代码平台，Gitea 是一个高度适配国产化环境的开源选择。以下是针对麒麟OS（基于 Ubuntu/Debian 或 openEuler 的主流版本）安装 Gitea 的多种可行方法：
一、使用预编译二进制包手动部署
该方式不依赖系统包管理器，兼容性强，适用于所有麒麟OS发行版（包括银河麒麟V10、开放麒麟等），且能精确控制 Gitea 版本与运行权限。
1、访问 https://dl.gitea.io/gitea 查找最新稳定版链接（例如 v1.22.2），使用 wget 下载对应 Linux AMD64 架构的二进制文件。
2、执行 sudo mkdir -p /opt/gitea /var/lib/gitea /etc/gitea 创建标准目录结构。
3、将下载的二进制文件移至 /opt/gitea/gitea 并赋予可执行权限：sudo chmod +x /opt/gitea/gitea。
4、创建专用运行用户：sudo useradd --system --shell /bin/bash --create-home --home-dir /var/lib/gitea git。
5、以 git 用户初始化配置：sudo -u git /opt/gitea/gitea web -c /etc/gitea/app.ini，首次运行将生成默认配置并提示访问 http://localhost:3000 完成向导。
二、通过 systemd 服务实现后台持久化运行
手动启动的 Gitea 进程在终端关闭后会终止，需配置 systemd 服务确保其作为守护进程持续运行，并支持开机自启。
1、创建服务文件：sudo nano /etc/systemd/system/gitea.service，填入标准 Unit、Service 和 Install 段落，指定 User=git、WorkingDirectory=/var/lib/gitea、ExecStart=/opt/gitea/gitea web -c /etc/gitea/app.ini。
2、重载服务配置：sudo systemctl daemon-reload。
3、启用并启动服务：sudo systemctl enable --now gitea。
4、检查状态：sudo systemctl status gitea，确认显示 active (running) 且无报错。
三、使用 Docker 容器方式部署（适用于已安装 Docker 的麒麟OS）
该方式隔离性好、环境一致性强，尤其适合测试或与现有容器生态集成的场景；需确保麒麟OS内核支持 overlay2 存储驱动且已启用 cgroupv2 兼容模式。
1、拉取官方镜像：sudo docker pull gitea/gitea:latest。
2、创建持久化数据目录：sudo mkdir -p /opt/gitea/data /opt/gitea/conf /opt/gitea/logs。
3、运行容器并绑定端口与卷：sudo docker run -d --name=gitea -p 3000:3000 -p 222:22 -v /opt/gitea/data:/var/lib/gitea -v /opt/gitea/conf:/etc/gitea -v /opt/gitea/logs:/var/log/gitea --restart=always gitea/gitea:latest。
4、验证容器运行：sudo docker ps | grep gitea，确认 STATUS 为 Up 且 PORTS 显示 0.0.0.0:3000->3000/tcp。
四、通过麒麟软件商店或 apt 安装（仅限 Kylin V10 SP1+ 基于 Debian 的版本）
部分麒麟OS定制源中已收录 Gitea 包，适合追求极简安装流程的用户，但版本可能滞后于上游发布，不推荐生产环境直接采用。
1、更新软件源列表：sudo apt update。
2、搜索可用包：apt search gitea，确认返回结果含 gitea/stable 标识。
3、安装主程序：sudo apt install gitea -y。
4、启动并启用服务：sudo systemctl enable --now gitea；若失败，检查日志：journalctl -u gitea -n 50 -f。
五、配置反向代理与 HTTPS（Nginx 方式）
为保障生产环境安全性与域名访问体验，需将 Gitea 默认的 3000 端口通过 Nginx 反向代理至 80/443，并启用 TLS 加密通信。
1、安装 Nginx：sudo apt install nginx -y（Debian系）或 sudo dnf install nginx -y（openEuler系）。
2、禁用默认站点：sudo rm /etc/nginx/sites-enabled/default。
3、新建站点配置：sudo nano /etc/nginx/conf.d/gitea.conf，写入 server 块，包含 listen 80、server_name your-domain.com、location / { proxy_pass http://127.0.0.1:3000; } 等关键指令。
4、申请并部署 SSL 证书：sudo apt install certbot python3-certbot-nginx -y，再执行 sudo certbot --nginx -d your-domain.com 自动配置 HTTPS。
