在独立服务器或本地部署 JupyterLite#
部署 JupyterLite 站点需要
一份 JupyterLite 站点资产的副本
通常由可通过
pip
安装的 Python 包jupyterlite-core
提供
一组可选的站点和不同应用程序的配置
不同的选项在可重现性、构建速度、部署大小以及最终用户性能、隐私和安全性之间提供了权衡
获取一个空的 JupyterLite 站点#
最小的可部署站点存档包含运行所有默认应用程序所需的一切,但不包含任何内容。
提示
使用 CLI 是可选的,但推荐。它能更好地与其他 Jupyter 工具集成。
从 PyPI 获取 Python CLI 和 API
python -m pip install jupyterlite-core
您也可以使用 conda
从 conda forge 安装 CLI
conda install -c conda-forge jupyterlite-core
或者 mamba
mamba install -c conda-forge jupyterlite-core
要构建一个空站点(仅包含 JupyterLite 静态资产)
jupyter lite init
默认情况下,JupyterLite 网站将放置在 _output
文件夹中。您可以使用 --output-dir
参数指定一个不同的文件夹。例如:
jupyter lite build --output-dir dist
注意
默认情况下,jupyterlite-core
包不提供任何内核。如果您想在您的环境中安装一个内核,您需要在您的构建环境中安装它。例如,要为 JupyterLite 安装 Pyodide 内核
python -m pip install jupyterlite-pyodide-kernel
然后务必重新运行 jupyter lite build
命令。
自定义站点#
默认情况下,JupyterLite 站点将是空的,但您可以通过添加自己的内容和配置来对其进行自定义。
文档中包含了一些关于自定义站点的操作指南
查看 操作指南 列表以获取更多信息。
独立服务器#
静态资产构建完成后,您可以使用一个普通的 HTTP 服务器来提供它们,并通过网络浏览器访问 JupyterLite。
适用于本地开发,许多语言都提供了易于使用的服务器,可以在您使其正常工作时在本地为您提供 JupyterLite。
警告
某些内核的提供要求您的 Web 服务器支持使用正确的标头提供 application/wasm
文件
提示
除最简单的 localhost
情况外,建议使用支持 HTTPS 的服务器。
jupyter lite serve
#
jupyter lite serve
命令提供了一个由 Python 内置的 http.server
或 tornado
提供支持的 Web 服务器,如果安装了其他 Jupyter 工具,则很可能可用。
在同一目录下,运行以下命令启动服务器
jupyter lite serve
注意
还提供更多选项,例如更改端口和日志级别。请查看 jupyter lite serve --help
以了解更多信息。
Jupyter#
如果您已经运行了一个由 Jupyter Server 提供支持的应用程序,例如 JupyterLab,您的文件将在例如 https://:8888/files
上正确提供。
Python#
http.server#
Python 标准库中的 http
模块是一个适用于本地用途的有效服务器。
python -m http.server -b 127.0.0.1
如果您使用的是最近发布的 Python 3.7+,它将正确地为 WebAssembly 内核提供 application/wasm
文件。
NodeJS#
大多数基于 Node.js 的服务器都能毫无问题地托管 JupyterLite。但请注意,http-server
不支持 application/wasm
MIME 类型。
使用发行版存档#
除了使用 jupyter-lite
CLI,您还可以从 GitHub Releases 页面下载发行版存档。
下载并解压,然后使用上述方法之一启动服务器。
夜间构建和开发中存档也可从 GitHub actions 获取。