如何通过VSCode的Jupyter扩展访问远程Jupyter服务器的ipynb文件？

方法1：原生Jupyter网页端访问（最直接的方案） #

你其实不需要额外操作，只要连接流程正确，本地浏览器就能直接访问远程服务器上的ipynb文件，和网页版体验完全一致：

• 远程端启动Jupyter时，必须指定允许外部访问、端口并设置验证（密码或token）：

  jupyter notebook --ip=0.0.0.0 --port=8888 --no-browser --NotebookApp.password='你的加密密码'
  

  启动后终端会输出带token的访问链接，比如http://localhost:8888/?token=xxxxxx，记下来备用。
• 本地通过SSH做端口转发，把远程的8888端口映射到本地同端口（或其他未被占用的端口）：

  ssh -L 8888:localhost:8888 你的远程用户名@远程服务器IP
  

• 本地打开浏览器，输入http://localhost:8888，输入密码或token登录后，就能看到远程服务器上的所有ipynb文件，点击即可直接编辑、运行，和网页版功能完全一致。

方法2：VS Code远程Jupyter集成（更流畅的开发体验） #

不用放弃SSH远程开发，针对你之前遇到的错误，先排查再按步骤操作：

• 本地VS Code安装Jupyter和Remote - SSH两个插件
• 通过Remote - SSH连接到远程服务器，等待VS Code加载完远程环境
• 打开命令面板（Ctrl+Shift+P），输入Jupyter: Specify Jupyter Server for Connections，选择Existing，然后输入远程Jupyter服务器的访问地址（比如之前终端输出的http://localhost:8888/?token=xxxxxx，这里的localhost是相对远程服务器的，VS Code已在远程环境中，所以直接用即可）
• 连接成功后，VS Code的文件浏览器会显示远程服务器的文件目录，直接打开ipynb文件，会自动使用远程的conda环境和解释器，功能和网页版一致。

常见SSH远程错误快速排查 #

• 权限错误：检查远程服务器/etc/ssh/sshd_config，确保PasswordAuthentication或PubkeyAuthentication开启，本地SSH密钥已正确上传到远程~/.ssh/authorized_keys
• 环境加载失败：确认远程服务器有可用的Python环境，手动指定远程解释器路径（比如~/miniconda3/envs/你的环境/bin/python）
• Jupyter连接失败：确认远程Jupyter服务器在运行，端口未被防火墙拦截，本地端口转发命令没有写错。

方法3：rsync文件同步（临时应急方案） #

如果前两种方法暂时遇到阻碍，可以用rsync快速同步文件：

• 把远程ipynb文件同步到本地：

  rsync -avz 你的远程用户名@远程服务器IP:/远程文件目录/ ~/本地存储目录/
  

• 本地编辑完成后同步回远程：

  rsync -avz ~/本地存储目录/ 你的远程用户名@远程服务器IP:/远程文件目录/
  

  这种方式适合临时使用，但没有实时编辑的流畅性。

内容的提问来源于stack exchange，提问作者陈中业