Gitea自建代码托管平台：从Docker部署到安全优化

2026/8/9 11:33:27 拓冰建站浏览量

1. 为什么需要自建代码托管环境？

在软件开发领域，版本控制系统是团队协作和个人项目管理的基石。虽然市面上有GitHub、GitLab等成熟的托管平台，但自建环境对于开发者而言有着独特的价值：

数据主权：所有代码完全掌握在自己手中，不用担心第三方平台的隐私政策变更
定制自由：可以根据团队需求自由选择功能模块和插件
离线可用：内网环境下依然可以正常使用所有功能
成本可控：长期使用比商业方案更经济，特别适合中小团队

我在过去三年为不同规模的团队部署过十余套自托管方案，发现2-10人的小型团队采用Gitea这类轻量方案最为合适。下面就以Gitea为例，分享完整的搭建过程。

2. 环境准备与基础配置

2.1 服务器选择与初始化

推荐使用1核2G配置以上的云服务器（实测阿里云ECS t6系列或腾讯云S5系列均可流畅运行）。操作系统选择Ubuntu 22.04 LTS，这是目前最稳定的长期支持版本。

# 基础环境更新 sudo apt update && sudo apt upgrade -y # 安装必要工具 sudo apt install -y curl wget git vim

注意：生产环境务必配置SSH密钥登录并禁用密码认证，具体可参考：
# /etc/ssh/sshd_config 修改后重启服务 PasswordAuthentication no PermitRootLogin no

2.2 Docker环境部署

Gitea官方推荐使用Docker部署，这能有效解决依赖冲突问题。以下是经过优化的安装脚本：

# 安装Docker CE curl -fsSL https://get.docker.com | sh # 配置镜像加速（国内环境必需） sudo mkdir -p /etc/docker sudo tee /etc/docker/daemon.json <<-'EOF' { "registry-mirrors": ["https://registry.cn-hangzhou.aliyuncs.com"] } EOF # 启动服务 sudo systemctl enable docker sudo systemctl start docker

验证安装：

docker --version # 应输出类似：Docker version 24.0.5, build 24.0.5-0ubuntu1~22.04.1

3. Gitea容器化部署实战

3.1 数据库准备

虽然Gitea支持SQLite，但生产环境建议使用MySQL/PostgreSQL。这里以MySQL为例：

docker run -d \ --name=gitea-db \ -e MYSQL_ROOT_PASSWORD=your_strong_password \ -e MYSQL_DATABASE=gitea \ -e MYSQL_USER=gitea \ -e MYSQL_PASSWORD=gitea_pass \ -v /data/mysql:/var/lib/mysql \ mysql:8.0 \ --character-set-server=utf8mb4 \ --collation-server=utf8mb4_unicode_ci

3.2 Gitea主服务部署

创建docker-compose.yml文件：

version: "3" services: server: image: gitea/gitea:1.21 container_name: gitea environment: - USER_UID=1000 - USER_GID=1000 - DB_TYPE=mysql - DB_HOST=gitea-db:3306 - DB_NAME=gitea - DB_USER=gitea - DB_PASSWD=gitea_pass volumes: - /data/gitea:/data - /etc/timezone:/etc/timezone:ro - /etc/localtime:/etc/localtime:ro ports: - "3000:3000" - "2222:22" depends_on: - db restart: unless-stopped db: image: mysql:8.0 container_name: gitea-db environment: - MYSQL_ROOT_PASSWORD=your_strong_password - MYSQL_DATABASE=gitea - MYSQL_USER=gitea - MYSQL_PASSWORD=gitea_pass volumes: - /data/mysql:/var/lib/mysql command: --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci restart: unless-stopped

启动服务：

docker-compose up -d

4. 初始化配置与优化

访问 http://your-server-ip:3000 完成初始设置：

数据库配置：
- 主机填写db:3306
- 用户名/密码与docker-compose中一致
管理员账户：
- 务必设置强密码
- 建议用户名不要用admin等常见名称
服务配置：
- 域名：如果有备案域名建议填写
- SSH端口：改为2222（避免与系统SSH冲突）
- 关闭开放注册（除非需要公开服务）

5. 高级功能配置

5.1 邮件通知设置

在/data/gitea/gitea/conf/app.ini中添加：

[mailer] ENABLED = true HOST = smtp.your-provider.com:587 FROM = git@your-domain.com USER = your-account@your-domain.com PASSWD = your-password

警告：配置修改后需要重启容器生效
docker-compose restart

5.2 备份策略

创建备份脚本/usr/local/bin/backup-gitea.sh：

#!/bin/bash BACKUP_DIR=/backups/gitea mkdir -p $BACKUP_DIR docker exec -i gitea-db mysqldump -u gitea -pgitea_pass gitea > $BACKUP_DIR/gitea-db-$(date +%Y%m%d).sql tar czvf $BACKUP_DIR/gitea-data-$(date +%Y%m%d).tar.gz -C /data/gitea . find $BACKUP_DIR -type f -mtime +30 -delete

添加到cron：

0 3 * * * /usr/local/bin/backup-gitea.sh

6. 安全加固指南

6.1 防火墙配置

sudo ufw allow 22/tcp sudo ufw allow 3000/tcp sudo ufw allow 2222/tcp sudo ufw enable

6.2 定期更新

# 每周自动更新 docker-compose pull docker-compose up -d

6.3 漏洞防护

关注Gitea的安全公告频道，及时处理如CVE-2026-58053等权限提升漏洞。

7. 常见问题排查

问题1：Docker启动失败提示"virtualization support not detected"

解决方案：

# 检查虚拟化支持 grep -E --color 'vmx|svm' /proc/cpuinfo # 若无输出需要在BIOS中开启VT-x/AMD-V

问题2：上传大文件失败

修改配置：

[server] MAX_FILE_SIZE = 100

问题3：SSH克隆缓慢

检查容器日志：

docker logs gitea

8. 扩展功能集成

8.1 CI/CD集成

通过Gitea Actions实现自动化构建：

安装act_runner：

docker exec -it gitea gitea actions generate-secret > runner_token.txt

部署runner：

# docker-compose.yml新增 services: runner: image: gitea/act_runner:nightly volumes: - /var/run/docker.sock:/var/run/docker.sock environment: - GITEA_INSTANCE_URL=http://gitea:3000 - GITEA_RUNNER_REGISTRATION_TOKEN=your_token depends_on: - server

8.2 代码质量检查

集成SonarQube：

# .gitea/workflows/sonar.yaml name: SonarQube on: [push] jobs: sonar: runs-on: ubuntu-latest steps: - uses: actions/checkout@v3 - name: SonarQube Scan uses: sonarsource/sonarqube-scan-action@master env: SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }} SONAR_HOST_URL: ${{ secrets.SONAR_HOST_URL }}

这套环境已经为我的5人团队稳定运行两年，日均处理50+次代码提交。相比使用SaaS平台，每年节省约$2000的订阅费用，同时获得了更好的定制化体验。对于技术团队而言，掌握这套部署技能不仅能提升工程能力，也是构建自主可控研发体系的重要一步。

建站实战干货