可通过三种方法在本地VSCode连接远程Jupyter服务器:一、Jupyter扩展直接输入远程URL;二、SSH隧道转发端口后连接localhost;三、Remote-SSH扩展直连远程机器运行notebook。

如果您在本地使用 VSCode 编辑器,但希望运行远程 Jupyter 服务器中的 notebook,需通过配置远程内核连接实现。以下是完成此连接的多种方法:
本文运行环境:MacBook Air,macOS Sequoia
一、通过 Jupyter 扩展直接输入远程服务器 URL
VSCode 的 Jupyter 扩展支持手动指定已运行的远程 Jupyter 服务地址,前提是该服务器已启用 token 或密码认证并对外开放端口。
1、确保远程服务器已启动 Jupyter Notebook 或 JupyterLab,并记录其访问 URL(例如 https://192.168.1.100:8888)及对应 token 或密码。
2、在 VSCode 中打开任意 .ipynb 文件,点击右上角“选择内核”按钮(显示为“Python 3.x.x”或“未选择内核”)。
3、在弹出菜单中选择 Enter URI 选项。
4、输入完整远程 URL,格式为 https://:?token=,例如 https://192.168.1.100:8888/?token=abc123def456。
5、按回车确认,VSCode 将尝试连接并验证内核可用性。
二、使用 SSH 隧道转发本地端口至远程 Jupyter 服务
当远程 Jupyter 服务器仅监听 localhost 或受限网络接口时,可通过 SSH 端口转发将其安全暴露至本地,再以本地地址连接。
1、在终端执行 SSH 隧道命令:ssh -L 8888:localhost:8888 user@remote-server-ip,其中 8888 为本地绑定端口,需与远程服务实际端口一致。
2、保持该 SSH 连接处于活动状态,不要关闭终端窗口。
3、在 VSCode 中打开 .ipynb 文件,点击“选择内核”,选择 Existing Jupyter Server...。
4、在 URI 输入框中填写 http://localhost:8888,不带 token 参数(若远程服务未设密码,或已在 SSH 会话中完成认证)。
5、点击“Connect”,VSCode 将通过隧道与远程内核通信。
三、配置 VSCode 远程开发扩展直连远程机器并启动 Jupyter
借助 Remote - SSH 扩展,可在远程主机上完整运行 VSCode 服务端,所有 notebook 运行环境均位于远程系统,避免跨网络内核代理问题。
1、在本地 VSCode 中安装 Remote - SSH 和 Jupyter 两个扩展。
2、按下 Cmd+Shift+P(Mac)调出命令面板,输入并选择 Remote-SSH: Connect to Host...。
3、添加远程主机配置,格式为 user@remote-server-ip,保存后建立连接。
4、连接成功后,VSCode 窗口右下角状态栏将显示远程主机名,此时所有文件操作和 notebook 运行均发生在远程系统。
5、在远程环境中打开 .ipynb 文件,VSCode 将自动检测并使用远程 Python 解释器及 Jupyter 内核,无需额外配置 URL。










