debian中gitlab怎么设置

在 Debian 上“设置 GitLab”通常包含 安装、基础配置、常用参数调整 几部分。下面按**最常用的自建 GitLab（Community Edition，Omnibus 包）**来说明。

一、在 Debian 上安装 GitLab

1. 安装依赖

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

2. 添加 GitLab 仓库（官方源）

curl 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

安装完成后执行：

sudo gitlab-ctl reconfigure

二、基础配置（最重要）

1. 配置文件位置

/etc/gitlab/gitlab.rb

2. 修改外部访问地址

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

或 HTTPS：

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

修改后执行：

sudo gitlab-ctl reconfigure

三、常用设置示例

1. 设置管理员密码

首次访问 Web 页面会让你设置 root 密码
或命令行重置：

sudo gitlab-rake "gitlab:password:reset[root]"

2. 修改端口（如 8080）

external_url 'http://192.168.1.100:8080'

或 Nginx 单独端口：

nginx['listen_port'] = 8080

然后：

sudo gitlab-ctl reconfigure

3. 使用 HTTPS（可选）

external_url 'https://gitlab.example.com'
nginx['ssl_certificate'] = "/etc/gitlab/ssl/gitlab.crt"
nginx['ssl_certificate_key'] = "/etc/gitlab/ssl/gitlab.key"

4. 禁用自带 Nginx（用已有 Nginx）

nginx['enable'] = false
web_server['external_users'] = ['www-data']

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

四、常用管理命令

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

五、防火墙 & 访问

sudo ufw allow 80
sudo ufw allow 443

浏览器访问：

http://服务器IP

六、你可能想问的方向

如果你指的是以下某一种，我可以更具体说明：

✅ GitLab Runner 配置（CI/CD）
✅ GitLab SSH / 密钥 设置
✅ GitLab Docker 部署
✅ GitLab 备份与迁移
✅ GitLab LDAP / 权限管理

你可以直接说：“我要配置 XXX”。