seeq13/datalab-jupyter

Seeq配置版Jupyter Notebook镜像文档

镜像概述和主要用途

本镜像基于官方Jupyter Notebook构建，是预配置Seeq环境的专用版本。它集成了Seeq Python API及相关依赖组件，旨在为工业数据分析场景提供开箱即用的开发环境。用户无需手动配置Seeq连接环境，可直接在Jupyter Notebook中访问Seeq数据，进行数据处理、分析、建模及可视化，大幅提升工业数据科学工作流效率。

核心功能和特性

• Seeq环境预配置：内置Seeq Python API及依赖库，无需手动安装配置即可连接Seeq服务器
• 基础功能稳定：基于官方Jupyter Notebook镜像构建，继承其全部标准功能（代码执行、Markdown编辑、单元格管理等）
• 数据分析工具集成：预装pandas、numpy、matplotlib、seaborn等常用数据分析与可视化库
• 简化数据访问：优化Seeq数据查询流程，通过API快速获取Seeq中的信号、资产、工作簿等数据
• 兼容性保障：与主流Seeq服务器版本兼容，确保数据交互稳定性

使用场景和适用范围

• 工业数据科学家：进行工业过程数据探索、特征工程及模型开发
• 制造工程师：分析生产数据、优化工艺参数、排查设备异常
• 研究团队：协作编写包含Seeq数据的分析报告或技术文档
• IIoT项目：处理工业物联网设备采集的数据，结合Seeq进行趋势分析
• 培训与教学：在教育场景中演示工业数据分析流程，降低环境配置门槛

使用方法和配置说明

前提条件

• 已安装Docker Engine（推荐版本20.10+）
• 可访问Seeq服务器（需知道服务器URL及访问权限）
• （可选）Seeq API密钥（用于非交互式认证）

镜像拉取

bash
docker pull docker.xuanyuan.run/seeq/jupyter-notebook:latest

注：实际镜像名称可能需根据官方仓库调整，请以Seeq官方文档为准

基本运行命令

bash
docker run -d \
  -p 8888:8888 \
  -e SEEQ_SERVER_URL="https://your-seeq-server.example.com" \
  -e JUPYTER_TOKEN="your-secure-token" \
  --name seeq-jupyter \
  docker.xuanyuan.run/seeq/jupyter-notebook:latest

参数说明：

• -p 8888:8888：映射容器内Jupyter服务端口到主机
• -e SEEQ_SERVER_URL：指定Seeq服务器URL（必填）
• -e JUPYTER_TOKEN：设置Jupyter访问令牌（建议使用强密码）
• --name seeq-jupyter：指定容器名称，方便后续管理

挂载数据卷（持久化工作目录）

为避免容器重启后数据丢失，建议挂载本地目录作为工作空间：

bash
docker run -d \
  -p 8888:8888 \
  -e SEEQ_SERVER_URL="https://your-seeq-server.example.com" \
  -e JUPYTER_TOKEN="your-secure-token" \
  -v /local/workspace:/home/jovyan/work \
  --name seeq-jupyter \
  docker.xuanyuan.run/seeq/jupyter-notebook:latest

其中/local/workspace为本地目录路径，需替换为实际路径

连接Seeq服务器示例

启动容器后，通过浏览器访问http://localhost:8888，输入JUPYTER_TOKEN登录。新建Notebook后，可通过以下代码连接Seeq服务器：

python
import seeq

# 使用环境变量中配置的服务器URL连接
spy = seeq.spy.Spy(seeq_server_url=os.environ.get('SEEQ_SERVER_URL'))

# 验证连接
print(f"Connected to Seeq server: {spy.server_url}")
print(f"User: {spy.username}")

环境变量配置

高级配置：docker-compose示例

创建docker-compose.yml文件：

yaml
version: '3.8'
services:
  seeq-jupyter:
    image: docker.xuanyuan.run/seeq/jupyter-notebook:latest
    container_name: seeq-jupyter
    ports:
      - "8888:8888"
    environment:
      - SEEQ_SERVER_URL=https://your-seeq-server.example.com
      - JUPYTER_TOKEN=your-secure-token
      - SEEQ_API_KEY=your-seeq-api-key  # 可选
    volumes:
      - ./workspace:/home/jovyan/work
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

注意事项

1. 确保SEEQ_SERVER_URL格式正确（需包含协议头，如https://）
2. JUPYTER_TOKEN建议使用复杂字符串，避免弱密码风险
3. 本地挂载目录需确保Docker用户有读写权限（可通过chmod 777 /local/workspace临时测试）
4. 如使用公司内网Seeq服务器，需确保Docker容器网络可访问目标服务器
5. 镜像定期更新，建议通过docker pull获取最新版本以获得功能更新和安全补丁