Debian安装GitLab步骤是什么

在 Debian 上安装 GitLab（官方推荐方式）通常使用 Omnibus 包，这也是最简单、最稳定的方式。下面以 GitLab CE（社区版） 为例，步骤适用于 Debian 11 / 12。

一、准备环境

1. 系统要求

Debian 11 (Bullseye) 或 Debian 12 (Bookworm)
至少 4GB 内存（2GB 勉强，不推荐）
至少 2 核 CPU
开启 80 / 443 端口

2. 更新系统

sudo apt update
sudo apt upgrade -y

3. 安装依赖

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

二、安装 GitLab

1. 添加 GitLab 官方仓库

curl -fsSL https://packages.gitlab.com/gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/gitlab-archive-keyring.gpg

echo "deb [signed-by=/usr/share/keyrings/gitlab-archive-keyring.gpg] https://packages.gitlab.com/gitlab/gitlab-ce/debian $(lsb_release -cs) main" | \
sudo tee /etc/apt/sources.list.d/gitlab_gitlab-ce.list

如果 lsb_release 不存在：

sudo apt install -y lsb-release

2. 安装 GitLab CE

sudo apt update
sudo apt install -y gitlab-ce

三、配置 GitLab

1. 修改配置文件

sudo nano /etc/gitlab/gitlab.rb

关键配置项：

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

如果是 HTTPS：

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

域名需提前解析到服务器 IP

2. 应用配置（重要）

sudo gitlab-ctl reconfigure

⚠️ 这一步会执行 Chef，时间较长，请勿中断。

四、访问 GitLab

1. 获取初始 root 密码

sudo cat /etc/gitlab/initial_root_password

⚠️ 密码仅在 24 小时内有效，建议登录后立即修改。

2. 浏览器访问

http://服务器IP

使用：

用户名：root
密码：上面查到的密码

五、常用管理命令

# 查看状态
sudo gitlab-ctl status

# 重启
sudo gitlab-ctl restart

# 查看日志
sudo gitlab-ctl tail

# 停止
sudo gitlab-ctl stop

六、可选配置

1. 配置 HTTPS（推荐）

使用 Let’s Encrypt：

letsencrypt['enable'] = true
letsencrypt['auto_renew'] = true

然后：

sudo gitlab-ctl reconfigure

2. 修改端口（如 8080）

external_url 'http://your_ip:8080'
nginx['listen_port'] = 8080

3. 邮件配置（SMTP）

gitlab_rails['smtp_enable'] = true
gitlab_rails['smtp_address'] = "smtp.example.com"
gitlab_rails['smtp_port'] = 587
gitlab_rails['smtp_user_name'] = "user@example.com"
gitlab_rails['smtp_password'] = "password"
gitlab_rails['smtp_domain'] = "example.com"
gitlab_rails['smtp_authentication'] = "login"
gitlab_rails['smtp_enable_starttls_auto'] = true

七、常见问题

安装慢？

可使用国内镜像（如清华、中科大）
或提前下载 .deb 包安装

内存不足？

关闭部分服务（CI Runner、Prometheus）

如果你需要：

Debian + Docker 安装 GitLab
GitLab Runner 配置
从源码安装
迁移 / 升级 GitLab

可以直接告诉我你的使用场景。