统信UOS系统中部署JupyterLab有四种方法:一、apt+pip全局安装(x86_64推荐);二、venv虚拟环境安装(项目隔离首选);三、Docker容器部署(ARM64平台适用);四、配置默认工作目录与中文支持;五、启动验证功能完整性。

如果您在统信UOS系统中希望开展Python数据分析工作,但尚未部署交互式开发环境,则需先完成JupyterLab的本地安装与基础配置。以下是适用于UOS 20(Linux 4.19内核,含ARM64及x86_64架构)的多种可行安装路径:
一、使用系统包管理器安装(推荐适用于x86_64桌面版)
该方法依赖UOS官方源或Debian兼容源,安装过程简洁、依赖自动解析,适合网络通畅且无需定制Python版本的用户。
1、更新系统软件包索引:
sudo apt update
2、安装Python 3开发环境及pip:
sudo apt install python3 python3-pip python3-venv
3、升级pip至最新稳定版:
python3 -m pip install --upgrade pip
4、全局安装JupyterLab(不建议生产环境长期使用全局安装):
pip3 install jupyterlab -i https://pypi.tuna.tsinghua.edu.cn/simple
5、验证安装是否成功:
jupyter lab --version
若返回类似4.0.12的版本号,说明核心组件已就绪。
二、基于venv虚拟环境安装(推荐用于项目隔离与多版本共存)
该方式可避免系统级Python包污染,便于后续切换不同Python版本或依赖组合,特别适合数据分析项目独立维护。
1、创建专用虚拟环境目录:
mkdir -p ~/jupyter-envs
2、在该目录下新建名为jupyter-uos的虚拟环境:
python3 -m venv ~/jupyter-envs/jupyter-uos
3、激活虚拟环境:
source ~/jupyter-envs/jupyter-uos/bin/activate
4、在激活状态下升级pip并安装JupyterLab:
pip install --upgrade pip && pip install jupyterlab jupyterlab-language-pack-zh-CN -i https://pypi.tuna.tsinghua.edu.cn/simple
5、退出虚拟环境(如需):
deactivate
下次使用时,仍需执行source ~/jupyter-envs/jupyter-uos/bin/activate再启动。
三、通过Docker容器部署(推荐用于ARM64平台如FT-2000处理器)
针对UOS 20 ARM64设备(如飞腾平台),因部分PyPI二进制轮子缺失或编译失败,直接pip安装常遇阻。Docker可封装完整运行时,规避底层架构适配问题。
1、确认系统已安装Docker(若未安装,请先完成Docker CE for Debian Bullseye ARM64的离线deb包部署):
docker version --format '{{.Server.Version}}'
2、拉取已构建好的ARM64兼容镜像(示例为清华源镜像):
docker pull registry.tuna.tsinghua.edu.cn/jupyter/scipy-notebook:latest
3、运行容器并映射本地目录与端口:
docker run -d -p 8888:8888 -v "$HOME/jupyter-work:/home/jovyan/work" -e JUPYTER_TOKEN="uos2026" --name jupyter-arm64 jupyter/scipy-notebook:latest
4、获取容器内Token并访问:
docker logs jupyter-arm64 2>&1 | grep "token="
浏览器访问http://localhost:8888?token=xxx即可进入中文界面。
四、配置JupyterLab默认工作目录与中文支持
无论采用上述哪种安装方式,首次启动前均建议生成并修改配置文件,以固定项目根路径并启用简体中文界面。
1、生成默认配置文件:
jupyter lab --generate-config
2、编辑配置文件:
vim ~/.jupyter/jupyter_lab_config.py
3、在文件中取消注释并设置以下两行:
c.ServerApp.root_dir = '/home/user/jupyter-projects'
c.LabApp.language = 'zh-CN'
4、保存退出后,创建对应目录:
mkdir -p /home/user/jupyter-projects
后续每次执行jupyter lab,都将自动加载该路径下的文件,并显示中文菜单与提示。
五、启动JupyterLab并验证功能完整性
完成任一安装路径及配置后,需启动服务并测试核心功能是否正常响应,包括内核连接、代码执行、Markdown渲染与文件浏览器可用性。
1、在终端中输入启动命令(如使用虚拟环境,请确保已激活):
jupyter lab --port=8888 --no-browser --ip=127.0.0.1
2、终端将输出类似如下地址行:
[I 22:15:03.123 LabApp] http://127.0.0.1:8888/lab?token=abc123def456
3、复制该URL,在UOS系统默认浏览器中粘贴访问;若页面加载成功且左上角显示JupyterLab标识,即表示环境已就绪。
4、新建Python 3笔记本,输入print("Hello UOS")并执行,观察右下角内核状态是否为Connected,输出区域是否显示结果。

















