从0到1:基于 Linux 搭建自托管 Gitea 代码托管平台(实战指南)

一、前言

在日常开发中，很多团队希望拥有一个 私有的 Git 仓库，用于存储、管理和协作代码。

Gitea 是一个轻量、开源、易部署的 Git 代码托管平台，非常适合中小型团队和个人自建使用。

本篇文章将带你在 Linux 系统上，快速搭建一套自托管的 Gitea 服务平台。

二、环境准备

• Linux 服务器一台（推荐 Ubuntu 20.04+/CentOS 7+）
• Docker 与 Docker Compose 已安装

安装 Docker（如果未安装）：

curl -fsSL https://get.docker.com | bash -s docker

安装 Docker Compose：

sudo curl -L "https://github.com/docker/compose/releases/download/2.24.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

sudo chmod +x /usr/local/bin/docker-compose

三、目录结构规划

创建 Gitea 工作目录：

mkdir -p ~/gitea/{gitea,db}

cd ~/gitea

• gitea/：存放 Gitea 的数据与配置
• db/：存放数据库的数据

四、编写 Docker Compose 配置

在 ~/gitea 目录下，新建 docker-compose.yml 文件：

version: '3'

services:

server:

image: gitea/gitea:latest

container_name: gitea

environment:

- USER_UID=1000

- USER_GID=1000

restart: always

networks:

- gitea

volumes:

- ./gitea:/data

ports:

- "3000:3000"

- "222:22"

db:

image: mariadb:10

container_name: gitea-db

restart: always

environment:

- MYSQL_ROOT_PASSWORD=gitea_root_pass

- MYSQL_DATABASE=gitea

- MYSQL_USER=gitea

- MYSQL_PASSWORD=gitea_pass

networks:

- gitea

volumes:

- ./db:/var/lib/mysql

networks:

gitea:

driver: bridge

五、启动 Gitea 服务

在 ~/gitea 目录下执行：

docker-compose up -d

启动成功后，查看容器运行状态：

docker ps

六、访问 Gitea 平台

浏览器访问你的服务器 IP：

http://服务器IP:3000

首次进入 Gitea 安装引导界面：

1. 数据库设置：
2. 
   
3. 类型：MySQL
4. 主机：db:3306
5. 用户名：gitea
6. 密码：gitea_pass
7. 数据库名：gitea
8. 
   
9. 应用设置：
10. 
    
11. 站点标题、自定义配置根据实际需求填写。
12. SSH 端口：222
13. HTTP 端口：3000
14. 
    
15. 点击【安装 Gitea】完成部署。

七、基础使用

• 创建组织与仓库
• 设置项目权限（公开/私有）
• 配置 WebHook、自动部署
• 用户注册与团队协作管理

Gitea 提供了丰富的 API 和插件支持，非常适合二次开发与集成。

八、备份与恢复

定期备份 Gitea 的数据与数据库：

# 备份 Gitea 配置和仓库

cp -r ~/gitea/gitea ~/gitea_backup/

# 备份数据库

docker exec gitea-db sh -c 'exec mysqldump --all-databases -uroot -pgitea_root_pass' > ~/gitea_backup/gitea_db_backup.sql

恢复时，只需拷贝回原路径并还原数据库即可。

九、安全加固建议

• 开启 HTTPS（可以搭配 Nginx + Let’s Encrypt）
• 修改默认 SSH/HTTP 端口
• 限制访问 IP，开启防火墙策略
• 定期更新 Gitea 和系统软件

十、总结

通过本文，你已经成功搭建了一套完整的 Gitea 私有 Git 托管平台，未来可以用于：

• 公司内部项目管理
• 开源项目托管
• CI/CD 自动化集成

搭建属于自己的 Git 平台，从0到1，就是这么简单且高效！