ucsb/scipy-base

Jupyter SciPy 基础镜像文档

镜像概述

本镜像为加州大学圣巴巴拉分校（University of California, Santa Barbara）数据科学课程设计，提供预配置的Jupyter环境及SciPy生态系统工具，旨在简化数据科学教学与学习过程中的环境搭建工作。

核心功能与特性

• 完整Jupyter环境：包含Jupyter Notebook和Jupyter Lab，支持交互式代码编写与运行
• SciPy生态工具集：集成NumPy、Pandas、Matplotlib、SciPy等数据科学核心库
• 课程优化配置：针对数据科学课程需求进行环境预配置，减少学生环境配置时间
• 轻量级设计：在保证功能完整的前提下优化镜像体积，提升部署效率

使用场景与适用范围

• 加州大学圣巴巴拉分校数据科学课程的学生实验环境
• 数据科学课程的教学演示与案例分享
• 数据科学入门学习者的基础开发环境

使用方法与配置说明

基本使用

拉取镜像

bash
docker pull docker.xuanyuan.run/[镜像仓库地址]/jupyter-scipy-ucsb

运行容器

bash
docker run -p 8888:8888 docker.xuanyuan.run/[镜像仓库地址]/jupyter-scipy-ucsb

运行后，终端将输出Jupyter访问链接，格式通常为：http://127.0.0.1:8888/?token=<随机token>，复制该链接在浏览器中打开即可使用。

高级配置

挂载本地目录

将本地数据或代码目录挂载到容器中，实现文件持久化：

bash
docker run -p 8888:8888 -v /本地目录路径:/home/jovyan/work docker.xuanyuan.run/[镜像仓库地址]/jupyter-scipy-ucsb

设置自定义密码

通过环境变量设置Jupyter访问密码：

bash
docker run -p 8888:8888 -e JUPYTER_PASSWORD=your_password docker.xuanyuan.run/[镜像仓库地址]/jupyter-scipy-ucsb

指定工作目录

bash
docker run -p 8888:8888 -w /home/jovyan/custom_workdir docker.xuanyuan.run/[镜像仓库地址]/jupyter-scipy-ucsb

Docker Compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  jupyter-scipy:
    image: docker.xuanyuan.run/[镜像仓库地址]/jupyter-scipy-ucsb
    ports:
      - "8888:8888"
    volumes:
      - ./notebooks:/home/jovyan/work
    environment:
      - JUPYTER_PASSWORD=course123
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

注意事项

• 确保本地端口8888未被占用，或通过-p [本地端口]:8888指定其他端口
• 挂载目录时需保证本地目录存在且有读写权限
• 课程特定配置可能需要结合课程指南进行额外设置