Docker 部署 Gitea 容易吗？私有 Git 能快速搭？

lichen360
工作日记
23天前
36热度
0评论

Docker部署Gitea：5步搭建轻量级私有Git服务

在代码托管需求日益增长的今天，Docker+Gitea的组合正在成为开发者搭建私有Git服务的首选方案。相较于动辄消耗2GB内存的GitLab，Gitea仅需256MB内存即可流畅运行，配合Docker的容器化部署能力，30分钟就能完成从零搭建到仓库推送的全流程，真正实现"代码自由"。

一、为什么选择Docker部署Gitea？

1.1 轻量级方案的突围战

通过实际测试对比发现：

资源消耗：Gitea容器内存占用稳定在200到300MB，而GitLab最低需要1.5GB
启动速度：Gitea镜像启动仅需8秒，GitLab需2分钟以上
功能覆盖：Gitea完整支持issues、pull requests、Webhooks等核心功能

1.2 Docker带来的部署革命

通过容器化方案可实现：

环境隔离：避免与宿主机环境冲突
版本控制：随时回滚到指定版本
快速迁移：整套配置可打包移植

二、实战部署四部曲

2.1 环境准备

创建项目目录并获取配置文件：

mkdir -p /opt/docker/gitea
cd /opt/docker/gitea
curl -o docker-compose.yml https://gitea.com/docker-compose.yml

2.2 关键配置解析

修改docker-compose.yml重点参数：

version: "3"
services:
  gitea:
    image: gitea/gitea:1.20
    ports:
      "3000:3000"    Web访问端口
      "2222:22"      SSH克隆端口
    volumes:
      ./data:/data   数据持久化目录
    restart: always

2.3 启动服务

执行部署命令并验证状态：

docker-compose up -d
docker-compose ps

三、SSH配置的三大关键点

3.1 端口映射陷阱

当使用非标准SSH端口时，需在仓库地址显式声明：

git clone ssh://git@yourserver:2222/username/repo.git

3.2 公钥配置规范

公钥文件需命名为authorized_keys
权限必须设置为600
建议通过Gitea Web界面自动配置

3.3 测试连接的正确姿势

ssh -T git@yourserver -p 2222
 成功时会显示Hi there!响应

四、数据迁移与备份策略

4.1 数据目录结构解析

/data/git：所有Git仓库存储位置
/data/gitea：配置文件目录
/data/ssh：SSH密钥存储目录

4.2 备份操作指南

 备份数据库
docker exec gitea-db mysqldump -uroot -p$PASSWORD gitea > gitea.sql

 备份数据目录
tar czvf gitea-data.tar.gz ./data

五、常见问题排雷指南

5.1 容器启动失败排查

查看日志：docker-compose logs gitea
检查端口冲突：netstat -tulnp | grep ':3000'
验证目录权限：chown -R 1000:1000 ./data

5.2 访问异常处理

403错误：检查RUN_MODE是否为prod
SSH连接超时：确认防火墙放行2222端口
仓库推送失败：重置仓库权限配置

通过这套方案，开发者可以在任何支持Docker的环境（包括家庭NAS、云服务器甚至树莓派）快速搭建私有代码仓库。Gitea的活跃社区持续提供安全更新和功能扩展，配合Docker的版本管理能力，使私有Git服务既安全可靠又易于维护。