bdist/notebook

Jupyter Notebook Databases Stack 镜像文档

镜像概述和主要用途

bdist/notebook 是一个集成了科学Python生态系统流行包的Jupyter Notebook镜像，基于 jupyter/minimal-notebook 及其祖先镜像构建。该镜像特别优化了数据库相关开发场景，提供PostgreSQL多版本客户端工具和SQL集成能力，适用于数据科学、数据库查询分析及Python开发工作流。

核心功能和特性

• 基础环境：继承自 jupyter/minimal-notebook 及其所有祖先镜像的完整功能，包含Jupyter Notebook基础运行环境
• PostgreSQL客户端：内置PostgreSQL 12、13、14、15和16版本的客户端工具，支持多版本数据库连接与操作
• SQL集成：通过 jupysql 提供 %sql 和 %%sql 魔法命令，可在Jupyter/IPython环境中直接执行SQL查询
• 代码检查：集成 python-lsp-ruff 插件，基于ruff为pylsp提供代码 linting 功能，提升Python代码质量

使用场景和适用范围

• 数据科学与数据分析工作流，需结合SQL查询的数据处理场景
• PostgreSQL数据库开发、查询与分析任务
• Jupyter环境中的SQL教学与学习
• 需要代码质量检查的Python开发环境

使用方法和配置说明

基本启动（docker run）

通过以下命令启动容器，默认映射8888端口：

bash
docker run -p 8888:8888 bdist/notebook

启动后，终端将输出包含访问链接的日志，格式通常为：
http://127.0.0.1:8888/?token=<generated-token>
复制链接在浏览器中打开即可访问Jupyter Notebook界面。

持久化存储配置

为避免容器重启后数据丢失，可挂载本地目录到容器工作目录：

bash
docker run -p 8888:8888 -v /本地路径:/home/jovyan/work bdist/notebook

其中 /本地路径 替换为本地实际目录，/home/jovyan/work 为容器内默认工作目录。

安全配置（设置访问令牌）

通过环境变量 JUPYTER_TOKEN 设置自定义访问令牌：

bash
docker run -p 8888:8888 -e JUPYTER_TOKEN="your_secure_token" bdist/notebook

docker-compose配置示例

创建 docker-compose.yml 文件：

yaml
version: '3'
services:
  jupyter-notebook:
    image: bdist/notebook
    ports:
      - "8888:8888"
    volumes:
      - ./notebooks:/home/jovyan/work  # 本地notebooks目录挂载到容器
    environment:
      - JUPYTER_TOKEN=my_secure_token  # 自定义访问令牌
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

相关链接

• https://github.com/bdist/notebook
• https://github.com/bdist/notebook/commits/main/notebook/Dockerfile
• https://hub.docker.com/r/bdist/notebook/tags/

credits

Flavio Martins