debian gitlab怎么配置

下面按常见场景给你一个比较完整的 Debian 上 GitLab 配置指南，涵盖安装、基础配置、常用设置、备份与常见问题。如果你指的是已有 GitLab 只想改配置，可以直接跳到对应部分。

一、环境准备（Debian）

1. 系统要求

• Debian 11 / 12（推荐）
• 至少 4GB 内存（2GB 会很卡）
• 已配置好域名（可选但强烈建议）

2. 更新系统

sudo apt update
sudo apt upgrade -y

二、安装 GitLab（Omnibus 方式，最推荐）

1. 安装依赖

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

邮件服务选择 Internet Site 即可

2. 添加 GitLab 源

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

3. 安装 GitLab

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

如果是社区版：

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

三、基础配置（重点）

1. 主配置文件

sudo vim /etc/gitlab/gitlab.rb

2. 常用配置项

域名

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

HTTPS（自带 Let’s Encrypt）

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

修改端口（如 8080）

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

邮件配置（SMTP）

gitlab_rails['smtp_enable'] = true
gitlab_rails['smtp_address'] = "smtp.example.com"
gitlab_rails['smtp_port'] = 465
gitlab_rails['smtp_user_name'] = "gitlab@example.com"
gitlab_rails['smtp_password'] = "password"
gitlab_rails['smtp_authentication'] = "login"
gitlab_rails['smtp_enable_starttls_auto'] = true
gitlab_rails['gitlab_email_from'] = 'gitlab@example.com'

3. 使配置生效

sudo gitlab-ctl reconfigure

四、初始登录

1. 查看 root 密码

sudo cat /etc/gitlab/initial_root_password

2. 登录

https://gitlab.example.com

首次登录后务必修改 root 密码

五、常用运维命令

# 启动
sudo gitlab-ctl start

# 停止
sudo gitlab-ctl stop

# 重启
sudo gitlab-ctl restart

# 查看状态
sudo gitlab-ctl status

# 查看日志
sudo gitlab-ctl tail

六、备份与恢复

1. 备份

sudo gitlab-rake gitlab:backup:create

备份目录：

/var/opt/gitlab/backups

2. 恢复

sudo gitlab-rake gitlab:backup:restore BACKUP=时间戳

七、防火墙 & Nginx

GitLab 自带 Nginx，通常不需要额外配置。

如启用 UFW：

sudo ufw allow 80
sudo ufw allow 443

八、常见问题

1. 页面打不开

• 检查 external_url
• sudo gitlab-ctl reconfigure
• 查看端口占用

2. 内存不足

编辑：

unicorn['worker_processes'] = 2
postgresql['shared_buffers'] = "256MB"

然后：

sudo gitlab-ctl reconfigure

3. 忘记 root 密码

sudo gitlab-rails console
user = User.where(username: 'root').first
user.password = 'newpassword'
user.save!

如果你能补充一下：

• ✅ 是 GitLab CE 还是 EE
• ✅ 是否使用 Docker
• ✅ 是否已有服务器只是改配置
• ✅ 是否内网 / 公网

我可以给你更精准的配置方案。