xcai/jupyter-datascience-notebook

Jupyter Data Science Notebook 镜像文档

镜像概述

本镜像基于Jupyter Data Science Notebook构建，额外集成了nbextensions扩展、JupyterLab界面及JupyterHub多用户管理功能，为数据科学工作者提供一站式开发环境，支持交互式编程、数据分析、可视化及团队协作。

核心功能与特性

• Jupyter Data Science Notebook：基础交互式笔记本环境，支持Python等多种编程语言，内置常用数据科学库（如NumPy、Pandas、Matplotlib等）。
• nbextensions：提供丰富的笔记本扩展功能，如代码自动补全、目录生成、代码格式化等，提升开发效率。
• JupyterLab：现代化集成开发界面，支持多文档标签页、终端、文件浏览器等，提供更强大的项目管理能力。
• JupyterHub：多用户管理系统，支持用户身份认证、资源隔离，适合团队协作或教学场景下的多用户环境部署。

使用场景与适用范围

• 个人数据科学项目开发与实验
• 团队协作的数据分析与模型开发
• 教学环境中的交互式编程教学
• 需要多用户隔离的数据分析平台搭建

使用方法与配置说明

基本运行命令

bash
docker run -d -p 8000:8000 -v $(pwd):/home/jovyan/work --name jupyter-ds-notebook <镜像名称>

• -p 8000:8000：映射容器8000端口到主机，用于访问JupyterHub
• -v $(pwd):/home/jovyan/work：挂载本地目录到容器工作目录，实现数据持久化
• --name jupyter-ds-notebook：指定容器名称

访问服务

1. 启动容器后，通过浏览器访问 http://localhost:8000
2. 首次访问需输入JupyterHub默认管理员密码（可通过环境变量配置）
3. 登录后可选择使用Jupyter Notebook或JupyterLab界面

环境变量配置

自定义配置示例（docker-compose.yml）

yaml
version: '3'
services:
  jupyter:
    image: <镜像名称>
    ports:
      - "8000:8000"
    volumes:
      - ./workspace:/home/jovyan/work
      - ./jupyterhub_config.py:/etc/jupyterhub/jupyterhub_config.py
    environment:
      - JUPYTERHUB_ADMIN=user1,user2
      - JUPYTERHUB_PASSWORD=securepassword
    restart: always

扩展功能启用

nbextensions扩展可通过Jupyter Notebook界面的"Nbextensions"标签页进行启用和配置，常用扩展包括：

• Table of Contents (2)：生成笔记本目录
• Hinterland：代码自动补全
• Codefolding：代码折叠功能
• ExecuteTime：显示单元格执行时间