SSH断连（Broken Pipe）致tmux会话终止，Paramiko场景求解决方案

我之前也碰到过类似的场景——用Paramiko远程启动tmux后，连接意外断开导致会话被终止的情况。结合你的尝试和这类问题的常见排查方向，给你几个可行的解决思路：

1. 给Paramiko SSH连接添加心跳保活 #

Paramiko默认不会主动发送心跳包，长时间无数据传输时，中间的防火墙、路由器甚至服务器本身都可能把这个连接判定为闲置并主动切断。你可以在建立SSH连接后开启心跳机制：

import paramiko

ssh = paramiko.SSHClient()
ssh.set_missing_host_key_policy(paramiko.AutoAddPolicy())
ssh.connect('你的远程主机地址', username='用户名', password='密码')

# 开启心跳，每30秒发送一次空包维持连接
ssh.get_transport().set_keepalive(30)

这样能让连接持续保持活跃，避免被中间设备或服务端过早断开。

2. 确保tmux会话完全后台分离 #

很多时候问题不是连接断开本身，而是tmux会话和当前SSH会话绑定在了一起——当SSH连接断开时，tmux作为子进程会被连带终止。你需要启动tmux时直接让它后台运行，不依附当前终端：
不要用普通的启动命令，而是加上-d参数：

tmux new-session -d -s 你的会话名称

-d参数会让tmux直接在后台创建并分离会话，完全独立于当前SSH连接，这样即使SSH断了，tmux会话也能继续运行。

3. 调整SSH服务端的闲置超时配置 #

登录远程机器，修改/etc/ssh/sshd_config文件，调整以下两个参数：

ClientAliveInterval 30
ClientAliveCountMax 10

• ClientAliveInterval：服务端每30秒向客户端发送一次心跳包，确认连接存活
• ClientAliveCountMax：如果连续10次没收到客户端的回应，才会断开连接

修改后重启sshd服务生效：

sudo systemctl restart sshd

这能从服务端层面防止连接被过早判定为闲置而断开。

4. 优化systemd的KillMode配置（针对你的现有尝试） #

你提到修改了ssh@.service的KillMode，但可能配置的位置或参数不够准确。建议这样操作：

1. 新建（或编辑）/etc/systemd/system/ssh@.service.d/override.conf文件
2. 添加以下配置：

[Service]
KillMode=process

KillMode=process会让systemd只终止SSH主进程，不会递归杀死它启动的所有子进程（比如tmux）。如果process还是不行，可以尝试更宽松的KillMode=none，不过前者安全性更高。

配置完成后重新加载systemd并重启服务：

sudo systemctl daemon-reload
sudo systemctl restart ssh@.service

注意：这个配置只对systemd管理的SSH会话生效，如果你的tmux是通过Paramiko直接启动的，需要确认tmux的父进程是否属于systemd管理的ssh服务进程。

5. 改用Paramiko的invoke_shell启动tmux（可选） #

如果用exec_command启动tmux容易出现会话绑定的问题，可以试试用invoke_shell模拟手动登录终端的方式启动：

import paramiko
import time

ssh = paramiko.SSHClient()
ssh.set_missing_host_key_policy(paramiko.AutoAddPolicy())
ssh.connect('你的远程主机地址', username='用户名', password='密码')

shell = ssh.invoke_shell()
# 发送tmux后台启动命令
shell.send('tmux new-session -d -s 你的会话名称\n')
# 短暂等待确保命令执行完成
time.sleep(1)
# 可以读取输出确认会话是否成功启动
output = shell.recv(1024).decode()
print(output)

这种方式更接近手动SSH登录的环境，能减少会话意外绑定的概率。

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