别再手动配环境了！用Docker Compose在Windows上5分钟搞定Gitea+MySQL8私有Git服务
5分钟在Windows上搭建企业级私有Git仓库：Docker Compose+Gitea全栈指南
你是否经历过这样的场景？为了搭建一个团队内部使用的Git仓库，不得不先安装MySQL、配置Go环境、调整系统变量，最后还要解决各种依赖冲突。现在，这一切都可以像安装普通软件一样简单——利用Docker Compose，我们能在Windows系统上5分钟内完成Gitea+MySQL8的全套服务部署，而且完全不影响现有系统环境。
1. 为什么选择容器化部署方案
传统安装方式需要分别部署Gitea服务、MySQL数据库以及相关依赖，不仅步骤繁琐，还容易产生环境污染。我曾在一个新项目启动时，因为团队成员各自的环境配置差异，花了整整两天解决兼容性问题。而容器化方案将所有组件隔离在独立环境中，就像把整个服务栈打包成一个"应用程序包"。
三种部署方式对比：
| 方案 | 安装复杂度 | 隔离性 | 迁移成本 | 适合场景 |
|---|---|---|---|---|
| 传统源码安装 | 高 | 无 | 高 | 需要深度定制 |
| 单体Docker容器 | 中 | 部分 | 中 | 快速体验 |
| Docker Compose编排 | 低 | 完整 | 低 | 生产级团队使用 |
提示：即使未来需要迁移服务器，只需拷贝docker-compose.yml和挂载卷，所有配置和数据都能完整保留
Gitea作为轻量级Git服务，其Docker镜像仅有200MB左右，启动时资源占用极低。在我的开发笔记本（16GB内存）上测试，完整运行Gitea+MySQL8仅占用约800MB内存，这对个人开发者或小团队来说非常友好。
2. 十分钟极速部署实战
2.1 环境准备清单
开始前请确保：
- Windows 10/11 Pro/Enterprise或Windows Server 2016+
- Docker Desktop已安装（需开启WSL2后端）
- 4GB以上可用内存
- 至少5GB磁盘空间（用于镜像和持久化数据）
# 验证Docker环境 docker --version docker-compose --version如果尚未安装Docker Desktop，可从官网获取最新稳定版。安装完成后，建议在设置中调整以下参数：
- 内存分配：至少4GB
- 磁盘镜像位置：选择非系统盘的大容量分区
- 启用WSL2集成
2.2 编写编排文件
在任意位置创建gitea-stack文件夹，新建docker-compose.yml文件：
version: "3.8" services: gitea: image: gitea/gitea:1.18 container_name: gitea environment: - USER_UID=1000 - USER_GID=1000 - DB_TYPE=mysql - DB_HOST=db - DB_NAME=gitea - DB_USER=gitea - DB_PASSWD=gitea volumes: - ./gitea/data:/data - ./gitea/etc/timezone:/etc/timezone:ro - ./gitea/etc/localtime:/etc/localtime:ro ports: - "3000:3000" - "222:22" depends_on: - db networks: - gitea_net db: image: mysql:8 container_name: gitea_db environment: - MYSQL_ROOT_PASSWORD=gitea - MYSQL_USER=gitea - MYSQL_PASSWORD=gitea - MYSQL_DATABASE=gitea volumes: - ./mysql/data:/var/lib/mysql - ./mysql/conf:/etc/mysql/conf.d ports: - "3306:3306" networks: - gitea_net healthcheck: test: ["CMD", "mysqladmin", "ping", "-h", "localhost"] interval: 5s timeout: 10s retries: 5 networks: gitea_net: driver: bridge关键配置解析：
- volumes映射：将容器内数据持久化到主机，避免容器重建时丢失
- network隔离：创建专属网络保证服务间安全通信
- healthcheck：确保MySQL完全启动后再初始化Gitea
- 端口规划：
- 3000：Web访问端口
- 222：SSH克隆专用端口（避免与系统SSH冲突）
2.3 一键启动服务
在项目目录打开PowerShell执行：
# 启动完整服务栈 docker-compose up -d # 观察启动日志 docker-compose logs -f首次运行会自动拉取所需镜像（约1GB下载量）。启动完成后，访问http://localhost:3000即可进入安装向导。
3. 生产级配置优化
3.1 初始化设置最佳实践
在安装页面需要特别注意以下配置项：
数据库连接：
- 主机：
db:3306（使用Docker内部DNS） - 用户名/密码：与compose文件保持一致
站点配置：
- 站点标题： 团队名称+Gitea（如"Acme代码仓库"） - 基础URL： 如果是公网访问需填写完整域名 - SSH服务端口： 222（需与compose文件映射一致） - 禁止用户注册： 生产环境建议先关闭管理员账户： 务必在此页面设置管理员账号，避免第一个注册用户自动获得管理员权限的安全风险。
3.2 性能调优参数
对于团队使用场景，建议在gitea/data/gitea/conf/app.ini中添加：
[database] MAX_IDLE_CONNS = 50 CONN_MAX_LIFETIME = 180 [server] PROTOCOL = http DOMAIN = your-domain.com HTTP_PORT = 3000 ROOT_URL = http://your-domain.com:3000通过Docker Compose可以轻松实现配置持久化：
volumes: - ./gitea/conf/app.ini:/data/gitea/conf/app.ini4. 高级运维技巧
4.1 数据备份方案
创建备份脚本backup.ps1：
# 备份数据库 docker exec gitea_db sh -c 'exec mysqldump --all-databases -uroot -p"$MYSQL_ROOT_PASSWORD"' > backup.sql # 备份仓库数据 Compress-Archive -Path .\gitea\data\git\repositories -DestinationPath repos.zip # 备份附件等 Compress-Archive -Path .\gitea\data\attachments -DestinationPath attachments.zip可通过Windows任务计划设置每日自动备份，建议同时备份整个gitea-stack目录。
4.2 版本升级流程
- 停止现有服务：
docker-compose down - 备份整个数据目录
- 修改compose文件中Gitea镜像版本号
- 重新启动：
docker-compose up -d - 访问
http://localhost:3000完成自动迁移
注意：大版本升级前请务必检查Gitea官方升级说明，某些版本可能需要特殊迁移步骤
4.3 HTTPS安全配置
使用Let's Encrypt证书的Nginx反向代理配置示例：
server { listen 443 ssl; server_name git.your-company.com; ssl_certificate /etc/letsencrypt/live/git.your-company.com/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/git.your-company.com/privkey.pem; location / { proxy_pass http://gitea:3000; proxy_set_header Host $host; } }将此服务添加到原有compose文件，即可实现全自动HTTPS化。
在实际使用中，这套方案已经稳定支持我们20人团队的代码管理工作半年多，期间进行过3次无缝升级。最让我满意的是，当需要迁移到新服务器时，只需要拷贝整个目录并在新环境执行docker-compose up -d，所有仓库、用户数据和issue都能完整恢复。