Gitea完全指南：如何搭建轻量级自建代码仓库

在软件开发过程中，拥有一个安全可控的代码托管平台至关重要。Gitea作为一款轻量级自建Git服务，以其简洁高效的设计和丰富的功能，成为个人开发者和小型团队搭建私有代码仓库的理想选择。本文将从核心价值出发，带你全面了解如何部署和运维Gitea，打造属于自己的代码管理中心。

核心价值解析：为什么选择Gitea自建代码仓库

Gitea之所以在众多代码托管工具中脱颖而出，主要源于其三大核心优势。首先是极致轻量化，整个服务可在1GB内存环境下流畅运行，对硬件资源要求极低，无论是个人开发者的小型服务器还是团队内部的私有部署，都能轻松应对。其次是功能完备性，它集成了代码托管、Issue跟踪、Pull Request、Wiki等开发团队所需的全部功能，无需额外搭建其他工具，实现一站式开发协作。最后是高度可定制，支持多种数据库后端（MySQL、PostgreSQL、SQLite等），可根据实际需求灵活配置，同时提供丰富的插件系统，满足不同场景的个性化需求。

准备阶段：确认你的运行环境

在开始部署Gitea之前，需要确保你的环境满足以下基本要求。硬件方面，建议至少1GB内存和10GB可用磁盘空间，这是保证Gitea稳定运行的基础。操作系统方面，Gitea支持Linux、Windows和macOS等主流系统，其中Linux系统因其稳定性和安全性，是生产环境的首选。

软件依赖方面，你需要提前安装Git（版本2.0以上）和数据库服务。如果选择MySQL作为数据库，建议使用5.7及以上版本；若偏好PostgreSQL，则推荐10.0及以上版本。对于快速测试或个人使用，也可以选择SQLite，它无需额外配置，开箱即用。

[!TIP] 在Linux系统中，可以通过git --version和数据库服务状态命令（如systemctl status mysql）检查依赖是否已正确安装。

多场景部署方案：选择适合你的安装方式

方案一：二进制快速部署

这种方式适合追求简单快捷的用户，无需复杂的环境配置，几步即可完成安装。

「Step 1/3」获取最新版Gitea二进制文件。通过wget命令从官方渠道下载对应系统的版本，以Linux amd64为例：

wget -O gitea https://dl.gitea.com/gitea/1.20.0/gitea-1.20.0-linux-amd64
chmod +x gitea

这一步会将Gitea可执行文件下载到当前目录并赋予执行权限。

「Step 2/3」创建专用运行用户和目录。为了安全起见，建议创建一个非root用户来运行Gitea：

sudo adduser --system --group --disabled-password --home /var/lib/gitea gitea
sudo mkdir -p /etc/gitea /var/lib/gitea
sudo chown -R gitea:gitea /etc/gitea /var/lib/gitea

这里创建了gitea用户和相关目录，并设置了正确的权限。

「Step 3/3」启动Gitea服务。切换到gitea用户，运行以下命令启动服务：

sudo -u gitea ./gitea web -c /etc/gitea/app.ini

启动成功后，通过浏览器访问http://服务器IP:3000即可进入初始化配置界面。

方案二：Docker容器化部署

对于熟悉Docker的用户，容器化部署是更好的选择，它能有效隔离应用环境，简化部署和升级流程。

「Step 1/3」拉取Gitea Docker镜像🐳。执行以下命令获取最新版镜像：

docker pull gitea/gitea:latest

「Step 2/3」创建数据卷目录。为了保证数据持久化，需要创建本地目录并挂载到容器中：

mkdir -p /var/lib/gitea/data

「Step 3/3」启动Docker容器。通过以下命令启动Gitea容器，同时映射必要的端口和数据卷：

docker run -d --name=gitea -p 3000:3000 -p 222:22 -v /var/lib/gitea/data:/data gitea/gitea:latest

这里映射了3000端口（Web访问）和222端口（SSH访问），并将数据目录挂载到本地。

运维指南：确保服务稳定运行

系统服务配置

为了让Gitea能够随系统自动启动并在后台稳定运行，推荐使用systemd进行管理。创建/etc/systemd/system/gitea.service文件，内容如下：

[Unit]
Description=Gitea - A painless self-hosted Git service
After=network.target mysql.service

[Service]
User=gitea
Group=gitea
WorkingDirectory=/var/lib/gitea
ExecStart=/usr/local/bin/gitea web -c /etc/gitea/app.ini
Restart=always
Environment=USER=gitea HOME=/var/lib/gitea

[Install]
WantedBy=multi-user.target

保存后，通过sudo systemctl daemon-reload加载配置，然后使用sudo systemctl start gitea启动服务，sudo systemctl enable gitea设置开机自启。

常见陷阱规避

在使用Gitea的过程中，有几个常见问题需要特别注意。一是权限问题，确保Gitea用户对数据目录和配置文件有正确的读写权限，否则可能导致服务启动失败或数据丢失。二是端口冲突，Gitea默认使用3000端口，如果该端口已被其他服务占用，需要在配置文件中修改HTTP_PORT参数。三是数据库连接，首次配置时要确保数据库信息正确，包括地址、端口、用户名和密码，否则会无法完成初始化。

[!TIP] 若服务启动失败，可通过查看日志文件（通常位于/var/lib/gitea/log目录）排查问题，日志中会详细记录错误原因。

数据备份策略

定期备份数据是保障代码安全的重要措施。Gitea提供了内置的备份命令，可通过以下方式执行：

sudo -u gitea ./gitea dump -c /etc/gitea/app.ini

该命令会生成一个包含数据库和仓库数据的压缩包，建议将备份文件存储在异地或云存储服务中，以防本地数据损坏。同时，可以通过crontab设置定时任务，实现自动备份，例如：

0 2 * * * sudo -u gitea /usr/local/bin/gitea dump -c /etc/gitea/app.ini -o /backup/gitea-$(date +\%Y\%m\%d).zip

这样每天凌晨2点会自动生成一个带有日期的备份文件。

通过以上步骤，你已经掌握了Gitea的部署和基本运维方法。无论是个人使用还是团队协作，Gitea都能为你提供稳定、高效的代码托管服务，让你专注于软件开发本身，而无需担心基础设施的维护问题。随着使用的深入，你还可以探索Gitea的高级功能，如CI/CD集成、LDAP认证等，进一步提升开发效率。