Repolode
jpmorganchase

jpmorganchase/jupyter-fs

一个 JupyterLab 扩展,可添加多个文件浏览器,连接本地及 S3、Samba 等远程存储。

Star
249
Fork
57
未关闭 Issue
32
最近提交
7天前

这是什么?

jupyter-fs 是一个 JupyterLab 插件,可以配置任意数量的文件浏览器面板,每个面板指向一个本地目录或远程的类文件系统资源。你不再局限于 Jupyter 服务器的单一工作目录,而是能在侧边栏中同时查看和操作多个存储位置。

服务端基于 PyFilesystem 和 fsspec 构建,资源通过 URL 描述,例如 osfs:// 表示本地目录,s3:// 表示 Amazon S3 存储桶,smb:// 表示 Samba 共享。资源可以在 JupyterLab 设置编辑器中添加,也可以写在服务端配置文件中,并与用户设置合并。URL 中可用 {{VAR}} 占位符表示凭据,需要时 JupyterLab 会弹出输入框。

前端使用 tree-finder 实现。项目同时发布到 PyPI 和 npm。官方测试主要覆盖 S3 和 Samba 后端,其他 PyFilesystem 和 fsspec 后端理论上可用,但验证程度较低。

核心功能

  • 01在 JupyterLab 侧边栏中添加多个相互独立的文件浏览器面板。
  • 02支持连接本地目录、Amazon S3 存储桶和 Samba 共享。
  • 03同时支持 PyFilesystem 和 fsspec 后端,可按资源单独选择。
  • 04URL 中可使用占位符表示凭据,资源加载时弹窗输入。
  • 05可通过 JupyterLab 设置编辑器或服务端配置文件进行配置。

适用场景

  • 在 notebook 环境中直接浏览网络共享盘或 Samba 共享目录。
  • 在 JupyterLab 中同时处理 S3 存储桶数据和本地项目文件。
  • 在同一个 JupyterLab 会话中访问多个共享存储位置。

快速上手

  1. 1

    使用 pip 安装软件包

    pip install jupyter-fs
  2. 2

    将 MetaManager 和扩展设置添加到 jupyter_server_config.json

  3. 3

    在 JupyterLab 中通过 Settings -> Settings Editor 添加文件系统资源

使用前须知

  • 只有 S3 和 Samba(smb)的 PyFilesystem 后端经过 CI 测试,其他后端可能无法按预期工作。
  • 远程资源的认证依赖模板化 URL 和环境变量,需要手动配置。

标签

#jupyter#jupyterlab#file-browser#s3#samba#fsspec#pyfilesystem#jupyter-lab#jupyter-notebook#jupyterlab-extension

常见问题

jupyter-fs 是什么?
一个 JupyterLab 扩展,可添加多个文件浏览器,连接本地及 S3、Samba 等远程存储。 jupyter-fs 是一个 JupyterLab 插件,可以配置任意数量的文件浏览器面板,每个面板指向一个本地目录或远程的类文件系统资源。你不再局限于 Jupyter 服务器的单一工作目录,而是能在侧边栏中同时查看和操作多个存储位置。
jupyter-fs 可以免费使用吗?用的什么许可证?
jupyter-fs 以 Apache-2.0 许可证开源。用于商业产品前,请先确认许可证条款。
jupyter-fs 还在维护吗?
活跃维护中。jupyter-fs 最近一次提交是在 2026年10月31日。
jupyter-fs 适合用来做什么?
在 notebook 环境中直接浏览网络共享盘或 Samba 共享目录。 在 JupyterLab 中同时处理 S3 存储桶数据和本地项目文件。 在同一个 JupyterLab 会话中访问多个共享存储位置。
jupyter-fs 怎么安装和运行?
使用 pip 安装软件包: pip install jupyter-fs 将 MetaManager 和扩展设置添加到 jupyter_server_config.json 在 JupyterLab 中通过 Settings -> Settings Editor 添加文件系统资源
在哪里获取 jupyter-fs?
源代码和安装说明在 GitHub 上:https://github.com/jpmorganchase/jupyter-fs

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目