Docker容器未注册IP：自定义Jupyter镜像端口映射异常排查求助

问题原因 #

• Jupyter服务监听地址配置错误
  官方镜像默认将Jupyter监听地址设为0.0.0.0允许所有IP访问，如果自定义镜像中启动Jupyter时未指定--ip=0.0.0.0参数，服务默认只会监听容器内的127.0.0.1，外部宿主机的请求无法到达容器内服务。
• 容器内服务端口与映射端口不匹配
  如果自定义镜像中修改了Jupyter的默认启动端口（比如改为8080），但启动容器时仍按照默认规则映射8888:8888，会导致请求映射到容器内未启用的端口，无法访问。
• Jupyter服务未正常启动
  Dockerfile的CMD/ENTRYPOINT配置错误，或者Jupyter启动参数有误，可能导致容器存活但Jupyter服务实际未正常运行，自然无法响应请求。
• 容器内部网络拦截
  部分自定义的基础镜像默认开启了内部防火墙规则，拦截了8888端口的入站请求，哪怕服务启动正常也无法收到外部请求。

排查解决思路 #

• 校验容器内服务运行状态
  执行docker ps确认容器处于运行状态后，通过docker exec -it <容器ID> bash进入容器内部，执行ss -tulnp | grep jupyter查看Jupyter的监听地址和端口，确认监听地址为0.0.0.0且端口为预期的8888。
• 修正Jupyter启动参数
  如果确认是监听地址问题，修改Dockerfile中的启动命令，补充--ip=0.0.0.0等必要参数，参考配置：jupyter notebook --ip=0.0.0.0 --port=8888 --allow-root，重新构建镜像后再运行测试。
• 核对端口映射规则
  如果自定义了Jupyter启动端口，启动容器时同步修改端口映射配置，比如容器内服务运行在8080时，使用-p 8888:8080做端口映射。
• 查看容器运行日志
  执行docker logs <容器ID>查看Jupyter启动日志，排查是否有权限不足、参数错误、依赖缺失等启动报错，对应修复后重新构建镜像。
• 统一基础镜像配置
  如果是基础镜像的网络规则导致的拦截，建议直接使用官方minimal notebook镜像作为基础镜像进行自定义构建，避免基础镜像的额外限制。

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