配置本地Docker Registry时指定--hostname后无法访问容器，求排查

首先得澄清一个容易踩的误区：你用的--hostname docker-container-registry.local是设置容器内部的主机名，这个参数不会直接让外部通过该域名访问容器——外部访问容器靠的是宿主机的端口映射，和容器内部的hostname完全无关，这可能是你误解的第一个点。

接下来逐个排查可能的问题：

1. 先确认容器是否正常运行 #

先检查容器状态，执行：

docker ps

如果registry容器没在运行，立刻查看日志找错误根源：

docker logs registry

重点关注两类错误：

• TLS证书相关：比如domain.crt/domain.key是否存在于挂载的/certs目录、文件权限是否正确
• 认证配置相关：比如htpasswd文件格式是否合法、路径是否正确

2. 检查访问方式是否符合配置要求 #

你已经开启了TLS加密，所以访问仓库必须用https协议，绝对不能用http。正确的测试访问地址应该是：

https://docker-container-registry.local:5000/v2/

如果直接用http访问，registry会直接拒绝请求，这是很容易忽略的细节。

3. 验证hosts配置是否生效 #

在宿主机执行ping命令，确认域名解析正确：

ping docker-container-registry.local

如果返回的IP不是192.168.1.2，说明hosts配置没生效——Windows下修改hosts后需要刷新DNS缓存，执行：

ipconfig /flushdns

4. 排查端口映射和防火墙问题 #

• 确认宿主机的5000端口没被其他程序占用：

netstat -ano | findstr :5000

如果有其他进程占用，要么终止该进程，要么修改docker run的端口映射（比如改成-p 5001:5000）。

• 检查Windows防火墙是否允许5000端口的入站https流量，必要时临时关闭防火墙测试是否能访问。

5. 关于--hostname参数的说明 #

如果你的需求是让容器内部的服务识别自身主机名，这个参数没问题，但它完全不影响外部访问。外部访问容器只需要宿主机的IP/域名 + 映射的端口，所以这个参数在这里其实可以去掉，不会影响仓库的正常使用。

建议排查顺序：先确认容器正常启动，用宿主机IP+端口直接访问（比如https://192.168.1.2:5000/v2/），如果能访问再验证hosts和域名的问题；如果不能访问，优先看日志找具体错误。

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