ubuntu如何部署gitlab

在 Ubuntu 上部署 GitLab 通常有两种主流方式：

1. Omnibus 包安装（官方推荐，最简单）
2. Docker 部署（更适合已有 Docker 环境）

下面分别说明，最常用的是 方式一。

一、使用官方 Omnibus 包安装（推荐）

1. 系统要求

• Ubuntu 20.04 / 22.04（推荐）
• 至少 4GB 内存（2GB 容易卡）
• 已配置好域名（可选但推荐）

2. 安装依赖

sudo apt update
sudo apt install -y curl openssh-server ca-certificates tzdata perl

3. 添加 GitLab 仓库

curl -fsSL https://packages.gitlab.com/install/repositories/gitlab/gitlab-ee/script.deb.sh | sudo bash

如果是社区版（CE）：

curl -fsSL https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash

4. 安装 GitLab

sudo EXTERNAL_URL="http://gitlab.example.com" apt install gitlab-ee

如果是本地测试：

sudo EXTERNAL_URL="http://你的服务器IP" apt install gitlab-ee

5. 访问 GitLab

• 浏览器打开：http://服务器IP
• 初始管理员账号：root
• 密码在：

sudo cat /etc/gitlab/initial_root_password

6. 常用管理命令

sudo gitlab-ctl reconfigure   # 重新加载配置
sudo gitlab-ctl restart       # 重启
sudo gitlab-ctl status        # 查看状态

二、使用 Docker 部署（推荐有 Docker 经验）

1. 安装 Docker

sudo apt install docker.io docker-compose -y
sudo systemctl enable --now docker

2. 创建 docker-compose.yml

version: '3'
services:
  gitlab:
    image: gitlab/gitlab-ee:latest
    container_name: gitlab
    restart: always
    hostname: gitlab.example.com
    environment:
      GITLAB_OMNIBUS_CONFIG: |
        external_url 'http://服务器IP'
    ports:
      - "80:80"
      - "443:443"
      - "22:22"
    volumes:
      - ./gitlab/config:/etc/gitlab
      - ./gitlab/logs:/var/log/gitlab
      - ./gitlab/data:/var/opt/gitlab

3. 启动

docker compose up -d

4. 查看 root 密码

docker exec -it gitlab grep 'Password:' /etc/gitlab/initial_root_password

三、常见问题

1. 访问很慢 / 502

• 内存不足（至少 4G）
• 执行：

sudo gitlab-ctl restart

2. 修改访问地址

编辑：

sudo vim /etc/gitlab/gitlab.rb

修改：

external_url 'http://新地址'

然后：

sudo gitlab-ctl reconfigure

3. 开启 HTTPS

可使用 Let’s Encrypt：

letsencrypt['enable'] = true

如果你告诉我：

• Ubuntu 版本
• 是否用 Docker
• 是否用于生产环境

我可以给你一套更精确的部署方案。