automaatio/jupyterlab

镜像概述

本镜像基于Python 3.12.4（Debian 12 Bookworm）构建，通过PIP安装Jupyter、JupyterLab、Jupyter Scheduler及常用数据科学模块，集成jupyterlab-horizon-theme主题（默认蓝色高亮），提供开箱即用的数据分析环境。

核心功能

1. 预装JupyterLab及调度器，支持任务自动化调度；
2. 集成Horizon主题，优化界面视觉体验；
3. 包含Pandas（数据处理）、BeautifulSoup4（网页解析）、Requests（网络请求）等常用库；
4. 支持SQLAlchemy、PyMySQL等数据库操作工具；
5. 内置Nano编辑器和Cron服务，方便容器内文件编辑与定时任务配置。

使用场景

• 数据科学分析与可视化；
• Python代码开发与调试；
• JupyterLab学习与教学；
• 快速搭建轻量级数据分析环境。

配置说明

Dockerfile

################################################################
### Base Image
################################################################

# Install Python 3.12.4 based on 
# Debian 12 Bookworm
FROM docker.xuanyuan.run/python:3.12.4-bookworm


################################################################
### Packages
################################################################

# Working directory `/tmp`
WORKDIR /tmp

# Copy `requirements.txt` into image
COPY requirements.txt ./

# Run package updates
RUN apt update && apt install -y

# Install `Nano` & `Cron`
RUN apt install nano -y

# Upgrade PIP
RUN pip install --upgrade pip

# Install packages from `requirements.txt`
RUN pip install -r requirements.txt

# Clean up `requirements.txt` file
RUN rm requirements.txt


################################################################
###  JupyterLab
################################################################

# Working directory to `/home/jovyan`
WORKDIR /home/jovyan

# Expose port 8888
EXPOSE 8888

# Entrypoint for container
ENTRYPOINT ["jupyter", "lab", "--ip=0.0.0.0", "--allow-root"]

Requirements

################################################
# JupyterLab
################################################

jupyter_scheduler
jupyter==1.0.0
jupyterlab==4.2.3


################################################
# JupyterLab Theme
################################################

jupyterlab-horizon-theme==4.0.1    # Blue highlights
# jupyterlab-horizon-theme==4.0.2  # Pink highlights


################################################
# Python Packages
################################################

sqlalchemy
pymysql
mutagen
pydub
beautifulsoup4
requests
pandas
html5lib
lxml
humanize

Docker Compose示例

# Docker-Compose Version
version: "3.8"

################################################
# Services
################################################

services:

  ################################################
  # JupyterLab
  ################################################

  jupyterlab:
    image: "docker.xuanyuan.run/automaatio/jupyterlab:4.2.3"
    container_name: "jupyterlab"
    restart: "unless-stopped"
    environment:
      TZ: ${TZ}
    ports:
      - "8888:8888"
    volumes:
      - "/home/docker/jupyterlab/notebooks:/home/jovyan:rw"     # Where notebooks are stored
      - "/home/docker/jupyterlab/config:/root/.jupyter:rw"      # Jupyterlab configurations

安装步骤

1. 运行容器后，查看日志获取访问令牌：

To access the server, open this file in a browser: file:///home/jovyan/.local/share/jupyter/runtime/jpserver-7-open.html Or copy and paste one of these URLs: http://902u3489u:8888/lab?token=598aea54f916n89wnio10949XXXX78496fd07b557179422 or http://127.0.0.1:8888/lab?token=598aea54f916n89wnio10949XXXX78496fd07b557179422

2. 复制令牌，访问`http://<本地地址>:8888`，粘贴令牌完成登录即可使用。