IntelliJ IDEA 2025.1 Help

管理 Jupyter notebook 服务器

在 IntelliJ IDEA 中,您可以使用以下类型的服务器执行代码单元:

  • 托管服务器 – 当前项目的 IntelliJ IDEA 自动启动的 Jupyter 服务器。 当您关闭 IntelliJ IDEA 时,它将被终止。

  • 已配置的服务器——任何通过指定其 URL 和 token 连接的 Jupyter 服务器。 它可以运行在本地或远程机器上。

添加 Jupyter 服务器

  1. 转到 工具 | 添加 Jupyter 连接...

    或者,右键点击项目目录并从上下文菜单中选择 新建 | Jupyter 连接

  2. 在打开的窗口中,点击 添加 Jupyter 连接添加 Jupyter 连接 或按 Alt+Insert

    添加 Jupyter 连接
  3. 选择您要创建的服务器类型。 有关配置特定服务器的更多信息,请参阅 设置托管服务器设置已配置的服务器

  4. 如果您希望新创建的服务器自动为当前笔记本选择,请点击 应用

    或者,点击 OK 保存更改而不选择新服务器。

添加 Jupyter 服务器

设置托管服务器

  1. 点击 Jupyter 笔记本工具栏 上的服务器列表,并从上下文菜单中选择 配置 Jupyter 服务器

    配置 Jupyter 服务器
  2. 在打开的窗口中,选择 托管服务器

  3. 名称 字段中,为您的托管服务器设置名称。

  4. 使用 命令行实参 字段设置服务器设置。

  5. 设置 环境变量 并为其分配值。

  6. Jupyter 服务器可以通过令牌(包含在 URL 中)或用户定义的密码进行保护。 如果 Jupyter 服务器通过密码保护,请在 密码 字段中输入密码。

    有关更多信息,请参阅 Jupyter 笔记本服务器中的安全性

  7. 点击 OK 应用更改并关闭窗口,或点击 应用 保持窗口打开。

设置托管服务器

设置已配置的服务器

  1. 点击 Jupyter 笔记本工具栏 上的服务器列表,并从上下文菜单中选择 配置 Jupyter 服务器

    配置 Jupyter 服务器

    或者,在 Project View 中右键点击服务器 Alt+1 并从上下文菜单中选择 配置 Jupyter 服务器

  2. 在打开的窗口中,选择 已配置的服务器

  3. 名称 字段中,为您的远程服务器设置名称。

  4. 服务器 URL 字段中,指定用于连接远程 Jupyter 服务器的地址。 目标 URL 应包含服务器名称或其地址及访问令牌。

    或者,点击 发现本地服务器 自动检测本地机器上的可用 Jupyter 实例。 如果找到服务器,URL 和令牌将自动填充。

  5. 类型 下,选择所需的服务器类型。

    使用此选项连接到本地或远程机器上运行的标准 Jupyter NotebookJupyterLab 实例。

    提供所需的身份验证令牌或密码。

    Notebook/Lab

    使用此选项连接到 JupyterHub 实例。

    提供以下之一:

    • 您的用户名、密码和 Hub 的 URL(如果通过登录凭据进行身份验证)。

    • 包含访问令牌的运行中 Jupyter 笔记本服务器的直接 URL(如果使用基于令牌的身份验证)。

    Hub

    使用此选项连接到 AWS SageMaker 实例或其他云解决方案。

    无需令牌,您可以直接使用预签名的 URL。

    AWS SageMaker
  6. 点击 测试连接 验证设置。

  7. 点击 OK 应用更改并关闭窗口,或点击 应用 保持窗口打开。

设置已配置的服务器

管理远程服务器文件

当已配置的 Jupyter 服务器连接后,其文件将显示在 Project View 中。 您可以像操作本地项目一样创建、打开、编辑和删除远程 Jupyter 服务器中的文件。 例如:

  • 要添加文件,请右键点击远程服务器目录或其中的某个包,并从上下文菜单中选择 新建。 选择所需的文件类型。

    有关更多信息,请参见 创建新项

    添加远程服务器文件
  • 要删除文件,请在远程服务器目录中右键点击该文件,并从上下文菜单中选择 删除 Delete

    删除远程服务器文件

    移除 Jupyter 服务器

    • 前往 设置 | 语言与框架 | Jupyter | Jupyter 服务器

      在打开的窗口中,选择您要移除的服务器,然后点击 移除已配置的服务器移除已配置的服务器 或按 Delete

      移除 Jupyter 服务器
    • 或者,要移除远程服务器,请在 Project View 中右键点击服务器 Alt+1 并从上下文菜单中选择 删除 Delete

    启动本地 Jupyter 服务器

    1. 点击 Jupyter 笔记本工具栏上的服务器列表,并从上下文菜单中选择您要启动的服务器。

    2. 要运行 Jupyter 服务器,请 执行任何代码单元。 当您启动单元执行时,IntelliJ IDEA 会在本地主机上使用任何可用端口(默认情况下为 8888 端口)启动 Jupyter 服务器。 您可以切换到 Jupyter 服务器 工具窗口以预览服务器的配置详情。

    Jupyter 服务器正在运行。 Jupyter 工具窗口

    服务器启动后,它会作为托管服务器显示在 Jupyter notebook 工具栏的服务器列表中。

    停止 Jupyter 服务器

    要停止任何正在运行的服务器,请切换到 Jupyter 服务器 工具窗口并点击 停止 Jupyter 服务器停止 Jupyter 服务器。 在 服务器日志 窗口中预览状态。

    停止服务器

    一旦关闭服务器,当前会话将被终止。 下次启动服务器时,所有先前会话和所有 notebook 的执行结果将丢失。

      内核操作

      重启 kernel

      您可能想在不关闭整个服务器并不影响其他笔记本的情况下刷新您的计算。 要重新启动当前运行的 kernel,请点击 内核Jupyter notebook 工具栏 上。 您可以在 服务器日志 窗口中查看内核状态:

      正在重启当前内核

        关闭内核

        要完全停止正在运行的内核,请打开 Jupyter 笔记本工具栏上的服务器列表,并从上下文菜单中选择 关闭内核。 此操作将终止当前的内核会话。

        关闭内核

          切换内核

          如果您至少有两个可用的内核,并且需要切换到其他内核,请打开 Jupyter 笔记本工具栏上的服务器列表。 从上下文菜单中选择 切换内核 ,然后从下拉列表中选择所需的内核。

          切换内核

            将内核连接到服务器

            在选择远程 Jupyter 服务器并打开笔记本后,运行第一个单元格后内核列表将自动可用。

            不过,您也可以在运行任何单元格之前手动连接到服务器。 在启动已配置的服务器后,打开 Jupyter 笔记本工具栏上的服务器列表,并从上下文菜单中选择 连接到服务器。 这将建立内核与 Jupyter 服务器之间的连接。

            将内核连接到服务器
              最后修改日期: 2025年 4月 24日