linux gitlab怎样修改配置

在 Linux 上修改 GitLab 配置，通常是通过修改 GitLab 的配置文件并重新加载/重启服务来完成。下面按常见场景说明。

一、GitLab 配置文件位置（最常见）

1. Omnibus 安装（官方推荐方式）

配置文件路径：

/etc/gitlab/gitlab.rb

修改步骤：

sudo vi /etc/gitlab/gitlab.rb

修改完成后，使其生效：

sudo gitlab-ctl reconfigure

如果涉及服务重启：

sudo gitlab-ctl restart

二、常见配置修改示例

1️⃣ 修改外部访问地址

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

或 HTTPS：

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

修改后：

sudo gitlab-ctl reconfigure

2️⃣ 修改端口（非 80/443）

例如使用 8080：

external_url 'http://192.168.1.100:8080'

3️⃣ 开启 HTTPS（SSL）

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

nginx['ssl_certificate'] = "/etc/gitlab/ssl/gitlab.crt"
nginx['ssl_certificate_key'] = "/etc/gitlab/ssl/gitlab.key"

然后：

sudo gitlab-ctl reconfigure

4️⃣ 修改仓库存储路径

git_data_dirs({
  "default" => {
    "path" => "/data/gitlab/git-data"
  }
})

⚠️ 修改前需先停止服务并迁移数据。

5️⃣ 邮箱配置（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['smtp_tls'] = true

三、Docker 方式安装的 GitLab

如果是 Docker：

docker exec -it gitlab vi /etc/gitlab/gitlab.rb
docker restart gitlab

或挂载配置文件修改宿主机文件。

四、查看与排查

查看 GitLab 状态：

sudo gitlab-ctl status

查看配置是否生效：

sudo gitlab-rake gitlab:env:info

查看日志：

sudo gitlab-ctl tail

五、注意事项

✅ 改 gitlab.rb 后必须 reconfigure
❌ 不要直接改 /var/opt/gitlab 下的运行文件
修改重要路径前务必备份

如果你能告诉我：

GitLab 安装方式（Omnibus / Docker / 源码）
想改哪类配置（端口 / HTTPS / 邮箱 / 存储）

我可以给你精确命令。