Docker Compose配置Jupyter Lab环境变量失败问题求助

问题原因 #

你在docker-compose.yml的command字段中使用了${JUPYTER_TOKEN}，Docker Compose会优先尝试从主机系统的环境变量中读取这个值，而不是容器内部定义的环境变量。因为主机上没有设置这个变量，所以会触发警告并默认设为空字符串。

解决方案 #

方案1：转义美元符号 #

将command中的${JUPYTER_TOKEN}改为$$JUPYTER_TOKEN，这样Docker Compose会把$JUPYTER_TOKEN原封不动传递给容器内的bash，让bash读取容器内部的环境变量：

version: '3'
services:
  ubuntu_anaconda:
    image: continuumio/anaconda3:latest
    container_name: ubuntu_anaconda
    environment:
      - LANG=C.UTF-8
      - JUPYTER_TOKEN=my_secret_token  # Set your desired token here
    ports:
      - "8888:8888"  # Expose Jupyter Lab port
    volumes:
      - ./data:/data  # Add this line if you want to mount a local directory to the container
    command: /bin/bash -c "/opt/conda/bin/conda install -y -c conda-forge pystan && /opt/conda/bin/jupyter lab --ip=0.0.0.0 --port=8888 --allow-root --NotebookApp.token=$$JUPYTER_TOKEN"

方案2：利用Jupyter的环境变量自动读取 #

Jupyter Lab本身支持直接从环境变量JUPYTER_TOKEN获取token，不需要在启动命令中显式指定。可以简化command字段：

version: '3'
services:
  ubuntu_anaconda:
    image: continuumio/anaconda3:latest
    container_name: ubuntu_anaconda
    environment:
      - LANG=C.UTF-8
      - JUPYTER_TOKEN=my_secret_token  # Set your desired token here
    ports:
      - "8888:8888"  # Expose Jupyter Lab port
    volumes:
      - ./data:/data  # Add this line if you want to mount a local directory to the container
    command: /bin/bash -c "/opt/conda/bin/conda install -y -c conda-forge pystan && /opt/conda/bin/jupyter lab --ip=0.0.0.0 --port=8888 --allow-root"

优化建议：提前构建镜像（推荐给学生使用） #

每次启动容器都执行conda install会浪费时间，建议创建Dockerfile预先安装PyStan，再用Docker Compose构建镜像：

Dockerfile内容

FROM continuumio/anaconda3:latest
ENV LANG=C.UTF-8
ENV JUPYTER_TOKEN=my_secret_token
RUN /opt/conda/bin/conda install -y -c conda-forge pystan
CMD ["/opt/conda/bin/jupyter", "lab", "--ip=0.0.0.0", "--port=8888", "--allow-root"]

修改后的docker-compose.yml

version: '3'
services:
  ubuntu_anaconda:
    build: .
    container_name: ubuntu_anaconda
    ports:
      - "8888:8888"
    volumes:
      - ./data:/data

学生只需要执行sudo docker compose up --build（第一次构建后后续启动不需要--build），就能直接启动带PyStan的Jupyter Lab，无需重复安装。

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