基于Docker和Gitea自建Git仓库镜像服务实践

基于Docker和Gitea自建Git仓库镜像服务实践

在日常开发中，团队往往需要同时维护多个代码托管平台的仓库（如GitHub、GitLab、Gitee）。为便于统一管理和加速内部访问，搭建一个私有的Git镜像服务是一种高效解决方案。本文介绍如何使用Docker快速部署Gitea，并利用其镜像功能将外部仓库同步到内部服务器，实现代码的本地备份与快速拉取。

📌免责声明
本文所述镜像功能仅限个人学习或团队内部使用，用于提升开发效率。镜像内容请遵守原仓库的开源协议及GitHub等服务条款，不得公开分发或用于商业用途。

1. 准备工作

• 云服务器：2核4GB以上配置，Ubuntu 22.04（推荐）。
• 域名：如git.example.com，用于HTTPS访问。
• 开放端口：80、443（Web）、22（SSH，可选）。

2. 安装Docker与Docker Compose

# 安装Docker（Ubuntu）sudoaptupdate&&sudoaptinstall-yapt-transport-https ca-certificatescurlsoftware-properties-commoncurl-fsSLhttps://download.docker.com/linux/ubuntu/gpg|sudogpg--dearmor-o/usr/share/keyrings/docker-archive-keyring.gpgecho"deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu$(lsb_release-cs)stable"|sudotee/etc/apt/sources.list.d/docker.list>/dev/nullsudoaptupdate&&sudoaptinstall-ydocker-ce docker-ce-cli containerd.io# 安装Docker Composesudocurl-L"https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname-s)-$(uname-m)"-o/usr/local/bin/docker-composesudochmod+x /usr/local/bin/docker-compose

3. 使用Docker Compose部署Gitea

创建项目目录并编写docker-compose.yml：

version:"3"networks:gitea:external:falseservices:server:image:gitea/gitea:latestcontainer_name:giteaenvironment:-USER_UID=1000-USER_GID=1000-GITEA__database__DB_TYPE=sqlite3-GITEA__server__DOMAIN=git.example.com# 改为你的域名-GITEA__server__HTTP_PORT=3000-GITEA__server__ROOT_URL=https://git.example.com-GITEA__server__SSH_DOMAIN=git.example.com-GITEA__server__SSH_PORT=22-GITEA__cron__mirror__ENABLED=true-GITEA__cron__mirror__SCHEDULE=@every 6h# 每6小时同步restart:alwaysnetworks:-giteavolumes:-./data:/data-/etc/timezone:/etc/timezone:ro-/etc/localtime:/etc/localtime:roports:-"3000:3000"-"22:22"# 若宿主机22被占用，可改为其他如2222:22

启动服务：

docker-composeup-d

4. 完成Gitea初始配置

访问http://服务器IP:3000进入安装页面。

• 数据库保持SQLite3。
• 应用设置中填写域名、应用URL（https://git.example.com），SSH端口与实际映射一致。
• 注册第一个用户（自动成为管理员）。

5. 配置Nginx反向代理与SSL

安装Nginx并配置站点：

server { listen 80; server_name git.example.com; return 301 https://$server_name$request_uri; } server { listen 443 ssl http2; server_name git.example.com; ssl_certificate /etc/letsencrypt/live/git.example.com/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/git.example.com/privkey.pem; location / { proxy_pass http://127.0.0.1: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; } }

使用Certbot申请SSL证书：

sudoaptinstall-ycertbot python3-certbot-nginxsudocertbot--nginx-dgit.example.com

6. 镜像远程仓库（以GitHub为例）

Gitea支持从任何Git平台迁移仓库并保持镜像同步。

6.1 手动添加镜像

1. 登录Gitea，点击“+”→“新迁移”。
2. 迁移类型：选择GitHub（或其他平台）。
3. 仓库URL：输入要镜像的地址，如https://github.com/user/repo。
4. 镜像：勾选“该仓库是镜像”，设置同步间隔。
5. 点击“迁移仓库”开始克隆。

首次迁移会完整拉取所有分支和标签，之后按设定的cron计划自动同步。

6.2 批量添加（使用API）

获取访问令牌（用户设置→应用），执行脚本：

GITEA_URL="https://git.example.com"TOKEN="你的令牌"USERNAME="你的用户名"REPOS=("https://github.com/user/repo1""https://github.com/user/repo2")forrepoin"${REPOS[@]}";docurl-XPOST"$GITEA_URL/api/v1/repos/migrate"\-H"Authorization: token$TOKEN"\-H"Content-Type: application/json"\-d'{ "clone_addr": "'"$repo"'","repo_name":"'"$(basename$repo)"'","mirror":true,"private":true,"service":"github"}'done

7. 使用镜像站进行代码操作

团队内可通过HTTPS或SSH克隆、推送代码：

gitclone https://git.example.com/用户名/repo.git# 或gitclone git@git.example.com:用户名/repo.git

推送代码时，可同时推送到镜像站和原上游（需分别设置remote）。

8. 维护与合规建议

• 磁盘管理：定期检查仓库大小，清理不再需要的镜像。
• 定期更新：docker-compose pull && docker-compose up -d升级Gitea。
• 权限控制：建议将镜像仓库设为私有，仅授权成员访问。
• 法律合规：
  • 镜像仅用于内部开发加速，不得公开。
  • 确保镜像内容符合原仓库许可证要求。
  • 遵守各代码托管平台的服务条款。

9. 常见问题

• 同步失败：检查服务器是否能访问外网，查看Gitea日志：docker-compose logs server。
• SSL证书续期：Certbot会自动续期，也可手动运行sudo certbot renew。
• SSH连接问题：确认端口映射正确，并在Gitea配置中更新SSH端口。

通过以上步骤，您已成功搭建一个私有的Git镜像服务。它不仅能提升团队内部代码拉取速度，还能作为多平台仓库的统一备份，同时完全符合技术社区的规范要求。如果在实践中遇到问题，欢迎留言交流。