/etc/gitlab/gitlab.rb 中 gitlab-shell 的 url 设置

### 如何配置 `/etc/gitlab/gitlab.rb` 中的 `gitlab-shell` URL 在 GitLab 配置文件 `/etc/gitlab/gitlab.rb` 中，可以通过设置参数来定义 `gitlab-shell` 的行为以及其关联的 URL。具体到 `gitlab-shell` 的 URL 设置，主要涉及的是 SSH 主机名和端口号的相关配置。 以下是详细的说明： #### 1. 修改 SSH 主机名 为了指定 `gitlab-shell` 使用的 URL 或者主机名，可以调整以下参数： ```bash gitlab_rails['gitlab_ssh_host'] = 'your-domain-or-ip' ``` 这里的 `'your-domain-or-ip'` 应替换为实际的域名或者 IP 地址[^1]。此参数决定了通过 SSH 连接时使用的主机名称。 #### 2. 调整 SSH 端口 如果需要自定义 SSH 端口（默认情况下是 22），则需修改如下参数： ```bash gitlab_rails['gitlab_shell_ssh_port'] = your_custom_port_number ``` 例如，将端口更改为 9922，则应写成： ```bash gitlab_rails['gitlab_shell_ssh_port'] = 9922 ``` #### 3. 更新外部访问 URL 确保外部访问地址也正确无误，这会影响整个系统的可用性和用户体验： ```bash external_url 'http://your-gitlab-url' ``` 此处的 `'http://your-gitlab-url'` 是指 GitLab 实例对外暴露的服务地址[^1]。它不仅影响 Web 访问路径，还间接决定克隆仓库时所用的 URL 形式。 #### 4. 完成更改后的操作 完成以上编辑之后，保存并关闭文件。接着执行命令使新配置生效： ```bash gitlab-ctl reconfigure ``` 该指令会基于当前 `/etc/gitlab/gitlab.rb` 文件的内容重新生成必要的配置文件，并应用新的设定。 最后一步是重启服务以加载最新的改动： ```bash gitlab-ctl restart ``` #### 注意事项 尽管上述过程涵盖了大部分场景下的需求，但在某些复杂环境中可能还需要额外考虑防火墙规则、DNS 解析等问题。另外，若使用 HTTPS 协议代替 HTTP 提供服务，则还需进一步处理证书等相关事宜[^3]。 --- ### 示例代码片段 假设要将 GitLab Shell 的 SSH 主机设为 `example.com` 并启用非标准端口 9922，同时保持外网可访问的状态，那么完整的配置部分看起来像这样： ```ruby # /etc/gitlab/gitlab.rb external_url 'https://example.com' # gitlab-shell settings gitlab_rails['gitlab_ssh_host'] = 'example.com' gitlab_rails['gitlab_shell_ssh_port'] = 9922 ``` 随后按照前述方法依次运行 `reconfigure` 和 `restart` 命令即可。 ---