Debian怎么配置GitLab

下面给你一份在 Debian 上配置 GitLab（CE 社区版）的完整流程，适用于 Debian 11 / 12。如果你用的是 Ubuntu，步骤也几乎一样。

一、准备环境

1. 系统要求

Debian 11 (Bullseye) / 12 (Bookworm)
最低配置
- CPU：2 核
- 内存：4GB 以上（强烈建议 8GB）
- 磁盘：20GB+

2. 更新系统

sudo apt update
sudo apt upgrade -y

二、安装依赖

sudo apt install -y \
  curl \
  openssh-server \
  ca-certificates \
  tzdata \
  gnupg \
  lsb-release

三、添加 GitLab 官方仓库

1. 导入 GitLab GPG 密钥

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

2. 添加 GitLab APT 源

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

四、安装 GitLab CE

sudo apt update
sudo apt install -y gitlab-ce

安装完成后会看到类似：

Thank you for installing GitLab!

五、基础配置

1. 编辑配置文件

sudo nano /etc/gitlab/gitlab.rb

重点修改：

设置访问地址

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

如果是 HTTPS：

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

如果是内网 IP：

external_url 'http://192.168.1.100'

2. 应用配置（重要）

sudo gitlab-ctl reconfigure

⚠️ 这一步会执行 Chef，时间稍长，不要中断。

六、初次访问 GitLab

1. 获取 root 初始密码

sudo cat /etc/gitlab/initial_root_password

密码只在 24 小时内有效（实际可一直用，只要不删除文件）

2. 浏览器访问

http://服务器IP

登录：

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

七、常用配置（强烈推荐）

1. 修改时区

gitlab_rails['time_zone'] = 'Asia/Shanghai'

2. 关闭注册（内网推荐）

gitlab_rails['gitlab_signup_enabled'] = false

3. 配置 SMTP 邮件（可选）

gitlab_rails['smtp_enable'] = true
gitlab_rails['smtp_address'] = "smtp.qq.com"
gitlab_rails['smtp_port'] = 465
gitlab_rails['smtp_user_name'] = "xxx@qq.com"
gitlab_rails['smtp_password'] = "授权码"
gitlab_rails['smtp_domain'] = "qq.com"
gitlab_rails['smtp_authentication'] = "login"
gitlab_rails['smtp_enable_starttls_auto'] = true
gitlab_rails['smtp_tls'] = true

修改后执行：

sudo gitlab-ctl reconfigure

八、常用管理命令

# 查看状态
sudo gitlab-ctl status

# 重启
sudo gitlab-ctl restart

# 查看日志
sudo gitlab-ctl tail

# 查看配置
sudo gitlab-rake gitlab:env:info

九、防火墙（如有）

sudo ufw allow 80
sudo ufw allow 443
sudo ufw reload

十、HTTPS（可选但推荐）

使用 Let’s Encrypt

letsencrypt['enable'] = true
letsencrypt['contact_emails'] = ['admin@example.com']

sudo gitlab-ctl reconfigure

十一、常见问题

1. 内存不足

sudo fallocate -l 4G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

2. 502 错误

等待 1–2 分钟
检查内存
查看日志：

sudo gitlab-ctl tail

十二、总结

✅ Debian 安装 GitLab 核心步骤：

安装依赖
添加 GitLab 仓库
安装 gitlab-ce
配置 external_url
gitlab-ctl reconfigure
浏览器访问 + root 登录

如果你需要：

GitLab + Docker
GitLab Runner（CI/CD）
LDAP / 企业微信 / 钉钉登录
高可用 / 备份迁移

可以直接告诉我你的使用场景，我可以给你定制方案。