PyCharm远程连接Linux服务器运行Jupyter Notebook异常求助

一、核对PyCharm的Jupyter服务器配置 #

• 打开Settings/Preferences → Tools → Jupyter
• 确认选中的是远程SSH解释器对应的Jupyter服务器，而非本地或其他无关配置
• 点击Configure，在弹窗中填入远程服务器上Jupyter的真实URL和Token（可在服务器终端执行jupyter notebook list获取）
• 若设置自动启动服务器，务必勾选Run server on remote machine，并指定远程服务器上Jupyter的可执行文件路径（可通过服务器终端which jupyter确认路径）

二、手动建立SSH隧道并映射端口 #

自动隧道可能存在配置冲突，手动搭建更稳定：

1. 本地终端执行SSH隧道命令：

   ssh -L 8888:localhost:8888 your_username@remote_server_ip
   

   若远程8888端口被占用，可替换为其他未使用端口（如8889），两端端口保持一致即可
2. 远程服务器终端手动启动Jupyter：

   jupyter notebook --no-browser --port=8888
   

   端口需和隧道命令中的远程端口对应
3. PyCharm中选择Existing server，填入本地映射的URL（如http://localhost:8888）和服务器输出的Token，点击Test Connection验证连通性

三、确保远程解释器与Jupyter环境一致 #

• 确认远程Python环境已安装Jupyter：在PyCharm远程终端执行pip install jupyter（未安装时运行）
• 检查解释器路径一致性：在PyCharm运行以下脚本，对比服务器终端python -c "import sys; print(sys.path)"的输出，确保路径完全匹配，避免环境隔离问题：

  import sys
  print(sys.path)
  

四、重置PyCharm缓存与配置 #

• 关闭PyCharm，删除本地缓存目录：
  • Windows：C:\Users\<YourName>\.PyCharm<Version>\system
  • macOS：~/Library/Caches/JetBrains/PyCharm<Version>
  • Linux：~/.cache/JetBrains/PyCharm<Version>
• 重启PyCharm后重新配置远程开发和Jupyter服务器，清除旧配置冲突

五、检查防火墙与端口权限 #

• 确认远程服务器防火墙允许本地回环访问Jupyter端口（如8888），因SSH隧道通过localhost转发，无需开放外部端口，但需确保服务器本地未限制该端口
• 本地笔记本电脑防火墙需允许PyCharm访问映射的本地端口（如8888）

内容的提问来源于stack exchange，提问作者Quentin Chartreux