本文用 Docker 方式在服务器上搭建 GitLab 社区版（GitLab CE）私有代码仓库——代码完全自持，适合团队内部协作与 CI/CD。

配置建议

• 已安装 Docker，参见部署Docker环境。
• 内存 4GB 起（GitLab 较吃内存，2GB 会频繁卡顿）；磁盘预留 20GB 以上。
• 需要放行端口：80 / 443（网页）、2222（SSH 拉取代码）。

启动 GitLab 容器

mkdir -p /data/gitlab

docker run -d \
  --hostname gitlab.example.com \
  -p 80:80 -p 443:443 -p 2222:22 \
  -v /data/gitlab/config:/etc/gitlab \
  -v /data/gitlab/logs:/var/log/gitlab \
  -v /data/gitlab/data:/var/opt/gitlab \
  --name gitlab --restart always \
  gitlab/gitlab-ce:latest

数据、配置、日志全部落在宿主机 /data/gitlab/，升级或重建容器数据不丢。

初始化需要几分钟

首次启动要初始化数据库与服务，docker ps 显示健康检查未通过、网页短暂 502 都属正常，执行 docker logs -f gitlab 看到 gitlab Reconfigured! 后再等一两分钟即可访问。

获取初始密码并登录

浏览器访问 http://<服务器IP>，用户名为 root，初始密码在容器内：

docker exec -it gitlab cat /etc/gitlab/initial_root_password

该文件 24 小时后自动删除

登录后立即修改 root 密码（右上角头像 → Preferences → Password）。

常用初始化设置

1. 界面换中文：Preferences → Language → 简体中文 → 保存刷新。
2. 关闭公开注册：管理区域（Admin）→ Settings → General → Sign-up restrictions → 取消勾选 Sign-up enabled，防止陌生人注册。
3. 建项目：New project → 填名称 → 内部/私有可见性。

拉取与推送代码

网页复制仓库地址时注意协议：

• HTTP：http://<服务器IP>/<分组>/<项目>.git，首次推送用 root 账号（建议在 Preferences → Access Tokens 建专用令牌代替密码）。
• SSH：容器内 SSH 端口被映射为宿主机 2222，地址形如 ssh://git@<服务器IP>:2222/<分组>/<项目>.git；本地生成密钥并把公钥粘到 Preferences → SSH Keys，参见使用SSH密钥对实现免密登录。

数据备份与恢复

# 手动备份（生成到宿主机 /data/gitlab/data/backups/）
docker exec -t gitlab gitlab-backup create

# 恢复（先停写入服务）
docker exec -t gitlab gitlab-ctl stop puma
docker exec -t gitlab gitlab-ctl stop sidekiq
docker exec -t gitlab gitlab-backup restore BACKUP=<备份文件名不带_timestamp后缀>

配合 Cron 定时任务每天凌晨自动执行备份命令即可。

常见问题

网页一直 502？

绝大多数是内存不足：free -h 确认后加大内存，或先配 swap 兜底（参见配置Swap与虚拟内存）再观察；单核低配机器初始化也可能超过 10 分钟。

端口被占用启动失败？

服务器上已有 Nginx 等服务占用 80 时，把映射改为 -p 8080:80 -p 8443:443，用 IP:8080 访问；或让 GitLab 走已有 Nginx 反代（参见Nginx服务配置多站点）。

root 密码丢了？

docker exec -it gitlab gitlab-rake "gitlab:password:reset[root]"

按提示输入两次新密码即生效。

忘记备份了，容器还能重建吗？

数据卷在宿主机 /data/gitlab/，只要这个目录还在，删掉容器重新 docker run（同样的挂载路径）即可完整恢复。