含活跃IPython/Matplotlib的Tmux会话无法正常退出SSH

我之前也碰到过一模一样的情况，核心问题出在Matplotlib默认的交互式后端会绑定终端TTY资源，创建GUI相关的线程，导致SSH退出时无法正常断开连接；而你被迫按下的Ctrl-C会把信号传递给Tmux会话，直接终止了整个后台进程。下面是具体的解决步骤：

1. 禁用Matplotlib的交互式后端（关键） #

让Matplotlib不加载GUI组件，彻底避免终端资源占用：

• 方法一：启动IPython前设置环境变量
  在Tmux会话里先执行这条命令，再启动IPython：

  export MPLBACKEND=Agg
  ipython
  

  之后导入matplotlib就不会启动任何GUI后端了。
• 方法二：在IPython内部提前配置
  进入IPython后，先执行以下代码再导入pyplot：

  import matplotlib
  matplotlib.use('Agg')  # 切换到非交互式后端
  import matplotlib.pyplot as plt
  

  如果之后需要临时切换回交互式（比如你有X转发能显示图形），可以再用plt.switch_backend('TkAgg')调整，但远程无GUI环境下用Agg完全足够。

2. 确保SSH退出时Tmux会话正常留存 #

解决后端问题后，按你的流程操作就不会再挂起了：

ssh-desk  # 登录远程机器
tmux      # 启动Tmux会话
# 按上面的方法配置Matplotlib后运行IPython
Ctrl-b d  # 分离Tmux会话
tmux ls   # 确认会话存在
exit      # 退出SSH，此时会正常断开，不会挂起

如果偶尔还是出现异常，可以尝试用tmux detach -s 0（替换0为你的会话ID）明确分离会话，再执行退出。

3. 关于Tmux会话消失的说明 #

之前你的会话消失，是因为按下Ctrl-C时，这个中断信号会传递给SSH进程及关联的Tmux会话，直接把Tmux进程终止了。解决Matplotlib后端问题后，SSH能正常退出，Tmux会话会稳定留在后台，下次登录用tmux attach -t 0就能恢复之前的IPython会话。

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