bgameiro/arch-jupyterlab

JupyterLab

镜像概述

本Docker镜像用于构建JupyterLab应用，可基于https://github.com/BGameiro2000/unraid-ca/tree/master/jupyterlab%E5%9C%A8Unraid%E7%B3%BB%E7%BB%9F%E4%B8%AD%E9%83%A8%E7%BD%B2%E3%80%82JupyterLab%E6%98%AF%E4%B8%80%E6%AC%BE%E5%9F%BA%E4%BA%8EWeb%E7%9A%84%E4%BA%A4%E4%BA%92%E5%BC%8F%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83%EF%BC%8C%E4%B8%93%E4%B8%BAJupyter%E7%AC%94%E8%AE%B0%E6%9C%AC%E3%80%81%E4%BB%A3%E7%A0%81%E5%8F%8A%E6%95%B0%E6%8D%AE%E5%A4%84%E7%90%86%E8%AE%BE%E8%AE%A1%EF%BC%8C%E6%8F%90%E4%BE%9B%E7%BB%9F%E4%B8%80%E7%9A%84%E7%95%8C%E9%9D%A2%E5%92%8C%E4%B8%B0%E5%AF%8C%E7%9A%84%E5%8A%9F%E8%83%BD%EF%BC%8C%E6%BB%A1%E8%B6%B3%E5%BC%80%E5%8F%91%E3%80%81%E5%88%86%E6%9E%90%E5%92%8C%E5%8D%8F%E4%BD%9C%E9%9C%80%E6%B1%82%E3%80%82

核心功能与特性

• Web交互式界面：通过浏览器访问，无需本地安装，支持跨平台使用
• 多格式支持：兼容Jupyter笔记本（.ipynb）、代码文件（.py、.R等）、文本文件及数据文件
• 集成化工具：内置代码编辑器、终端、文件浏览器和数据可视化工具
• 可扩展性：支持安装扩展插件，扩展功能如Git集成、LaTeX编辑等
• 灵活配置：可通过环境变量和挂载卷自定义运行参数和数据存储

使用场景与适用范围

• 数据科学与分析：用于数据清洗、建模、可视化及结果展示
• 机器学习开发：支持Python、R等语言的模型训练与实验
• 教育与教学：作为编程和数据科学课程的教学工具，便于演示和实践
• 科研工作：记录实验过程、编写可复现的研究文档
• 团队协作：共享笔记本和代码，支持多人实时协作（需配合共享存储）

使用方法与配置说明

基本运行命令

通过以下命令快速启动JupyterLab容器：

bash
docker run -d \
  --name jupyterlab \
  -p 8888:8888 \
  -v /path/to/local/data:/home/jovyan/work \
  bgameiro2000/jupyterlab

参数说明：

• -d：后台运行容器
• --name jupyterlab：指定容器名称
• -p 8888:8888：映射容器8888端口到主机8888端口（JupyterLab默认端口）
• -v /path/to/local/data:/home/jovyan/work：挂载本地目录到容器工作目录，持久化数据

访问JupyterLab

1. 启动容器后，查看容器日志获取访问链接：

   bash
   docker logs jupyterlab
   

2. 在日志中找到类似以下内容的访问链接：

   http://127.0.0.1:8888/lab?token=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
   

3. 复制链接到浏览器，即可访问JupyterLab界面

自定义配置

设置访问密码

通过环境变量JUPYTER_PASSWORD设置访问密码（需先安装jupyterlab-password扩展）：

bash
docker run -d \
  --name jupyterlab \
  -p 8888:8888 \
  -v /path/to/local/data:/home/jovyan/work \
  -e JUPYTER_PASSWORD=your_secure_password \
  bgameiro2000/jupyterlab

安装额外依赖

如需安装Python包，可在启动时挂载requirements.txt并执行安装：

bash
docker run -d \
  --name jupyterlab \
  -p 8888:8888 \
  -v /path/to/local/data:/home/jovyan/work \
  -v /path/to/requirements.txt:/home/jovyan/requirements.txt \
  bgameiro2000/jupyterlab \
  bash -c "pip install -r /home/jovyan/requirements.txt && jupyter lab"

Docker Compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  jupyterlab:
    image: bgameiro2000/jupyterlab
    container_name: jupyterlab
    ports:
      - "8888:8888"
    volumes:
      - ./data:/home/jovyan/work
      - ./requirements.txt:/home/jovyan/requirements.txt
    environment:
      - JUPYTER_PASSWORD=your_secure_password
    command: bash -c "pip install -r /home/jovyan/requirements.txt && jupyter lab"
    restart: unless-stopped

启动服务：

bash
docker-compose up -d