Docker快速部署GitLab的详细指南

在 Windows 上使用 Docker 部署 GitLab 是完全可行的，推荐使用 Docker Desktop for Windows 来运行 GitLab 容器。以下是详细的本地部署步骤。

前提条件

确保你已安装以下工具：

1.Windows 10 或 Windows 11（64位）

2.Docker Desktop for Windows

启用 WSL2（Windows Subsystem for Linux），Docker Desktop 会自动处理

3.至少 4GB 可用内存（建议 8GB+，GitLab 较吃资源）

提示：GitLab 社区版（CE）启动后可能占用 2~3GB 内存，请确保系统资源充足。

步骤一：安装并启动 Docker Desktop

1.下载并安装 Docker Desktop for Windows

2.安装过程中勾选：

• Enable WSL2 Features
• Install required Windows components

3.安装完成后重启，打开 Docker Desktop

4.确保状态显示 “Docker Desktop is running”

步骤二：创建 GitLab 目录结构

选择一个位置，比如 D:\gitlab，创建以下目录：

D:\gitlab
├── config
├── data
└── logs

你可以手动创建，或在 PowerShell 中执行：

mkdir D:\gitlab\config
mkdir D:\gitlab\data
mkdir D:\gitlab\logs

步骤三：编写docker-compose.yml

在 D:\gitlab 下新建文件 docker-compose.yml，内容如下：

version: '3.6'
services:
  gitlab:
    image: gitlab/gitlab-ce:latest
    container_name: gitlab
    restart: always
    hostname: localhost
    environment:
      GITLAB_OMNIBUS_CONFIG: |
        external_url 'http://localhost:8989'
        nginx['listen_port'] = 8989
        nginx['listen_https'] = false
        gitlab_rails['time_zone'] = 'Asia/Shanghai'
        # 如果需要邮件通知可配置 SMTP（可选）
    ports:
      - "8989:8989"
      - "2222:22"
    volumes:
      - D:/gitlab/config:/etc/gitlab
      - D:/gitlab/data:/var/opt/gitlab
      - D:/gitlab/logs:/var/log/gitlab
    shm_size: '256m'

注意：

• 使用 D:/gitlab 而不是 \（Docker 兼容 POSIX 路径）
• external_url 设置为 http://localhost:8989，这样可以从本机浏览器访问
• SSH 映射到宿主机的 2222 端口，避免与 OpenSSH 冲突

步骤四：启动 GitLab

使用 PowerShell + Docker Compose

进入目录并启动：

cd D:\gitlab
docker-compose up -d

如果提示 'docker-compose' 不是命令，请确认 Docker Desktop 已安装完整组件。

或者直接使用：docker compose up -d（新版 Docker 使用无横杠命令）

打开网址设置密码

http://localhost:8989

1. 进入 GitLab 容器的 Rails 控制台

docker exec -it gitlab gitlab-rails console

2. 在控制台中执行（替换 ‘new_password’ 为你想设的新密码）

user = User.where(id: 1).first
user.password = 'new_password'
user.password_confirmation = 'new_password'
user.save!

3. 退出控制台

exit

到此这篇关于Docker快速部署GitLab的详细指南的文章就介绍到这了,更多相关Docker部署GitLab内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！