GitLab-CE Docker容器HTTPS无法访问问题排查求助

我处理过不少Docker环境下GitLab的HTTPS配置踩坑案例，结合你描述的情况，咱们从最容易忽略的关键点开始排查解决：

1. 先确认Docker容器的端口映射是否正确 #

这是最常见的疏漏！你启动GitLab容器时，必须同时映射80和443端口到宿主机，否则宿主机的443请求根本传不到容器内部。正确的启动命令应该包含这两个端口映射：

docker run ... -p 80:80 -p 443:443 ... gitlab/gitlab-ce:latest

如果之前启动时没加-p 443:443，赶紧停止容器，重新启动并补上这个端口映射规则。

2. 检查宿主机防火墙/安全组规则 #

• Ubuntu系统：执行ufw status查看是否开放了443端口，若未开放，运行ufw allow 443/tcp添加规则
• Redhat 8系统：用firewall-cmd --list-all检查端口状态，未开放的话执行firewall-cmd --add-port=443/tcp --permanent，再执行firewall-cmd --reload生效规则

3. 确保证书在容器内的权限和路径正确 #

你在宿主机/etc/gitlab/ssl存放了证书，但要确保这个目录已经挂载到容器内的/etc/gitlab/ssl（启动容器时需添加-v /etc/gitlab/ssl:/etc/gitlab/ssl）。另外，容器内的证书文件权限必须为600、属主为root，否则NGINX会因权限不足无法读取证书：
进入容器执行以下命令修正权限：

docker exec -it gitlab chmod 600 /etc/gitlab/ssl/xxx.crt /etc/gitlab/ssl/xxx.key
docker exec -it gitlab chown root:root /etc/gitlab/ssl/xxx.crt /etc/gitlab/ssl/xxx.key

4. 通过gitlab.rb配置，禁止手动修改NGINX配置文件 #

手动修改/var/opt/gitlab/nginx/conf/gitlab-http.conf完全没用，因为gitlab-ctl reconfigure会自动覆盖这个生成的配置文件。你需要修改容器内的/etc/gitlab/gitlab.rb（如果宿主机挂载了/etc/gitlab目录，直接修改宿主机的/etc/gitlab/gitlab.rb即可），添加或修改以下配置项：

# 设置HTTPS格式的外部访问地址
external_url 'https://你的域名或服务器IP'

# 指定证书文件的绝对路径
nginx['ssl_certificate'] = "/etc/gitlab/ssl/xxx.crt"
nginx['ssl_certificate_key'] = "/etc/gitlab/ssl/xxx.key"

# 开启HTTP自动跳转HTTPS（可选，若需强制HTTPS访问）
nginx['redirect_http_to_https'] = true

# 明确指定NGINX监听443端口（默认会自动设置，显式配置更稳妥）
nginx['listen_port'] = 443

5. 让配置生效并验证 #

修改完gitlab.rb后，进入容器执行配置重载命令，这会根据你的配置重新生成NGINX规则：

docker exec -it gitlab gitlab-ctl reconfigure

一定要等命令执行完成，留意是否有报错（比如证书找不到、权限错误等）。

之后重启GitLab的NGINX服务：

docker exec -it gitlab gitlab-ctl restart nginx

或者直接重启容器：

docker restart gitlab

6. 排查日志定位剩余问题 #

如果还是无法访问，查看容器内的NGINX错误日志，它会告诉你具体的故障原因：

docker exec -it gitlab tail -f /var/log/gitlab/nginx/error.log

常见错误包括：证书文件不存在、权限不足、容器内443端口被其他进程占用等。

内容的提问来源于stack exchange，提问作者Moe