Windows Docker下Gitea保姆级安装教程：用MySQL 5.7做数据库，一次搞定

Windows Docker环境下Gitea与MySQL 5.7的黄金组合部署指南在当今软件开发领域版本控制系统的重要性不言而喻。对于个人开发者或小型团队而言搭建一个轻量级、高性能的自托管Git服务不仅能提高工作效率还能确保代码资产的安全可控。本文将详细介绍如何在Windows Docker环境中部署Gitea这一优秀的自托管Git服务并采用MySQL 5.7作为其后端数据库打造一个稳定可靠的代码托管平台。1. 环境准备与基础配置在开始部署之前我们需要确保系统满足基本要求。Windows 10或11专业版/企业版/教育版64位是运行Docker的理想选择建议版本1903或更高。同时至少需要4GB内存和20GB可用磁盘空间以保证服务流畅运行。首先安装Docker Desktop for Windows从Docker官网下载最新稳定版安装包运行安装程序勾选使用WSL 2后端选项安装完成后重启系统启动Docker Desktop在设置中确保已启用WSL集成提示如果系统不支持WSL 2也可使用Hyper-V后端但性能可能略逊一筹验证Docker安装是否成功docker --version docker-compose --version这两个命令应分别返回Docker和Docker Compose的版本信息。2. MySQL 5.7容器部署作为Gitea的后端存储MySQL 5.7提供了良好的性能和稳定性平衡。我们将使用Docker volume来持久化数据库确保数据安全。创建专用数据卷docker volume create gitea_mysql_data启动MySQL 5.7容器docker run -d \ --name gitea_mysql \ -p 3306:3306 \ -e MYSQL_ROOT_PASSWORDyour_secure_password \ -e MYSQL_USERgitea \ -e MYSQL_PASSWORDgitea_password \ -e MYSQL_DATABASEgitea \ -v gitea_mysql_data:/var/lib/mysql \ --restart unless-stopped \ mysql:5.7 \ --character-set-serverutf8mb4 \ --collation-serverutf8mb4_unicode_ci关键参数说明参数说明推荐值MYSQL_ROOT_PASSWORDroot用户密码设置强密码MYSQL_USERGitea专用用户名giteaMYSQL_PASSWORD用户密码与root不同character-set-server字符集utf8mb4collation-server排序规则utf8mb4_unicode_ci验证MySQL容器运行状态docker ps -f namegitea_mysql3. Gitea容器部署与配置Gitea作为轻量级Git服务其Docker部署非常简便。我们将使用官方镜像并配置与MySQL的连接。创建Gitea数据卷docker volume create gitea_data启动Gitea容器docker run -d \ --name gitea \ -p 3000:3000 \ -p 2222:22 \ -v gitea_data:/data \ --link gitea_mysql:db \ -e DB_TYPEmysql \ -e DB_HOSTdb:3306 \ -e DB_NAMEgitea \ -e DB_USERgitea \ -e DB_PASSWDgitea_password \ -e USER_UID1000 \ -e USER_GID1000 \ --restart unless-stopped \ gitea/gitea:latest端口映射说明3000: Gitea的Web界面2222: SSH服务端口避免与系统SSH冲突环境变量关键配置数据库配置DB_TYPE: 数据库类型mysqlDB_HOST: 数据库地址通过--link连接的别名DB_NAME: 数据库名DB_USER: 数据库用户DB_PASSWD: 数据库密码系统配置USER_UID: 运行用户UID与宿主机用户匹配USER_GID: 运行用户GID4. 初始设置与优化容器启动后通过浏览器访问http://localhost:3000进入Gitea的初始设置页面。首次安装需要进行以下配置数据库设置确保数据库类型为MySQL主机填写db:3306容器链接别名用户名和密码与MySQL容器启动时设置的一致常规设置站点标题自定义您的Gitea实例名称仓库根目录保持默认/data/git/repositoriesLFS根目录/data/git/lfs运行用户git管理员账户务必设置一个强密码的管理员账户建议用户名不要使用admin等常见名称服务配置禁用注册或设置注册限制根据需求配置邮件服务可选但推荐完成初始化后建议进行以下优化性能调优[server] PROTOCOL http DOMAIN localhost HTTP_PORT 3000 ROOT_URL http://localhost:3000/ DISABLE_SSH false SSH_PORT 22 SSH_DOMAIN localhost START_SSH_SERVER true OFFLINE_MODE false仓库设置[repository] ROOT /data/git/repositories SCRIPT_TYPE bash DEFAULT_PRIVATE false DEFAULT_PUSH_CREATE_PRIVATE true MAX_CREATION_LIMIT -15. 日常维护与备份策略为确保Gitea服务稳定运行需要建立定期维护机制。数据库备份docker exec gitea_mysql sh -c exec mysqldump --all-databases -uroot -p$MYSQL_ROOT_PASSWORD gitea_backup_$(date %Y%m%d).sqlGitea数据备份停止Gitea容器docker stop gitea备份数据卷docker run --rm -v gitea_data:/data -v $(pwd):/backup alpine tar czf /backup/gitea_data_$(date %Y%m%d).tar.gz -C /data .启动Gitea容器docker start gitea自动备份脚本示例#!/bin/bash # MySQL备份 docker exec gitea_mysql sh -c exec mysqldump -uroot -p$MYSQL_ROOT_PASSWORD gitea /backups/gitea_db_$(date %Y%m%d).sql # 数据备份 docker run --rm --volumes-from gitea -v /backups:/backup alpine tar czf /backup/gitea_data_$(date %Y%m%d).tar.gz -C /data . # 清理旧备份 find /backups -type f -name *.sql -mtime 7 -exec rm {} \; find /backups -type f -name *.tar.gz -mtime 7 -exec rm {} \;6. 常见问题排查容器启动失败检查端口冲突netstat -ano | findstr 3000查看容器日志docker logs gitea数据库连接问题验证MySQL容器是否运行docker ps测试MySQL连接docker exec -it gitea_mysql mysql -ugitea -p检查Gitea数据库配置/data/gitea/conf/app.ini文件权限问题确保数据卷正确挂载docker inspect gitea调整文件权限docker exec gitea chown -R git:git /data性能优化建议对于大型仓库增加MySQL的缓冲池大小考虑使用SSD存储数据卷定期执行git gc优化仓库在实际使用中我发现将Gitea的数据卷挂载到WSL2子系统中可以获得更好的I/O性能。通过\\wsl$\docker-desktop-data路径可以直接访问数据卷内容便于直接管理和备份。