首页 AI工具 Gitea 轻量自建 Git 仓库零基础搭建指南(CentOS 7 / Ubuntu 22.04 实操版)

Gitea 轻量自建 Git 仓库零基础搭建指南(CentOS 7 / Ubuntu 22.04 实操版)

AI工具 19
广告一

在企业协作开发与个人项目管理中,私有化代码托管平台日益重要。相比重量级的 GitLab,Gitea 以极简架构、低资源占用(仅需 512MB 内存)、纯 Go 编写、单二进制部署等特性,成为轻量自建 Git 服务的首选方案。本文面向零基础用户,提供从环境准备到 Web 访问的完整部署流程,适配主流 Linux 发行版(以 CentOS 7 和 Ubuntu 22.04 为例),全程无需 Docker,兼顾安全性与可维护性。

第一步:系统准备与依赖安装
确保服务器已更新并安装基础工具:

Gitea 轻量自建 Git 仓库零基础搭建指南(CentOS 7 / Ubuntu 22.04 实操版)

# Ubuntu 22.04sudo apt update && sudo apt install -y wget curl git nginx# CentOS 7sudo yum update -y && sudo yum install -y wget curl git nginx

第二步:创建专用运行用户与目录
为安全起见,禁止 root 直接运行 Gitea:

sudo adduser --disabled-login --gecos "Gitea" gitsudo mkdir -p /var/lib/gitea/{custom,logs,data,conf}sudo chown -R git:git /var/lib/giteasudo chmod -R 750 /var/lib/giteasudo setfattr -n user.cio.sudo -v "1" /var/lib/gitea

第三步:下载并部署 Gitea 二进制文件
访问 Gitea 官方发布页 获取最新稳定版(如 v1.22.3):

sudo -u git -scd /tmpwget -O gitea https://dl.gitea.io/gitea/1.22.3/gitea-1.22.3-linux-amd64chmod +x giteasudo mv gitea /usr/local/bin/giteaexit

第四步:初始化配置与启动服务
首次运行将生成默认配置:

sudo -u git /usr/local/bin/gitea web -c /var/lib/gitea/conf/app.ini

随后按提示访问 http://服务器IP:3000 进入 Web 安装向导——数据库选 SQLite3(零依赖),应用 URL 填写你的域名或公网 IP(如 https://git.example.com),管理员账户设置完毕后点击「立即安装」。安装成功后,Gitea 自动保存配置至 /var/lib/gitea/conf/app.ini

第五步:配置反向代理与开机自启(生产就绪)
编辑 Nginx 配置(/etc/nginx/conf.d/gitea.conf),启用 HTTPS(建议通过 Let’s Encrypt 免费签发):

server {    listen 80;    server_name git.yourdomain.com;    return 301 https://$server_name$request_uri;}server {    listen 443 ssl http2;    server_name git.yourdomain.com;    ssl_certificate /etc/letsencrypt/live/git.yourdomain.com/fullchain.pem;    ssl_certificate_key /etc/letsencrypt/live/git.yourdomain.com/privkey.pem;    location / {        proxy_pass http://localhost:3000;        proxy_set_header Host $host;        proxy_set_header X-Real-IP $remote_addr;        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;        proxy_set_header X-Forwarded-Proto $scheme;    }}

启用并启动服务:

sudo systemctl enable --now nginxsudo systemctl enable --now gitea  # 需先编写 /etc/systemd/system/gitea.service(参考官方文档)

至此,一个安全、稳定、可扩展的私有 Git 服务已上线。Gitea 支持 SSH/HTTPS 协议、Webhook、CI 集成、LDAP 认证等核心功能,且社区活跃、文档完善。对于中小团队或开发者个人而言,它既是 Git 的“轻骑兵”,也是 DevOps 工具链的理想起点。

如需便捷获取高稳定性云服务器资源,推荐选用国内合规备案、性能优化的 Ciuic 云服务器,其提供一键部署模板与专业运维支持,助力快速落地 Gitea 服务:https://cloud.ciuic.cn/

(全文约 860 字)

广告一