一、准备工作

安装Docker

# Ubuntu/Debian 系统
sudo apt update
sudo apt install docker.io docker-compose -y
sudo systemctl enable --now docker

# 验证安装
docker --version
docker-compose --version

创建数据目录
GitLab数据需要持久化保存：

sudo mkdir -p /srv/gitlab/{config,data,logs}
sudo chmod -R 755 /srv/gitlab

二、通过Docker安装GitLab

方法1：直接运行容器

docker run -d \
  --name gitlab \
  --hostname gitlab.example.com \  # 替换为你的域名或IP
  --publish 80:80 \
  --publish 443:443 \
  --publish 22:22 \
  --volume /srv/gitlab/config:/etc/gitlab \
  --volume /srv/gitlab/data:/var/opt/gitlab \
  --volume /srv/gitlab/logs:/var/log/gitlab \
  --restart always \
  --shm-size 256m \  # 避免内存不足
  gitlab/gitlab-ce:latest

方法2：使用Docker Compose

创建 docker-compose.yml 文件：

version: '3'
services:
  gitlab:
    image: gitlab/gitlab-ce:latest
    container_name: gitlab
    hostname: gitlab.example.com  # 替换为你的域名或IP
    restart: always
    environment:
      GITLAB_OMNIBUS_CONFIG: |
        external_url 'http://gitlab.example.com'  # 配置外部访问地址
    ports:
      - "80:80"
      - "443:443"
      - "22:22"
    volumes:
      - /srv/gitlab/config:/etc/gitlab
      - /srv/gitlab/data:/var/opt/gitlab
      - /srv/gitlab/logs:/var/log/gitlab
    shm_size: '256m'

启动容器：

docker-compose up -d

三、配置GitLab

等待初始化完成
首次启动需要1-5分钟，可通过以下命令查看状态：

docker logs -f gitlab

1. 访问GitLab
   浏览器访问 http://你的服务器IP，首次登录需设置 root 用户密码。

修改配置文件（可选）
编辑
/srv/gitlab/config/gitlab.rb（需重启容器生效）：

docker restart gitlab

四、防火墙配置（如启用）

# 开放HTTP/HTTPS/SSH端口
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw allow 22/tcp
sudo ufw reload

五、升级GitLab版本

# 停止并删除旧容器
docker stop gitlab
docker rm gitlab

# 拉取最新镜像
docker pull gitlab/gitlab-ce:latest

# 重新运行容器（使用之前的启动命令或docker-compose）
docker-compose up -d

六、备份与恢复

手动备份

docker exec -it gitlab gitlab-backup create

备份文件存储在 /srv/gitlab/data/backups

从备份恢复

# 将备份文件放入目录后执行
docker exec -it gitlab gitlab-backup restore BACKUP=备份文件名

七、常见问题

1. 端口冲突
   如果端口 80/443/22 被占用，修改 --publish 参数（如 8080:80）。
2. 内存不足
   建议服务器至少 4GB 内存，可通过 --shm-size 增加共享内存。

访问缓慢
编辑 gitlab.rb 添加以下配置后重启：

prometheus['listen_address'] = 'localhost:9090'
sidekiq['max_concurrency'] = 10

总结

通过以上步骤，你已成功在Docker中部署了GitLab。后续可通过Web界面管理项目、用户和CI/CD流水线。如需更安全的环境，建议配置HTTPS证书（可使用Let's Encrypt）

Tags：docker-compose 安装