新搭建GitLab Docker容器无法通过SSH密钥完成身份验证求助
GitLab Docker 容器SSH公钥认证失败排查
已确认的问题场景
- 全新部署的GitLab Docker容器,Web端等所有业务功能运行正常,仅无法通过SSH协议完成身份验证
- 严格对照GitLab官方SSH配置指引操作,无论生成ED25519、RSA哪种类型的密钥,不管是Linux原生客户端还是Windows端Git Bash环境,服务端都会直接拒绝公钥请求,全程不会弹出密码输入提示
- 已完成基础项自查:使用非标准SSH端口时已在访问命令中指定对应端口,反复核对过服务端、客户端的SSH功能均处于启用状态
- 客户端SSH调试日志显示,提交公钥报文后服务端直接返回拒绝响应:
debug1: Offering public key: /c/Users/[user]/.ssh/id_ed25519 ED25519 SHA256:[SHA-256] debug3: send packet: type 50 debug2: we sent a publickey packet, wait for reply debug3: receive packet: type 51
上述日志中的type 51报文是SSH协议中公钥校验失败的标准响应,说明TCP连接已正常建立到SSH握手阶段,可直接排除网络不通、端口未开放类的基础问题。
高概率问题点排查
按踩坑优先级从高到低核对即可快速定位根源:
- 核对GitLab内部SSH端口配置一致性
Docker部署GitLab时,如果你将宿主机的非标准端口映射到容器内部的22(SSH服务默认端口),必须同步修改GitLab配置中gitlab_rails['gitlab_shell_ssh_port']的值,和宿主机对外暴露的SSH端口保持完全一致。如果两个值不匹配,SSH服务侧的git用户家目录路径映射会出现逻辑错位,即便是公钥内容完全正确,也会被服务端直接拒绝,不会进入后续的密码验证流程。 - 检查容器内SSH密钥文件的权限与属主
进入GitLab容器内部查看/var/opt/gitlab/.ssh/authorized_keys文件的状态:正常情况下该文件属主应为git用户,权限为600。如果部署时通过挂载卷映射配置目录,出现了权限错位导致文件属主变成root、权限值高于600,SSH服务会出于安全机制直接跳过所有公钥校验逻辑,返回的响应和上述日志完全一致。 - 确认上传到GitLab的公钥内容合规
检查账号后台上传的公钥内容,确认没有多余的换行、前后空格,也没有误把私钥内容粘贴到公钥输入框;如果是团队版GitLab开启了密钥访问权限管控,需要确认当前使用的账号已经被纳入允许SSH访问的权限组,无权限的账号提交公钥后会被服务端静默拒绝。 - 核对Docker端口映射的协议类型
Docker端口映射默认使用TCP协议,部分自定义网络配置下如果误将SSH端口映射为UDP协议,会出现TCP连接可正常建立、但在公钥交换阶段直接被掐断返回拒绝的异常,和日志表现完全匹配。
内容的提问来源于stack exchange,提问作者dkd6
相关产品推荐
相关产品推荐

