智川云
智川云RIVERMIND

主题

JupyterLab ​

概述 ​

JupyterLab 是智川云容器实例内置的交互式开发环境，支持 Notebook、终端、文件管理等功能。

注意

JupyterLab 的工作目录为 /root 目录，而非 / 系统根目录。如需查看根目录，可进入终端使用命令行操作。

访问方式 ​

通过控制台 → 实例列表 → 快捷工具 → JupyterLab 进入。

进入 JupyterLab

界面说明 ​

JupyterLab 界面主要包含文件浏览器、编辑区和终端等功能区域。

JupyterLab 界面

主要功能 ​

上传文件 ​

点击左上角的上传按钮，选择本地文件即可上传到当前目录。

上传文件

提示

JupyterLab 仅支持单文件上传。如需上传文件夹或大文件，请使用 SCP/rsync 方式。

使用 Notebook ​

在 Launcher 中点击 Python 3 图标创建新的 Notebook，适合交互式数据分析和模型调试。

打开终端 ​

在 Launcher 中点击 Terminal 图标打开命令行终端。

打开终端

终端窗口

后台运行 ​

JupyterLab 中打开的终端或 Notebook，关闭标签页后默认仍在后台运行，不会被终止。可在左侧栏找回之前的会话。

后台运行

文件管理 ​

在文件浏览区右键点击文件，可进行重命名、删除、下载等操作。

文件管理

查看日志 ​

打开日志控制台（View → Show Log Console）可实时查看输出日志。

日志控制台

如未显示日志，请启用调试模式。

调试模式

常见问题 ​

Notebook 日志不更新 ​

问题： 运行程序一段时间后，刷新网页发现日志不再更新。

解决： 打开日志控制台（View → Show Log Console）查看实时日志。

建议

长时间训练任务建议使用终端配合 守护进程 运行，并将日志重定向到文件。

JupyterLab 无法打开 ​

  1. 确认实例处于「运行中」状态
  2. 更换为 Chrome 浏览器
  3. 尝试强制刷新页面（Ctrl+Shift+R / macOS：Cmd+Shift+R）
  4. 清除浏览器缓存后重试
  5. 检查系统盘空间是否充足
  6. 尝试重启实例

没有终端选项 ​

问题：Launcher 中没有 Terminal 选项。

原因：浏览器兼容性问题。

解决：更换为 Chrome 浏览器，清除缓存后重试。如仍无法解决，使用 SSH 远程连接 作为替代方案。

删除文件后磁盘空间未释放 ​

问题： 删除文件后，磁盘空间没有减少。

原因： JupyterLab 删除文件时默认将文件移入垃圾桶（.Trash 目录），而非真正删除。垃圾桶仍占用磁盘空间，需手动清理。

第一步：定位垃圾桶 ​

不同磁盘的垃圾桶位置不同，以下是常见位置：

磁盘垃圾桶路径（通常位置）
系统盘/root/.local/share/Trash
数据盘/root/rivermind-data/.Trash-0
文件存储/root/rivermind-fs/.Trash-0

如果上述路径不存在，可用 find 命令搜索：

bash
# 查找所有 Trash 目录
find / -name "*Trash*" -type d 2>/dev/null

# 或在指定磁盘下查找
find /root/rivermind-data -name ".Trash*" -type d 2>/dev/null

第二步：查看占用空间 ​

bash
# 列出目录内容（包括隐藏文件）
ls -a /root/rivermind-data/

# 查看各垃圾桶大小
du -sh /root/.local/share/Trash 2>/dev/null
du -sh /root/rivermind-data/.Trash-0 2>/dev/null
du -sh /root/rivermind-fs/.Trash-0 2>/dev/null

# 查看某个目录下所有文件大小（包括隐藏文件），按大小排序
du -sh /root/rivermind-data/.[!.]* /root/rivermind-data/* 2>/dev/null | sort -hr | head -20

第三步：清理垃圾桶 ​

bash
# 清空系统盘垃圾桶
rm -rf /root/.local/share/Trash

# 清空数据盘垃圾桶
rm -rf /root/rivermind-data/.Trash-0

# 清空文件存储垃圾桶
rm -rf /root/rivermind-fs/.Trash-0

如何避免此问题

删除文件时直接使用终端 rm 命令，文件不会进入垃圾桶，空间立即释放：

bash
rm -rf /path/to/file
命令参数说明
  • ls -a：列出所有文件，包括以 . 开头的隐藏文件（如 .Trash-0）
  • du：查看文件/目录磁盘占用大小
    • -s：只显示汇总大小，不逐个列出子目录
    • -h：以人类可读格式显示（如 1.5G、200M）
  • rm：删除文件或目录
    • -r：递归删除目录及其内容
    • -f：强制删除，不提示确认
  • find：在指定路径下搜索文件或目录
    • -name：按名称匹配（支持通配符 *）
    • -type d：只搜索目录类型
  • .[!.]*：匹配以 . 开头的隐藏文件（排除 . 和 ..）
  • sort -hr：按大小从大到小排序
  • head -20：只显示前 20 条结果
  • 2>/dev/null：隐藏错误信息（路径不存在时不报错）

智算无疆 川流不息

Copyright © 2026 智川云