### 如何在通过 Docker 守护程序安装的 GitLab 中配置 SSH #### 配置 SSH 端口 当使用 Docker 安装 GitLab 时，默认会使用标准的 SSH 端口 (22)，但如果该端口已被占用或者需要更改，则可以通过调整容器内的配置来实现自定义设置。如果要修改服务器上的 SSH 端口号，可以编辑 `config.toml` 文件中的相关内容并指定新的端口[^1]。 #### 修改 GitLab 的 SSH 端口 为了改变 GitLab 自身使用的 SSH 连接端口而不是整个系统的全局 SSH 设置，可以在启动 Docker 容器的时候传递环境变量给 GitLab 来完成此目的： ```bash docker run --detach \ --hostname gitlab.example.com \ --publish 80:80 --publish 443:443 --publish 2222:22 \ --name gitlab \ --restart always \ --volume /srv/gitlab/config:/etc/gitlab \ --volume /srv/gitlab/logs:/var/log/gitlab \ --volume /srv/gitlab/data:/var/opt/gitlab \ --env GITLAB_SSH_PORT=2222 \ gitlab/gitlab-ce:latest ``` 上述命令中设置了 `-e GITLAB_SSH_PORT=2222` 参数用于设定一个新的 SSH 端口为 2222 并映射到主机上相同的端口。 #### 更新外部访问 URL 和重载服务 一旦完成了对 SSH 端口的变更之后，还需要更新 `/etc/gitlab/gitlab.rb` 文件里的外链地址以便客户端能够正确连接至新端口下的仓库资源。例如: ```ruby external_url 'http://gitlab.example.com' gitlab_rails['gitlab_shell_ssh_port'] = 2222 ``` 随后应用这些改动需运行以下指令让 GitLab 应用最新的配置文件[^2]: ```bash docker exec -it gitlab gitlab-ctl reconfigure ``` #### 测试 SSH 功能正常工作 最后一步就是验证是否一切按预期运作良好。尝试从本地机器发起一次简单的测试请求看看能否成功建立链接关系： ```bash ssh -p 2222 git@gitlab.example.com ``` 如果返回类似下面的消息则表明已成功连通： ``` Welcome to GitLab, Anonymous! ``` #### 控制容器状态 对于日常维护来说掌握基本的操作技巧也是很有必要的，比如启停实例等动作可通过如下几个简单快捷的方式来达成目标[^3]: - **启动**: `docker start gitlab` - **重启**: `docker restart gitlab` - **停止**: `docker stop gitlab` 以上便是完整的基于 Docker 构建环境下针对 GitLab 实现个性化定制化 SSH 接入流程指南。