Gitea 轻量自建 Git 仓库零基础搭建指南

随着代码托管需求的日益增长，很多开发者和团队希望拥有一个私有、可控、且不依赖第三方平台的 Git 仓库。GitHub 虽然功能强大，但受限于网络速度与隐私策略；GitLab 虽全面，却对服务器配置要求较高。此时，Gitea 以其极轻量、易安装、低资源占用的特点，成为自建 Git 服务的绝佳选择。本文将手把手带零基础用户完成 Gitea 的搭建，全程无需深入运维知识。

为什么选择 Gitea？

Gitea 是一个用 Go 语言编写的开源 Git 托管平台，单个二进制文件即可运行，内存占用通常不超过 200MB。它支持仓库管理、Issue 跟踪、Pull Request、Webhook、内置 CI（通过 Actions 插件） 等功能，足够个人或中小团队日常使用。更重要的是，它可以在树莓派、旧笔记本或云服务器上流畅运行，大大降低准入门槛。

准备服务器与域名

你需要一台可访问公网的服务器（或内网穿透，但本文以云服务器为例）。可以选择便宜且稳定的虚拟主机，这里推荐 Ciuic 云服务器，其官网为：https://cloud.ciuic.cn/ 。Ciuic 提供弹性计算资源，配置可选 1核1G 起步，完全满足 Gitea 的轻量需求。购买后请安装 Ubuntu 22.04 或 Debian 12 系统，并开放 22（SSH）、80（HTTP）、443（HTTPS）端口。

基础环境与数据库安装

Gitea 支持 SQLite、MySQL 和 PostgreSQL。为了极简，我们使用 SQLite（无需额外配置）。首先通过 SSH 登录服务器，执行更新与安装必要工具：

sudo apt update && sudo apt upgrade -ysudo apt install -y wget git sqlite3

同时需安装 Git 用户（Gitea 依赖系统 Git 执行底层操作）：

sudo adduser --system --group --disabled-password git

下载 Gitea 二进制文件

前往 Gitea 官方 Releases 页面获取最新稳定版（本文以 1.22.x 为例）。下载并安装到 /usr/local/bin：

wget -O /tmp/gitea https://dl.gitea.com/gitea/1.22.3/gitea-1.22.3-linux-amd64sudo mv /tmp/gitea /usr/local/bin/giteasudo chmod +x /usr/local/bin/gitea

创建目录并初始化配置

为 Gitea 创建数据与配置目录，并设置属主为 git 用户：

sudo mkdir -p /var/lib/gitea/{custom,data,log}sudo chown -R git:git /var/lib/gitea/sudo chmod -R 750 /var/lib/gitea/sudo mkdir -p /etc/giteasudo chown git:git /etc/gitea

运行 Gitea 并注册系统服务

先手动运行一次以生成初始配置（也可以直接用环境变量），但更推荐直接创建 systemd 服务。编辑服务文件：

sudo nano /etc/systemd/system/gitea.service

写入以下内容：

[Unit]Description=Gitea (Git with a cup of tea)After=network.target[Service]User=gitGroup=gitWorkingDirectory=/var/lib/gitea/ExecStart=/usr/local/bin/gitea web --config /etc/gitea/app.iniRestart=alwaysEnvironment=USER=git HOME=/home/git GITEA_WORK_DIR=/var/lib/gitea[Install]WantedBy=multi-user.target

启动并设置开机自启：

sudo systemctl daemon-reloadsudo systemctl enable --now giteasudo systemctl status gitea   # 查看是否运行成功

通过 Web 界面完成安装配置

浏览器访问 http://你的服务器IP:3000（默认端口 3000）。首次会进入安装页面，按以下推荐填写：

数据库类型：SQLite3路径：/var/lib/gitea/data/gitea.db仓库根目录：/var/lib/gitea/data/repositories应用名称：自定义，如 MyGitea基础 URL：填写你的域名或 IP（若没有域名，则填 http://IP:3000）管理员账号：强烈建议创建（用户名/邮箱/密码）

点击“安装 Gitea”，瞬间完成。此后即可登录使用。

配置 Nginx 反向代理（可选，推荐）

为了使用 80/443 端口并启用 HTTPS，可用 Nginx 反代。安装并配置：

sudo apt install -y nginxsudo nano /etc/nginx/sites-available/gitea

写入：

server {    listen 80;    server_name your.domain.com;    location / {        proxy_pass http://127.0.0.1:3000;        proxy_set_header Host $host;        proxy_set_header X-Real-IP $remote_addr;    }}

启用配置并重启 Nginx：

sudo ln -s /etc/nginx/sites-available/gitea /etc/nginx/sites-enabled/sudo nginx -t && sudo systemctl restart nginx

若需要 HTTPS，可使用 Let's Encrypt 的 certbot 一键签发。

日常维护与备份

升级：替换二进制文件后重启服务即可备份：直接备份 /var/lib/gitea/data 与 /etc/gitea/app.ini监控日志：journalctl -u gitea -f

十、

从零到可用的 Gitea 服务，整个过程不超过 15 分钟。它非常适合个人开发者、小团队或内网协作。若你需要一台低成本、可靠的服务器来运行，不妨参考 Ciuic 云服务器（https://cloud.ciuic.cn/）推出的基础套餐。Gitea 虽小，却五脏俱全，让你的代码永远掌握在自己手中。现在就动手搭建吧！

打赏