GitLab Linux版的网络配置是怎样的

GitLab Linux版网络配置要点

一 核心配置项

• 主配置文件为 /etc/gitlab/gitlab.rb，其中最关键的是 external_url，用于定义用户访问的协议、域名或 IP（及端口）。例如：external_url ‘http://your_domain_or_IP’ 或 ‘https://your_domain_or_IP’。修改后需执行 gitlab-ctl reconfigure 使配置生效。若需修改 GitLab 内置 Nginx 监听端口（例如将 HTTP 改为 8000），可在 gitlab.rb 中设置 nginx[‘listen_port’] = 800 后再 reconfigure。以上设置决定外部访问地址、端口与协议，是所有网络行为的入口。

二 端口与防火墙

• 默认对外服务端口为：HTTP 80、HTTPS 443、SSH 22。在 firewalld 环境中应放行这些端口或服务：
  • 放行并持久化：sudo firewall-cmd --permanent --zone=public --add-service=http
  • 放行并持久化：sudo firewall-cmd --permanent --zone=public --add-service=https
  • 放行并持久化：sudo firewall-cmd --permanent --zone=public --add-service=ssh
  • 重新加载：sudo firewall-cmd --reload
• 如使用 UFW（Ubuntu 常见），需对应开放 80/443/22 端口。端口与防火墙的正确配置直接决定外部能否访问到 GitLab Web 与 SSH 服务。

三 主机网络与 DNS

• 若服务器使用静态 IP，需在网卡配置中设置（以 CentOS 为例，文件可能为 /etc/sysconfig/network-scripts/ifcfg-ens33）：
  • BOOTPROTO=static、ONBOOT=yes
  • IPADDR、NETMASK、GATEWAY、DNS1（如 8.8.8.8）
  • 使配置生效：sudo systemctl restart network
• 如使用域名访问，需确保 DNS 解析指向服务器 IP，或在本地 hosts 中做临时解析。网络连通性与 DNS 正确性直接影响 external_url 的可达性。

四 可选网络场景配置

• 端口冲突或特殊需求时，可调整内置 Nginx 监听端口（如将 HTTP 改为 8000）：在 /etc/gitlab/gitlab.rb 中设置 nginx[‘listen_port’] = 800 后执行 gitlab-ctl reconfigure。
• 启用 HTTPS：在 gitlab.rb 中设置 external_url ‘https://your_domain’，并按需配置证书与重定向：
  • 示例：
    • nginx[‘enable’] = true
    • nginx[‘redirect_http_to_https’] = true
    • nginx[‘ssl_certificate’] = “/etc/gitlab/ssl/server_cert.crt”
    • nginx[‘ssl_certificate_key’] = “/etc/gitlab/ssl/private.key”
  • 完成后执行 gitlab-ctl reconfigure 使证书与重定向生效。
• 容器化部署（Docker）时，通过端口映射将宿主机的 5480:80、5443:443、5022:22 映射到容器内，并在容器内相应调整 GitLab 的网络/端口参数，以适配外部访问路径与端口规划。

五 验证与排错

• 检查生效配置：grep “external_url” /etc/gitlab/gitlab.rb；必要时查看实际生效配置：gitlab-ctl diff-config。
• 应用配置变更：sudo gitlab-ctl reconfigure；重启相关服务：sudo gitlab-ctl restart。
• 访问测试：在浏览器打开配置的 http(s)://your_domain_or_IP；首次访问按提示设置管理员密码。
• 连通性排查：确认防火墙已放行 80/443/22，网络路由与 DNS 正常；如仍不可达，复核 external_url、端口占用与证书路径是否正确。