如何在debian搭建gitlab

在 Debian 上搭建 GitLab（以 GitLab CE 社区版 为例）通常有两种主流方式：

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

下面我分别说明，生产环境强烈推荐方式一。

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

1. 系统要求

• Debian 11 / 12（推荐）
• 至少 4GB 内存（2GB 会很卡）
• root 权限

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-ce/script.deb.sh | sudo bash

4. 安装 GitLab CE

替换为你自己的域名或 IP：

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

如果是本机测试：

sudo EXTERNAL_URL="http://192.168.1.100" apt install gitlab-ce

5. 启动并初始化

sudo gitlab-ctl reconfigure

6. 访问 GitLab

浏览器打开：

http://你的IP或域名

首次登录：

• 用户名：root
• 密码在：

sudo cat /etc/gitlab/initial_root_password

二、使用 Docker 部署（轻量、灵活）

1. 安装 Docker

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

2. 创建目录

mkdir -p /srv/gitlab/{config,logs,data}

3. docker-compose.yml

version: '3'
services:
  gitlab:
    image: gitlab/gitlab-ce:latest
    container_name: gitlab
    restart: always
    ports:
      - "80:80"
      - "443:443"
      - "22:22"
    volumes:
      - /srv/gitlab/config:/etc/gitlab
      - /srv/gitlab/logs:/var/log/gitlab
      - /srv/gitlab/data:/var/opt/gitlab

4. 启动

docker-compose up -d

三、常见配置

修改外部访问地址

编辑：

sudo nano /etc/gitlab/gitlab.rb

external_url 'http://gitlab.example.com'

然后：

sudo gitlab-ctl reconfigure

启用 HTTPS（可选）

external_url 'https://gitlab.example.com'

并使用 Let’s Encrypt：

letsencrypt['enable'] = true

四、常用管理命令

sudo gitlab-ctl status
sudo gitlab-ctl restart
sudo gitlab-ctl stop
sudo gitlab-ctl tail

五、注意事项

• 不要用最低配 VPS（容易 OOM）
• 生产环境建议配域名 + HTTPS
• 定期备份：

sudo gitlab-rake gitlab:backup:create

如果你告诉我：

• Debian 版本
• 是否用于生产
• 是否已有域名 / Docker

我可以给你一套更精确的配置方案。