5分钟极速搭建Gitea私有Git服务Docker Compose与PostgreSQL黄金组合还在用网盘同步代码或是把项目文件夹压缩后通过聊天软件传来传去作为经历过这些原始管理方式的开发者我完全理解手动合并冲突时的崩溃感——上周刚花了两小时解决同事上传的覆盖文件结果发现关键功能被意外回滚。直到用Docker Compose部署了Gitea整个团队才真正体会到版本控制的魅力。下面分享的这个方案不仅能让你告别代码管理乱象还能获得企业级私有Git服务体验。1. 为什么选择这个技术组合Docker ComposeGiteaPostgreSQL这个铁三角组合在轻量级私有Git服务领域几乎无出其右。去年为初创团队部署时做过对比测试同样配置的2核4GB云服务器GitLab需要近2分钟启动且内存占用超1.5GB而Gitea只需8秒即可提供服务空闲内存占用仅120MB左右。1.1 Gitea的四大杀手锏轻如鸿毛单个二进制文件就能运行不需要像GitLab那样消耗大量资源功能完备支持PR审查、Issue跟踪、Webhook等核心功能扩展自由Go语言开发二次开发门槛低我们团队就基于API开发了自动代码检查工具社区活跃2023年发布的1.18版本新增了CI/CD流水线支持1.2 PostgreSQL的稳定性保障虽然Gitea支持SQLite快速上手但实际生产环境更推荐PostgreSQL事务完整性更好避免仓库操作中出现部分成功的问题支持更复杂的权限管理模型备份恢复方案更成熟特别是配合pg_dump工具提示如果只是个人临时使用SQLite确实更方便。但团队协作场景下PostgreSQL能减少很多后期迁移的麻烦。2. 五分钟部署实战2.1 环境准备清单确保你的系统已经安装Docker 20.10Docker Compose 2.0至少1GB可用内存10GB磁盘空间建议SSD# 验证环境 docker --version docker compose version2.2 编写docker-compose.yml创建项目目录并新建配置文件version: 3.8 services: gitea: image: gitea/gitea:1.21-rootless container_name: gitea restart: unless-stopped environment: - GITEA__database__DB_TYPEpostgresql - GITEA__database__HOSTdb:5432 - GITEA__database__NAMEgitea - GITEA__database__USERgitea - GITEA__database__PASSWDgitea123! volumes: - ./data:/var/lib/gitea - ./config:/etc/gitea - /etc/timezone:/etc/timezone:ro ports: - 7080:3000 - 2222:22 depends_on: - db db: image: postgres:14-alpine environment: - POSTGRES_USERgitea - POSTGRES_PASSWORDgitea123! - POSTGRES_DBgitea volumes: - ./postgres-data:/var/lib/postgresql/data关键参数说明参数作用推荐值rootless镜像提升安全性必选2222:22映射SSH克隆端口可改为其他高位端口unless-stopped异常退出自动重启比always更智能2.3 一键启动服务mkdir -p {data,config,postgres-data} chmod -R 777 data docker compose up -d观察日志确认启动成功docker compose logs -f gitea | grep -i listening当看到Listening on http://0.0.0.0:3000时浏览器访问http://服务器IP:7080即可进入安装向导。3. 初始化配置技巧3.1 Web安装向导注意事项数据库连接配置主机填写dbDocker服务名端口保持5432账户密码与compose文件一致关键站点设置SSH服务域名 你的服务器公网IP Gitea基础URL http://你的域名:7080管理员账户建议使用专用邮箱非个人邮箱密码强度至少包含大小写字母数字3.2 必改的安全配置修改config/app.ini[server] PROTOCOL http DOMAIN your-domain.com HTTP_PORT 3000 ROOT_URL http://your-domain.com:7080/ DISABLE_SSH false SSH_PORT 22 START_SSH_SERVER true重要如果暴露在公网务必配置Nginx反代并启用HTTPS4. 高效使用指南4.1 团队协作最佳实践仓库权限模型私有仓库默认关闭推送权限开发者通过PR提交变更核心成员拥有合并权限分支策略示例main - 生产环境代码保护分支 release/* - 预发布分支 feature/* - 功能开发分支 hotfix/* - 紧急修复分支4.2 自动化集成方案通过Webhook实现代码推送触发在仓库设置中添加Webhook配置Payload URL如Jenkins地址选择触发事件Push/Pull Request等示例Jenkinsfile片段pipeline { agent any triggers { bitbucketPush() } stages { stage(Build) { steps { sh mvn clean package } } } }5. 性能优化与维护5.1 定期维护任务数据库备份docker exec -t gitea-db pg_dump -U gitea gitea backup_$(date %Y%m%d).sql仓库清理docker exec -it gitea bash -c gitea admin repo --resync-all5.2 监控指标配置Prometheus监控示例配置- job_name: gitea metrics_path: /metrics static_configs: - targets: [gitea:3000]关键监控项内存使用量应500MB仓库操作延迟P99 1s数据库连接数峰值20实际使用中发现当仓库数量超过500个时建议增加PostgreSQL的shared_buffers参数到512MB以上。我们团队运行半年后添加了Redis缓存API响应速度提升了40%。