jupyter/nbviewer

这是什么？

核心功能

• 01支持从 URL、GitHub、Gist、Hugging Face 和本地文件渲染 notebook。
• 02基于 nbconvert，提供 HTML、幻灯片和脚本等输出格式。
• 03可通过 Docker Compose 或 Python 环境本地运行，生产环境使用 memcached 缓存。
• 04支持 GitHub OAuth、API Token 以及 GitHub Enterprise。
• 05可作为 JupyterHub 服务运行，限制只有已认证用户访问。

适用场景

• 在团队内网部署 notebook 查看服务。
• 无需安装 Jupyter 即可分享 GitHub 仓库中的 notebook 渲染结果。
• 在 GitHub Enterprise 实例上浏览内部 notebook。
• 通过 JupyterHub 认证保护本地 notebook 的访问。

快速上手

1. 1

   拉取 Docker 镜像

   docker pull jupyter/nbviewer
2. 2

   运行容器并开放 8080 端口

   docker run -p 8080:8080 jupyter/nbviewer

使用前须知

• !无法自动识别许可证，复用前请先查看仓库的许可证条款。
• !本地运行需要安装 pandoc、libmemcached 等多个系统软件包，并配置 Python 环境。
• !若要快速访问 GitHub，需要配置 GitHub OAuth 密钥或 API 令牌。

收录于专题

标签

常见问题

nbviewer 是什么？

基于 nbconvert 的 Python Web 服务，可将 Jupyter Notebook 渲染为静态网页并在线查看。 nbviewer 是公共 Jupyter Notebook Viewer 网站背后的 Web 应用。它可以从 URL、GitHub 仓库、Gist 或其他受支持的来源读取 notebook，并转换为静态 HTML 页面，让访问者无需安装 Jupyter 即可在浏览器中查看渲染结果。

nbviewer 可以免费使用吗？用的什么许可证？

nbviewer 以 Other 许可证开源。用于商业产品前，请先确认许可证条款。

nbviewer 还在维护吗？

活跃维护中。nbviewer 最近一次提交是在 2026年11月5日。

nbviewer 适合用来做什么？

在团队内网部署 notebook 查看服务。 无需安装 Jupyter 即可分享 GitHub 仓库中的 notebook 渲染结果。 在 GitHub Enterprise 实例上浏览内部 notebook。 通过 JupyterHub 认证保护本地 notebook 的访问。

nbviewer 怎么安装和运行？

拉取 Docker 镜像: docker pull jupyter/nbviewer 运行容器并开放 8080 端口: docker run -p 8080:8080 jupyter/nbviewer

在哪里获取 nbviewer？

源代码和安装说明在 GitHub 上：https://github.com/jupyter/nbviewer