VSCode连接远程Docker中Jupyter Server时创建内核失败求助

问题现象 #

本地VSCode通过Jupyter扩展连接部署在远程Docker环境（已配置端口转发）的Jupyter Server时，新建笔记本创建内核失败：

• 浏览器访问http://{remote_machine_ip}:{port}/可正常创建、运行笔记本
• VSCode连接该远程Server后，运行本地笔记本单元格时报错：

Failed to start the Kernel.
'_xsrf' argument missing from POST.
View Jupyter log for further details.

临时 workaround：先在浏览器中手动创建目标内核，再回到VSCode中选择该内核即可正常运行。

原因分析 #

报错源于Jupyter的CSRF防护机制：浏览器访问时会自动处理并携带Cookie中的_xsrf令牌，而VSCode Jupyter扩展在创建内核的请求中未正确传递该令牌，导致Server拒绝请求。

永久解决方案 #

方案1：配置VSCode使用令牌认证连接 #

启动远程Jupyter Server时指定令牌：

jupyter notebook --ip=0.0.0.0 --port={your_port} --no-browser --token=your_secure_token

在VSCode中连接时，输入完整的带令牌的URL（格式：http://{remote_machine_ip}:{port}/?token=your_secure_token），而非仅IP加端口。

方案2：调整Jupyter Server的CSRF配置（不推荐用于生产环境） #

编辑Jupyter配置文件jupyter_notebook_config.py，添加以下配置：

c.NotebookApp.disable_check_xsrf = True

保存后重启Jupyter Server即可关闭CSRF检查，注意此方法会降低安全性，仅建议用于测试环境。

方案3：检查Docker端口转发规则 #

确保Docker端口转发未过滤HTTP Cookie头，使用标准端口映射命令：

docker run -p {host_port}:{container_port} [your_jupyter_image]

避免使用自定义代理或转发规则导致Cookie丢失。

内容的提问来源于stack exchange，提问作者Lokesh Kurre