EC2实例中Docker容器无法通过公网IPv4访问的问题咨询

背景操作 #

• 创建EC2实例后，更新系统包并安装Docker与docker-compose
• 编写的docker-compose.yml文件：

version: '3.7'
volumes:
  shared-workspace:
    name: "hadoop-distributed-file-system"
    driver: local
services:
    jupyter:
        image: 'jupyter/datascience-notebook:latest'
        hostname: jupyterlab
        ports:
            - 4888:4888
        volumes:
          - shared-workspace:/opt/workspace
        container_name: jupyter
        environment:
        - JUPYTER_TOKEN=...

• 执行的终端命令：

sudo systemctl start docker
docker-compose up

• 容器日志输出片段：

...
jupyter  | [I 2023-10-12 14:04:31.021 ServerApp] Jupyter Server 2.7.3 is running at:
jupyter  | [I 2023-10-12 14:04:31.021 ServerApp] http://jupyterlab:8888/lab?token=...
jupyter  | [I 2023-10-12 14:04:31.021 ServerApp] http://127.0.0.1:8888/lab?token=...
...

用户疑问 #

为何Jupyter服务运行在http://127.0.0.1:8888/lab?token=..，而非我期望的EC2公网IPv4地址（http://ipv4_address:4888/lab?）？已将安全组设置为允许所有流量，问题出在哪里？

问题原因及解决办法 #

核心原因 #

1. 容器内Jupyter绑定地址限制：Jupyter默认仅绑定127.0.0.1，仅允许容器内部访问，即使Docker做了端口映射，外部也无法正常连接。日志里的127.0.0.1:8888是容器内部的服务地址，不是EC2实例的公网地址。
2. 端口映射不匹配：你将EC2的4888端口映射到了容器的4888端口，但Jupyter默认运行在容器内的8888端口，导致映射端口和实际服务端口错位。

解决步骤 #

步骤1：修正端口映射

修改docker-compose.yml的端口配置，将EC2的4888端口转发到容器内Jupyter实际运行的8888端口：

services:
    jupyter:
        # 其他配置保持不变
        ports:
            - 4888:8888

步骤2：配置Jupyter绑定所有地址

需要让Jupyter绑定容器的0.0.0.0地址（允许外部访问），有两种实现方式：

• 方式一：添加启动命令参数
  在services.jupyter下新增command字段：

services:
    jupyter:
        # 其他配置保持不变
        command: "jupyter lab --ip=0.0.0.0 --port=8888 --no-browser"

• 方式二：配置环境变量
  在environment里添加Jupyter的网络配置参数：

services:
    jupyter:
        # 其他配置保持不变
        environment:
        - JUPYTER_TOKEN=...
        - JUPYTER_SERVER_IP=0.0.0.0
        - JUPYTER_SERVER_PORT=8888

步骤3：重启容器

执行以下命令让配置生效：

docker-compose down
docker-compose up -d

完成以上操作后，即可通过http://<EC2公网IPv4地址>:4888/lab?token=<你的JUPYTER_TOKEN值>访问Jupyter Lab。

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