VSCode连不上远程Jupyter服务器主因是服务端未正确启动或监听地址错误；需用--ip=0.0.0.0启动、配对API路径与token、SSH隧道避免localhost、手动注册远程kernel。

VSCode 连不上远程 Jupyter 服务器，90% 的问题出在服务端没跑起来或监听地址不对，而不是 VSCode 设置错了。

远程 jupyter-server 必须监听 --ip=0.0.0.0

只运行 jupyter notebook 或 jupyter lab 默认监听 127.0.0.1，本地回环地址对外不可达。VSCode 从本机发请求，自然连不上。

• 正确启动命令（Jupyter Lab 3.0+）：jupyter server --ip=0.0.0.0 --port=8888 --no-browser --allow-root --token='' --NotebookApp.password=''
• --ip=0.0.0.0 不可省略；--allow-root 在容器或 root 用户下必须加，否则启动失败
• 生产环境务必配 token，空 token 仅用于快速验证连通性
• 用 ss -tuln | grep 8888 确认输出中有 *:8888（不是 127.0.0.1:8888）

VSCode 中填的连接地址格式必须带 ?token= 和 /api 路径

VSCode 的 Jupyter 扩展不是浏览器，它会主动发起 GET /api/sessions 请求校验服务可用性。路径错、参数少、斜杠多一个都会 404 或 403。

• 标准格式：http://:8888/?token=（注意是问号 ?，不是斜杠 /）
• 如果启用了 --base-url=/jupyter，就得写成：http://:8888/jupyter/?token=
• 不要填 http://:8888/tree 或 http://:8888/lab —— 这些是前端页面路径，不是 API 入口
• 填完点“连接”，VSCode 控制台（Output → Jupyter）里能看到真实请求和响应，403 说明 token 错，404 说明路径错，Connection refused 说明网络不通

SSH 隧道转发时，localhost 在 Windows 上可能失效

很多人用 ssh -L 8888:localhost:8888 user@host，结果 VSCode 连 http://localhost:8888/?token=xxx 失败。这不是 VSCode 的锅，是 OpenSSH 在 Windows 下对 localhost 的解析不稳定。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• 换成明确 IP：ssh -L 8889:127.0.0.1:8888 user@host
• VSCode 中就填：http://localhost:8889/?token=xxx
• 本地端口（如 8889）建议避开本机已占的 8888，避免冲突
• 确认隧道建立后，本地执行 curl -v http://localhost:8889/api/sessions 能返回 JSON，再进 VSCode

远程 kernel 必须提前注册，不能靠本地 Python 解释器“自动发现”

VSCode 里点“选择内核”看不到远程环境？不是扩展没装好，是你根本没在远程服务器上把那个环境注册成 kernel。

• 先 conda activate myenv 或 source venv/bin/activate
• 再运行：python -m ipykernel install --user --name myenv --display-name "Python (myenv)"
• 注册后，jupyter kernelspec list 应该能列出 myenv
• VSCode 连上远程 server 后，右上角选内核才会出现这个名称；不注册，就只有默认的 Python 3（通常指向 base 环境）

最常被忽略的一点：VSCode 的 Jupyter 扩展不会帮你启动远程服务，也不会自动同步 kernel 列表——它只负责发 HTTP 请求和渲染结果。所有服务端配置、端口开放、kernel 注册、token 管理，都得你手动在远程机器上做完，一步都不能少。