如何在debian部署gitlab

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

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

下面分别说明。

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

1. 系统要求

• Debian 11 / 12（推荐 64 位）
• 至少 4GB 内存（2GB 可用 swap 也可勉强）
• root 或 sudo 权限

2. 安装依赖

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

3. 添加 GitLab 仓库

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

如果你要用社区版（CE），把 gitlab-ee 换成 gitlab-ce

4. 安装 GitLab

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

如果是本机测试：

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

5. 启动并初始化

sudo gitlab-ctl reconfigure

6. 访问 GitLab

浏览器打开：

http://服务器IP

首次登录账号：

• 用户名：root
• 密码在：

sudo cat /etc/gitlab/initial_root_password

二、使用 Docker 部署（适合已有 Docker）

1. 安装 Docker

sudo apt install -y docker.io docker-compose
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

三、常见配置

修改外部访问地址

编辑：

sudo vim /etc/gitlab/gitlab.rb

修改：

external_url 'http://你的域名或IP'

然后：

sudo gitlab-ctl reconfigure

启用 HTTPS（可选）

external_url 'https://gitlab.example.com'
letsencrypt['enable'] = true

四、常用命令

sudo gitlab-ctl status
sudo gitlab-ctl stop
sudo gitlab-ctl start
sudo gitlab-ctl restart

如果你愿意，我可以：

• 帮你写 一键部署脚本
• 帮你配置 域名 + HTTPS
• 帮你做 GitLab CI/CD 示例

你目前的 Debian 版本和用途（学习 / 公司内网 / 公网）是？