tabll/jupyter

Jupyter Lab 容器镜像

镜像概述

这是一个预配置多种编程语言内核的Jupyter Lab容器镜像，支持中文界面，集成了Python、PHP和Go等编程语言环境，可直接用于数据分析、代码开发和学习场景，提供便捷的部署和自定义配置选项。

核心功能与特性

• 多语言支持：内置Python 3.10.6、PHP 8.1.17和Go 1.20.3编程语言内核
• 中文界面：支持中文显示，可在设置中手动切换
• 灵活持久化：支持工作目录和配置文件的数据卷挂载
• 自定义配置：可修改启动命令、环境变量和主机名
• 丰富插件：预装多种Jupyter Lab扩展插件，增强功能体验

使用场景

• 数据科学与数据分析工作
• 多语言编程学习和教学
• 快速搭建临时开发环境
• 团队共享的统一开发平台

使用方法

基本用法

使用默认配置启动容器并暴露8888端口：

sh
docker run -p 8888:8888 tabll/jupyter:2.6

自定义用法

数据持久化

将工作目录 /workspace 挂载为数据卷，实现数据持久化：

sh
docker run -p 8888:8888 -v /home/user/my-jupyter:/workspace tabll/jupyter:2.6

配置文件管理

生成并持久化配置文件：

1. 先在容器内生成配置文件：

   sh
   docker exec -it [容器ID] jupyter lab --generate-config
   

2. 配置文件将生成在 /root/.jupyter/jupyter_lab_config.py，可通过数据卷挂载持久化：

   sh
   docker run -p 8888:8888 -v /home/user/JupyterConf/jupyter_lab_config.py:/root/.jupyter/jupyter_lab_config.py tabll/jupyter:2.6
   

环境变量设置

• 指定默认Shell为bash：

  sh
  docker run -p 8888:8888 -e SHELL=/bin/bash tabll/jupyter:2.6
  

• 自定义主机名：

  sh
  docker run -p 8888:8888 -h "tabll-jupyterers-server" tabllll/jupyter:2.6
  

配置说明

中文界面设置

首次使用时需手动切换至中文：

1. 打开开Jupyter Lab界面
2. 点击 Settings -> Language
3. 选择中文语言选项

Nginx反向代理配置

若使用Nginx反向代理，需特殊配置以支持WebSocket连接（否则无法连接Kernel）：

nginx
location / {
    proxy_pass http://JupyterLab:8888; # 替换为实际Jupyter服务地址与端口
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    # WebSocket支持配置
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_set_header X-Scheme $scheme;
    proxy_buffering off;
}
location ~ /.well-known {
    allow all;
}

版本信息

核心组件版本

• Jupyter Lab: 3.6.3

编程语言版本

• Python: 3.10.6
• PHP: 8.1.17
• Go: 1.20.3

预装Jupyter插件

• jupyterlab-fasta
• jupyterlab-geojson
• jupyterlab-katex
• jupyterlab-mathjax3
• jupyterlab-vega2
• jupyterlab-vega3
• jupyterlab_latex
• jupyterlab-drawio