minrk/jupyterhub-onbuild

JupyterHub onbuild镜像

镜像概述

JupyterHub是Project Jupyter推出的多用户Hub服务，可生成、管理并代理多个单用户Jupyter notebook实例。该onbuild镜像为快速部署JupyterHub提供基础框架，需结合自定义配置文件使用，适用于教育课堂、企业数据科学团队、科研项目等多用户协作场景。

核心功能

1. 多用户管理：支持多用户登录与权限控制，通过Hub统一调度单用户notebook实例。
2. 组件协作：包含三大核心组件：
   • 多用户Hub（Tornado进程）：处理用户登录、实例生成与管理。
   • 可配置HTTP代理：转发请求至Hub或指定单用户服务器。
   • 单用户Jupyter notebook服务器：为每个用户提供独立的交互式计算环境。
3. REST API：提供标准化接口用于Hub及用户的自动化运维。

使用场景

• 教育场景：为学生班级提供统一的notebook学习环境，便于教师管理与协作。
• 企业团队：数据科学团队共享计算资源，实现协作分析与成果沉淀。
• 科研项目：研究人员共同使用实验环境，简化资源配置与数据共享流程。

配置说明

生成配置文件

通过以下命令生成包含默认设置与说明的配置文件：

bash
jupyterhub --generate-config

启动Hub服务

示例：在指定IP和端口启动HTTPS服务（需提前准备SSL证书）：

bash
jupyterhub --ip 10.0.1.2 --port 443 --ssl-key my_ssl.key --ssl-cert my_ssl.cert

认证器与Spawner

• 认证器：支持PAM（默认）、OAuth、LDAP、Kerberos等多种认证方式。
• Spawner：支持本地进程、Docker容器、Kubernetes、系统服务等实例启动方式。

Docker部署示例

基础测试启动

bash
docker run -p 8000:8000 -d --name jupyterhub docker.xuanyuan.run/minrk/jupyterhub-onbuild jupyterhub

生产级衍生镜像

创建包含自定义配置的Dockerfile：

dockerfile
FROM docker.xuanyuan.run/minrk/jupyterhub-onbuild
COPY jupyterhub_config.py /srv/jupyterhub/

构建并启动：

bash
docker build -t my-jupyterhub .
docker run -p 8000:8000 -d --name docker.xuanyuan.run/my-jupyterhub my-jupyterhub

数据持久化

挂载主机目录保存用户数据（避免容器销毁丢失）：

bash
docker run -p 8000:8000 -v /host/user_data:/home -d --name jupyterhub docker.xuanyuan.run/minrk/jupyterhub-onbuild jupyterhub