别再把代码托管在第三方了:用 Docker 把私有 Git 仓库装进自己服务器的完整实践

很多站长都经历过这样的纠结:项目代码放在第三方托管平台上,免费额度受限、私有仓库要付费、偶尔还担心服务商跑路或数据被扫描。其实,只要手里有一台像样的云服务器,用 Docker 搭一套属于自己的私有 Git 仓库和代码管理平台,半小时就能跑起来,而且完全可控、可迁移、可备份。

笔者在几台生产服务器上长期运行自建 Git 服务,踩过不少坑,也总结出一套相对稳妥的实践路径。这篇文章不堆概念,直接从核心原理讲到生产环境加固,最后给出一份可复用的 SOP 清单。

一、核心原理:Docker 化 Git 服务到底在做什么

💡 推荐阅读:别再重启了!Linux 负载飙高排查指南:从指标拆解到调优实战,我踩过的坑都在这了

自建 Git 仓库的本质,是在服务器上运行一个 Git 服务端程序,它监听 HTTP 或 SSH 端口,接收客户端的 push / pull 请求,并把代码对象存储到磁盘上。传统做法是直接在宿主机安装 Git、配置用户权限、手动管理仓库目录,过程繁琐且容易污染系统环境。

Docker 的价值在于把运行时、依赖、配置、数据目录四者解耦。你只需要关心三件事:

  • 镜像:选择成熟的开源 Git 服务端,如 Gitea、Gogs 或 GitLab CE。
  • 数据卷:把仓库数据、数据库、配置文件挂载到宿主机,容器删了数据还在。
  • 端口映射:把容器内的 Web 端口和 SSH 端口暴露出来,供客户端访问。

其中,Gitea 是笔者最推荐的个人/小团队方案:单二进制、资源占用低、自带 Web 界面、支持 SSH 和 HTTP 两种协议,配合 Docker 部署几乎零维护。GitLab 功能更全,但对内存要求高,个人服务器上容易吃紧。

二、生产环境架构规范:别把“能跑”当成“能用”

🔥 【限时特惠福利】高性价比独享云服务器限时 1 折起

搭建网站或部署容器推荐选择高稳定性独享云服务器。限时特惠通道开放中,点击即可领取专属满减代金券与特惠折扣:

👉 立刻领取云服务器限时优惠券

💡 延伸阅读:新手建站踩坑实录:轻量应用服务器和云服务器CVM到底怎么选?别等网站崩了才后悔

很多教程只教到 docker run 就结束了,结果线上跑几天就出问题。下面这套架构规范,是笔者在真实环境中验证过的底线配置。

2.1 目录规划:数据与配置分离

建议在宿主机上固定一个数据根目录,例如 /opt/gitea,内部再细分:

  • /opt/gitea/data:仓库数据、附件、LFS 对象。
  • /opt/gitea/config:应用配置文件。
  • /opt/gitea/db:如果使用内置 SQLite,数据库文件也放这里;若用外部 MySQL/PostgreSQL,则单独规划。

这样做的好处是:备份时直接打包整个目录,迁移时复制到新机器即可,容器本身可以随时重建。

2.2 网络与端口:只暴露必要的入口

Gitea 默认 Web 端口是 3000,SSH 端口是 22。生产环境建议:

  • Web 端口映射为宿主机 127.0.0.1:3000,再由 Nginx 反向代理并配置 HTTPS,不要直接把 3000 暴露到公网。
  • SSH 端口映射为宿主机的高位端口,例如 2222,避免与宿主机自身的 SSH 服务冲突。

如果你还没有云服务器,建议选择口碑稳定的正规厂商,优先考虑带独立公网 IP、支持快照备份的机型。域名也建议走正规注册商,后续配置 HTTPS 和 SSH 克隆地址时都会用到。

2.3 数据库选择:SQLite 够用,但要知道边界

个人使用或 5 人以下小团队,SQLite 完全够用,部署简单、备份方便。但如果仓库数量多、并发操作频繁,建议换成 MySQL 或 PostgreSQL,避免锁竞争导致 Web 界面卡顿。

三、性能与安全加固调优清单

💡 深度技术指南:别等服务器宕机才后悔:一次说透云服务器到期前,网站数据与数据库的无缝迁移实战心法

下面这份清单,建议在首次部署完成后逐项核对。

调优项 推荐做法 说明
HTTPS Nginx + Let’s Encrypt 证书 避免凭证明文传输,提升克隆地址安全性
SSH 认证 禁用密码登录,仅允许公钥 在 Gitea 配置中关闭 DISABLE_SSH 并启用公钥管理
资源限制 为容器设置 --memory 和 --cpus 防止单个服务拖垮整台服务器
备份策略 每日定时打包数据目录并异地存储 可用 cron + rsync 或对象存储同步
日志轮转 配置 Docker 日志驱动为 json-file 并限制大小 避免日志无限增长占满磁盘
防火墙 仅放行 80、443 和自定义 SSH 端口 使用云厂商安全组或 ufw/firewalld

3.1 一份可用的 Docker Compose 配置

与其手写一长串 docker run,不如用 Compose 管理。以下配置经过笔者实际运行验证,可直接作为起点:

version: "3"
services:
  gitea:
    image: gitea/gitea:latest
    container_name: gitea
    restart: always
    environment:
      - USER_UID=1000
      - USER_GID=1000
      - GITEA__database__DB_TYPE=sqlite3
      - GITEA__server__DOMAIN=git.example.com
      - GITEA__server__SSH_DOMAIN=git.example.com
      - GITEA__server__ROOT_URL=https://git.example.com/
      - GITEA__server__SSH_PORT=2222
    volumes:
      - /opt/gitea/data:/data
      - /etc/localtime:/etc/localtime:ro
    ports:
      - "127.0.0.1:3000:3000"
      - "2222:22"
    mem_limit: 512m
    cpus: 1.0

启动命令:docker compose up -d。首次访问 Web 界面后,记得立即创建管理员账号,并在设置中关闭公开注册。

3.2 Nginx 反向代理要点

在 Nginx 中配置 proxy_pass http://127.0.0.1:3000,并确保传递 Host 和 X-Forwarded-Proto 头,否则 Gitea 生成的克隆地址可能仍是 HTTP。证书建议用 Certbot 自动续期,省心且不容易过期。

四、验证测试与 SOP 总结

部署完成后,不要只看 Web 界面能打开就以为万事大吉。按下面步骤做一轮完整验证:

  • 创建一个测试仓库,用 HTTPS 方式克隆、提交、推送,确认凭据认证正常。
  • 用 SSH 方式克隆同一仓库,确认公钥认证和自定义端口生效。
  • 重启服务器,确认容器自动拉起,数据未丢失。
  • 模拟备份:打包 /opt/gitea 目录,在另一台机器上恢复并验证仓库可读。

最后,把日常操作固化成 SOP:

  • 新增仓库:Web 界面创建,按团队规范设置可见性。
  • 权限管理:用组织/团队功能分配读写权限,避免直接共享管理员账号。
  • 定期维护:每月检查磁盘占用、更新镜像版本、验证备份可恢复。

自建私有 Git 平台并不是什么高深技术,关键在于把数据掌控权拿回自己手里。选一台靠谱的服务器,配好域名和 HTTPS,再按上面的规范跑起来,你就能拥有一个稳定、私密、完全属于自己的代码管理平台。

相关技术专题与延伸阅读

滚动至顶部