Jupyter Docker Stacks 容器运行指南：从入门到实践-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00231/article/details/148441044

Jupyter Docker Stacks 容器运行指南：从入门到实践

docker-stacks Ready-to-run Docker images containing Jupyter applications 项目地址: https://gitcode.com/gh_mirrors/do/docker-stacks

前言

Jupyter Docker Stacks 是一组精心设计的 Docker 镜像，为数据科学和机器学习工作提供了开箱即用的 Jupyter 环境。本文将深入讲解如何运行这些容器镜像，帮助开发者快速搭建自己的数据分析环境。

核心概念

在开始之前，我们需要明确两个关键选择：

选择基础镜像：根据需求选择包含不同工具栈的镜像（如基础 Python、R、Spark 等）
选择启动方式：决定如何运行 Docker 容器

Docker CLI 运行方式

Docker 命令行是最直接的运行方式，下面通过几个典型场景展示不同用法。

基础运行示例

docker run -it -p 8888:8888 quay.io/jupyter/scipy-notebook:2025-03-14

这个命令实现了：

自动拉取指定版本的镜像（如不存在本地）
启动 JupyterLab 服务
将容器 8888 端口映射到主机 8888 端口
在终端显示服务日志和访问 URL

操作提示：

按 Ctrl-C 两次可安全关闭服务
关闭后容器仍保留在磁盘上，可通过 docker ps -a 查看
使用 docker start 重新启动，或 docker rm 彻底删除

持久化存储示例

docker run -it --rm -p 10000:8888 -v "${PWD}":/home/jovyan/work quay.io/jupyter/r-notebook:2025-03-14

这个命令新增了：

--rm：容器停止后自动删除
-v：将当前目录挂载到容器的 work 目录
端口映射改为 10000:8888

重要说明：

只有挂载目录（work）中的修改会被保留
默认工作目录是 /home/jovyan，新文件会保存在这里
如需修改默认目录，需添加参数：start-notebook.py --ServerApp.root_dir=/home/jovyan/work

后台运行示例

docker run --detach -P --name notebook quay.io/jupyter/all-spark-notebook

特点：

--detach：后台运行
-P：随机分配主机端口
--name：指定容器名称

管理技巧：

使用 docker port notebook 8888 查看映射端口
使用 docker logs notebook 查看日志获取访问令牌
组合这些信息构建完整访问 URL

Podman 替代方案

Podman 是 Docker 的兼容替代品，特别适合无 root 权限环境。下面是一个安全配置示例：

uid=1000
gid=100
subuidSize=$(( $(podman info --format "{{ range .Host.IDMappings.UIDMap }}+{{.Size }}{{end }}" ) - 1 ))
subgidSize=$(( $(podman info --format "{{ range .Host.IDMappings.GIDMap }}+{{.Size }}{{end }}" ) - 1 ))

podman run -it --rm -p 10000:8888 \
    -v "${PWD}":/home/jovyan/work --user $uid:$gid \
    --uidmap $uid:0:1 --uidmap 0:1:$uid --uidmap $(($uid+1)):$(($uid+1)):$(($subuidSize-$uid)) \
    --gidmap $gid:0:1 --gidmap 0:1:$gid --gidmap $(($gid+1)):$(($gid+1)):$(($subgidSize-$gid)) \
    quay.io/jupyter/r-notebook:2025-03-14

安全建议：