debian上gitlab怎么配置

下面给你一个在 Debian 上配置 GitLab（以 GitLab CE 为例）的实用指南，从安装 → 基础配置 → 常用设置，适合服务器初次部署。

一、环境准备（Debian）

1. 系统要求

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

2. 更新系统

sudo apt update
sudo apt upgrade -y

二、安装 GitLab（官方源方式）

1. 安装依赖

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

postfix 选择 Internet Site 即可

2. 添加 GitLab 源

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

3. 安装 GitLab CE

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

如果是 IP 访问：

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

安装完成后会自动执行 gitlab-ctl reconfigure

三、基础配置（关键）

1. 主配置文件

sudo vim /etc/gitlab/gitlab.rb

2. 修改访问地址

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

3. 配置邮箱（可选但重要）

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_authentication'] = "login"
gitlab_rails['smtp_enable_starttls_auto'] = true
gitlab_rails['smtp_tls'] = true
gitlab_rails['gitlab_email_from'] = "xxx@qq.com"

4. 使配置生效

sudo gitlab-ctl reconfigure

四、常用管理命令

sudo gitlab-ctl start      # 启动
sudo gitlab-ctl stop       # 停止
sudo gitlab-ctl restart    # 重启
sudo gitlab-ctl status     # 状态
sudo gitlab-ctl tail       # 查看日志

五、首次登录

1. 浏览器访问：

http://你的IP或域名

2. 设置 root 密码
3. 使用 root 登录

六、HTTPS（推荐）

使用 Let’s Encrypt

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

然后：

sudo gitlab-ctl reconfigure

七、备份与恢复

备份

sudo gitlab-rake gitlab:backup:create

恢复

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

八、常见问题

1. 访问慢

• 关闭 Prometheus（可选）

prometheus['enable'] = false

2. 端口冲突

nginx['listen_port'] = 8080

如果你愿意，我可以：

• ✅ 给你 Docker 版 GitLab 配置
• ✅ 帮你做 CI/CD 配置示例
• ✅ 针对 内网 / 云服务器 给你优化方案

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