JupyterLab 使用方法

JupyterLab 是基于 Web 的交互式开发环境，适合编写和运行代码、查看数据、记录分析过程和管理项目。平台用户通常先通过 Slurm 申请计算资源，再在分配到的计算节点上启动 JupyterLab。

如果需要长时间占用计算资源，建议先阅读 salloc 交互式资源申请。

使用流程

1. 在登录节点使用 salloc 申请计算资源。
2. 根据 salloc 返回的节点名，SSH 登录到计算节点。
3. 激活包含 JupyterLab 的软件环境。
4. 在计算节点上启动 JupyterLab。
5. 复制终端输出的访问地址，在浏览器中打开。

申请并登录计算节点

示例：

salloc -N 1 --cpus-per-task=8 --mem=16G -t 02:00:00 -p qcpu_18i

分配成功后登录提示中的节点：

ssh bnode1

启动 JupyterLab

首先激活包含 JupyterLab 的环境。环境名称请以实际配置为准：

conda activate jupyterlab

在计算节点上启动 JupyterLab：

jupyter lab --no-browser --ip=0.0.0.0 --port=8888

常用参数：

参数	说明
--port=<端口>	指定 JupyterLab 端口，默认常见为 8888
--no-browser	启动时不自动打开浏览器，远程服务器上建议加上
--ip=0.0.0.0	允许通过节点地址访问 JupyterLab
--notebook-dir=<目录>	指定 JupyterLab 启动后的工作目录

指定工作目录示例：

jupyter lab --no-browser --ip=0.0.0.0 --port=8888 --notebook-dir=/hpcfs/fhome/用户名

浏览器访问

启动成功后，终端会输出带 token 的访问地址，形式类似：

http://bnode1.tibhpc.net:8888/lab?token=xxxxxxxx

复制该地址到浏览器访问即可。

提示

如果浏览器无法打开节点地址，请先确认当前网络是否可访问计算节点，以及端口是否被本地或网络策略拦截。

后台运行

如需后台运行并记录日志：

nohup jupyter lab --no-browser --ip=0.0.0.0 --port=8888 > jupyter_lab.log 2>&1 &

查看日志：

tail -f jupyter_lab.log

结束使用

使用完成后，建议按顺序清理：

1. 在 JupyterLab 页面关闭正在运行的 kernel。
2. 回到终端按 Ctrl+C 停止 JupyterLab。
3. 退出计算节点。
4. 结束 salloc 会话，或使用 scancel 作业ID 释放资源。