VSCode远程SSH使用Jupyter：断连重连未保存更改问题求解

一、配置Jupyter自动高频保存 #

通过缩短自动保存间隔，从根源减少未保存内容的风险：

• 生成Jupyter配置文件：

  jupyter notebook --generate-config
  

• 打开~/.jupyter/jupyter_notebook_config.py，修改以下参数：

  c.FileContentsManager.autosave_interval = 10  # 每10秒自动保存一次（默认120秒）
  c.NotebookApp.autosave_handler_interval = 5   # 缩短自动保存处理间隔
  

• 重启tmux中的Jupyter服务使配置生效

二、调整VSCode的Jupyter相关设置 #

让VSCode优先同步远程状态，避免断连后的未保存提示阻塞重连：

• 打开VSCode设置（快捷键Ctrl+,），搜索并修改：
  • Jupyter: Auto Save Notebook 设置为 on，强制笔记本自动保存
  • Jupyter: Allow Force Save 勾选开启，断连时可强制尝试同步到远程
  • Remote.SSH: Enable Persistent Sessions 勾选开启，让SSH自动重连并恢复会话

三、tmux + Jupyter Lab 持久化启动方案 #

改用Jupyter Lab配合固定端口启动，重连后直接恢复会话：

• 在tmux会话中启动Jupyter Lab（指定固定端口方便转发）：

  jupyter lab --no-browser --port=8889
  

• 设置固定密码替代临时token（避免每次重连输入token）：

  jupyter server password
  

• VSCode重连远程后，通过SSH端口转发将远程8889端口映射到本地，然后在Jupyter插件中选择「Existing Jupyter Server」，输入http://localhost:8889并输入密码，即可直接恢复之前的会话，不会触发未保存提示

四、断连后的应急恢复技巧 #

如果已经出现未保存提示无法重连：

• 先在本地VSCode中全选笔记本内容，粘贴到本地临时.ipynb文件备份
• 重新建立SSH连接，进入tmux会话查看原Jupyter进程，检查远程服务器上的笔记本文件是否有自动保存的版本
• 若远程有部分保存，打开该文件合并本地备份内容；若远程未保存，直接将本地备份粘贴到新笔记本并关联到原Jupyter服务器

五、进阶优化：减少SSH断连概率 #

在远程服务器端配置SSH保持连接，降低因休眠、长时间无操作导致的断连：

• 编辑/etc/ssh/sshd_config：

  ClientAliveInterval 30
  ClientAliveCountMax 10
  

• 重启sshd服务：

  sudo systemctl restart sshd
  

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