jupyter/nature-base

jupyter/nature-demo 基础镜像文档

镜像概述和主要用途

作为jupyter/nature-demo项目的基础镜像，该镜像提供了运行自然科学领域Jupyter演示应用所需的核心环境和依赖组件。它基于官方Jupyter基础镜像构建，集成了Jupyter Notebook/Lab运行环境及科学计算基础库，旨在简化自然科学相关交互式演示项目的搭建和部署流程。

核心功能和特性

• 基础环境支持：基于官方Jupyter镜像构建，确保与Jupyter生态工具链的兼容性和稳定性
• 科学计算库集成：预装NumPy、SciPy、Pandas、Matplotlib等基础科学计算与可视化库
• 演示依赖管理：包含nature-demo项目运行所需的特定依赖包和配置文件
• 环境隔离：通过容器化方式提供独立运行环境，避免系统依赖冲突
• 可扩展性：支持通过Dockerfile或容器命令扩展自定义依赖和配置

使用场景和适用范围

• 教育教学：教师构建物理、化学、生物学等自然科学领域的交互式教学演示
• 科研展示：科研人员展示自然科学研究成果的交互式演示项目
• 技术交流：开发者在学术会议或技术研讨中演示自然科学相关Jupyter应用
• 学习实践：学生或自学者搭建自然科学计算与可视化的练习环境

详细使用方法和配置说明

基本运行方式

通过以下命令启动基础镜像容器：

bash
docker run -p 8888:8888 jupyter/nature-demo

容器启动后，终端将输出包含访问令牌（token）的Jupyter访问链接，通过浏览器访问 http://localhost:8888 并输入令牌即可进入Jupyter界面。

挂载本地项目目录

如需将本地项目文件挂载到容器中进行开发或演示，可使用 -v 参数指定挂载目录：

bash
docker run -p 8888:8888 -v /本地项目路径:/home/jovyan/work jupyter/nature-demo

其中 /home/jovyan/work 为容器内的默认工作目录。

自定义配置参数

环境变量配置

支持通过 -e 参数设置以下常用环境变量：

• JUPYTER_TOKEN：自定义Jupyter访问令牌（默认随机生成）
• JUPYTER_PORT：修改容器内Jupyter服务端口（默认8888）
• NB_UID/NB_GID：指定运行用户ID和组ID（解决文件权限问题）

示例（设置自定义访问令牌）：

bash
docker run -p 8888:8888 -e JUPYTER_TOKEN="nature2024" jupyter/nature-demo

Docker Compose配置

创建 docker-compose.yml 文件进行多容器管理或复杂配置：

yaml
version: '3'
services:
  nature-demo:
    image: jupyter/nature-demo
    ports:
      - "8888:8888"
    volumes:
      - ./demo-project:/home/jovyan/work
    environment:
      - JUPYTER_TOKEN=demo_token_123
      - NB_UID=1000
      - NB_GID=1000
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

自定义扩展方法

如需添加项目特定依赖，可基于此镜像构建自定义镜像：

dockerfile
FROM jupyter/nature-demo
# 安装额外依赖包
RUN pip install --no-cache-dir custom-science-package
# 添加自定义配置
COPY ./custom-config /home/jovyan/.jupyter/

注意事项

• 镜像详细配置和最新更新请参考官方文档：https://hub.docker.com/r/jupyter/nature-demo/
• 生产环境使用时建议设置持久化存储卷（volume）保存重要数据
• 高并发场景下可结合Nginx等反向代理工具实现负载均衡