如何允许Docker容器通过localhost互访并支持自定义本地域名访问

解决方案 #

问题根因 #

你本地/etc/hosts将example.test指向127.0.0.1的配置是正确的，访问不通的核心原因是容器内部的服务端口没有映射到宿主机的127.0.0.1端口，请求到达宿主机后没有对应服务响应。无需使用Docker私有IP访问，该IP仅宿主机内部可见、重启容器会变更，也不匹配OIDC重定向URI的域名要求。

操作步骤 #

• 启动容器时配置端口映射
  假设你的容器内部服务运行在80（HTTP）、443（HTTPS）端口，启动命令添加端口映射参数，将容器端口绑定到宿主机127.0.0.1的对应端口：

  docker run -d -p 127.0.0.1:80:80 -p 127.0.0.1:443:443 <你的镜像名称>
  

  绑定127.0.0.1而非0.0.0.0可以避免公网访问到你的本地测试服务，安全性更高。
  如果使用docker-compose管理容器，对应配置示例：

  services:
    your-oidc-service:
      image: <你的镜像名称>
      ports:
        - "127.0.0.1:80:80"
        - "127.0.0.1:443:443"
  

• 排查端口冲突
  如果启动容器时报端口占用错误，执行以下命令查看占用对应端口的进程：

  # 查看80端口占用情况
  sudo lsof -i :80
  # 或
  sudo netstat -tulpn | grep :80
  

  要么终止占用端口的进程，要么修改宿主机侧映射端口，例如将宿主机80端口换成8080：

  docker run -d -p 127.0.0.1:8080:80 <你的镜像名称>
  

  换端口后访问地址为http://example.test:8080，如果OIDC要求必须使用80/443默认端口，则只能终止冲突进程。
• 验证服务可用性
  先进入容器内部执行curl 127.0.0.1，确认容器内部服务可以正常响应，排除服务本身启动失败的问题。
• HTTPS配置（可选）
  如果你的OIDC服务要求必须使用HTTPS访问，需要在容器内部的服务或反向代理中配置example.test对应的SSL证书，本地测试可以使用mkcert生成系统信任的自签证书，避免浏览器报安全错误。

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