Linux GitLab配置中的关键参数有哪些

Linux GitLab 配置关键参数清单

一基础与网络

external_url：设置实例对外访问地址（含协议与端口），影响页面中仓库 Clone 地址显示与重定向。示例：external_url ‘https://gitlab.example.com’ 或带端口 ‘http://192.168.1.10:8080’。修改后需执行应用配置。
nginx 监听端口与协议：当 80/443 被占用或需非标准端口时，在 gitlab.rb 中调整 nginx[‘listen_port’]、nginx[‘listen_https’] 等，并同步设置 external_url 的端口。
SSH 访问与端口：通过 gitlab_rails[‘gitlab_ssh_host’] 与 GitLab 内置 Nginx 的 gitlab_rails[‘gitlab_shell_ssh_port’] 控制 SSH 主机名与展示端口（对仓库 Clone 地址的 ssh:// 显示生效）。实际 SSH 服务仍由系统 sshd 提供，注意系统防火墙与端口放行。

二邮件与通知

启用与发件人：
- gitlab_rails[‘gitlab_email_enabled’] = true
- gitlab_rails[‘gitlab_email_from’] = ‘gitlab@example.com’
SMTP 关键参数（示例为端口 587/STARTTLS）：
- gitlab_rails[‘smtp_enable’] = true
- gitlab_rails[‘smtp_address’] = “smtp.example.com”
- gitlab_rails[‘smtp_port’] = 587
- gitlab_rails[‘smtp_user_name’] = “gitlab@example.com”
- gitlab_rails[‘smtp_password’] = “授权码或密码”
- gitlab_rails[‘smtp_domain’] = “example.com”
- gitlab_rails[‘smtp_authentication’] = “login”
- gitlab_rails[‘smtp_enable_starttls_auto’] = true
- gitlab_rails[‘smtp_tls’] = false（按实际 SMTP 要求开启/关闭）
提示：很多邮箱（如 QQ/163/126）需使用“客户端授权码”而非登录密码；配置完成后用控制台/工单测试邮件发送。

三存储与备份

仓库数据目录：默认 /var/opt/gitlab/git-data/repositories。多盘或 NFS 场景可用 git_data_dirs 指定多路径，示例：
- git_data_dirs({ “default” => { “path” => “/var/opt/gitlab/git-data” }, “nfs” => { “path” => “/mnt/nfs-01/git-data” } })
  迁移旧数据时先停服务，使用 rsync 保持权限与层级一致，再 reconfigure/启动。
备份目录与保留：默认备份路径 /var/opt/gitlab/backups，可通过 gitlab_rails[‘backup_path’] 调整；定期备份并验证恢复流程。
密钥与敏感配置：/etc/gitlab/gitlab-secrets.json 存放加密密钥（如数据库、CI 等），变更需谨慎并备份。

四性能与并发

Puma（Rails Web 工作进程）：puma[‘worker_processes’] 建议从 2–4 起步，按 CPU 核数与内存调优，避免 OOM。
Sidekiq（后台任务）：sidekiq[‘max_concurrency’] 控制并发作业数，I/O 密集可适当上调，内存紧张时下调。
PostgreSQL（内置数据库）：postgresql[‘shared_buffers’] 建议设为内存的 约 1/4（如 4GB 内存可先试 1GB），postgresql[‘max_worker_processes’] 结合 CPU/负载调整。
监控组件：prometheus_monitoring[‘enable’] 在生产可关闭以降低资源占用（需要时再开启）。

五生效验证与运维命令

使配置生效：每次修改 /etc/gitlab/gitlab.rb 后执行：
- sudo gitlab-ctl reconfigure（渲染配置并创建/调整目录与权限）
- sudo gitlab-ctl restart（必要时重启相关服务）
常用运维：
- gitlab-ctl status（查看组件运行状态）
- gitlab-ctl tail（实时查看日志）
- gitlab-ctl show-config（校验最终生效配置）
- 首次安装后管理员密码：cat /etc/gitlab/initial_root_password（请及时修改并妥善保管）

最新问答