温馨提示×

linux下gitlab在哪配置

小樊
39
2026-07-28 13:30:35
栏目: 智能运维

在 Linux 下,GitLab 的配置文件位置取决于你是使用哪种方式安装的。下面是最常见的几种情况说明:


一、Omnibus 方式安装(最常见 ✅)

如果你是通过 GitLab 官方 Omnibus 包 安装的(如 gitlab-ce / gitlab-ee),配置文件在:

/etc/gitlab/gitlab.rb

常用操作

1️⃣ 编辑配置

sudo vim /etc/gitlab/gitlab.rb

2️⃣ 修改后重新加载配置(必须)

sudo gitlab-ctl reconfigure

3️⃣ 查看当前生效配置

sudo gitlab-ctl show-config

二、Docker 方式运行 GitLab

1️⃣ 容器内的配置文件

在容器内仍然是:

/etc/gitlab/gitlab.rb

2️⃣ 宿主机上配置方式(推荐)

通常是通过 volume 映射

docker run -d \
  --name gitlab \
  -v /srv/gitlab/config:/etc/gitlab \
  -v /srv/gitlab/logs:/var/log/gitlab \
  -v /srv/gitlab/data:/var/opt/gitlab \
  gitlab/gitlab-ce

那么你应该在宿主机修改:

/srv/gitlab/config/gitlab.rb

然后进入容器执行:

docker exec -it gitlab gitlab-ctl reconfigure

三、源码安装(较少见 ⚠️)

如果你是从源码安装的 GitLab,配置文件一般在:

/home/git/gitlab/config/gitlab.yml

以及:

/home/git/gitlab-shell/config.yml

⚠️ 源码安装现在官方已不推荐。


四、常见配置示例(gitlab.rb)

修改外部访问地址

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

修改端口

external_url 'http://192.168.1.10:8080'

配置 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'] = "password"
gitlab_rails['smtp_domain'] = "qq.com"
gitlab_rails['smtp_authentication'] = "login"
gitlab_rails['smtp_enable_starttls_auto'] = true
gitlab_rails['smtp_tls'] = true

五、相关目录速查

作用 路径
主配置文件 /etc/gitlab/gitlab.rb
实际生效配置 /var/opt/gitlab/
日志目录 /var/log/gitlab/
服务管理 gitlab-ctl

六、确认你的 GitLab 安装方式

gitlab-ctl status

如果能正常显示服务状态,99% 是 Omnibus 安装


如果你可以告诉我:

  • ✅ 是 物理机 / 虚拟机 / Docker
  • ✅ 想配置 端口 / HTTPS / 邮箱 / 备份 / CI / LDAP

我可以直接给你一份完整可用配置示例

0