让终端会话一直运行
在 iPhone 和 iPad 上,只要离开 App,SSH 连接就保不住,连接里运行的程序也会跟着停掉。在服务器上装一个终端多路复用器(multiplexer)就能解决:程序在服务器上继续跑,XFiles 每次连接都会自动接回去。
这份教程从“为什么会断”讲起,帮你在 tmux、Zellij、Herdr 里选一个,装到服务器上,在 XFiles 里打开,并学会在手机键盘上操作它。适用于 iOS 版 XFiles Pro 中 SFTP 位置的 SSH 终端。
两分钟快速上手
- 在服务器上安装 tmux,例如 Debian / Ubuntu:
sudo apt install tmux。 - 在 XFiles 里:设置 → 网络位置,点 SFTP 位置右侧的 ⓘ,再点保持会话运行,选 tmux,返回后点保存。
- 打开终端。之后你可以随意切换 App、锁屏、断网;回来时 XFiles 会自动连回同一个画面。
1. 为什么 iPhone 上的 shell 会停
iOS 不允许 App 一直在后台运行。切到别的 App、锁屏、接电话、走出 Wi‑Fi 范围或在 Wi‑Fi 与蜂窝网络之间切换后不久,iOS 就会挂起 XFiles,SSH 连接随之关闭。
在服务器那边,你用的 shell 属于这条连接。服务器发现连接没了,就会“挂断”这个终端:shell 收到挂断信号后退出,并带走它启动的所有程序。于是跑到一半的 apt upgrade、rsync、编译、训练任务,或者 Claude Code、Codex 这类 AI 编程智能体,都会中途停下。
回到 XFiles 时它会自动重连,但新连接只能开一个新的 shell。服务器一旦关闭了终端,任何手机上的任何 App 都没法把它找回来。办法只能放在服务器上。
连接一断,服务器挂断终端,shell 和里面的一切都停止。
断掉的只是负责显示画面的小客户端。多路复用器让 shell 和程序继续运行,你回来时 XFiles 再接上。
2. 多路复用器做了什么
终端多路复用器是跑在服务器上的程序,由它来“拥有”你的 shell。SSH 连接变成了看进去的一扇窗:窗关了,屋子还在,里面的东西照常运行。重新连上,看到的还是同一个画面,连你不在时滚过去的输出都在。
它还带来一些在小屏幕上很顺手的功能:一条连接里开多个窗口或标签页、分屏、可搜索的历史记录,以及从电脑上打开同一个会话。
3. XFiles 帮你做了什么
给位置选好多路复用器后,你不需要再敲任何 attach 命令。每次连接(包括自动重连),XFiles 都会:
- 以登录 shell 启动,让你配置文件里的
PATH生效,并额外查找~/bin、~/.local/bin、~/.cargo/bin、/opt/homebrew/bin、/usr/local/bin、Linuxbrew、Nix 和/snap/bin; - 附加服务器上已经在运行的会话,让每台设备都接着同一个会话工作:tmux 是你最近用过的那个会话,Zellij 是最新的仍在运行的会话(并让它在连接中断时只“分离”而不是退出),Herdr 是它的默认会话,也就是直接运行
herdr打开的那个。一个都没有时才新建; - 服务器上没装时退回普通 shell,并用一张黄色卡片明确告诉你;
- 断网或从别的 App 回来时自动重连,并把远端画面调整到手机的尺寸。
4. tmux、Zellij 还是 Herdr?
| tmux | Zellij | Herdr | |
|---|---|---|---|
| 适合 | 所有人,最稳妥。 | 新手:按键提示一直显示在底部。 | 同时跑多个 AI 编程智能体。 |
| 安装 | 所有包管理器都有。 | Homebrew、Arch、Alpine 有包;其他系统下载单个文件即可。 | 安装脚本或 Homebrew。 |
| 按键 | 先按 ctrl b,再按一个键。 | ctrl + 字母进入某种模式,屏幕上有提示。 | 先按 ctrl b,再按一个键;以鼠标操作为主。 |
| 在 XFiles 里滑动滚屏 | 需先 set -g mouse on。 | 开箱即用。 | 开箱即用。 |
拿不准就选 tmux。如果服务器上已经装了其中一个,用它最省事:XFiles 会自动检测,并把它标为推荐。
5. 第 1 步:装到服务器上
在服务器上运行下面任意一条。如果没有别的途径登录服务器,就在 XFiles 里打开这个位置的终端(普通 shell 就行),粘贴命令后按回车。以 sudo 开头的命令会要求输入密码。
不知道装没装?第 2 步里 XFiles 会帮你检测,也可以运行 command -v tmux zellij herdr。
tmux
| 系统 | 命令 |
|---|---|
| Debian、Ubuntu、Raspberry Pi OS | sudo apt update && sudo apt install -y tmux |
| Fedora、RHEL、Rocky、Alma | sudo dnf install -y tmux |
| Arch、Manjaro | sudo pacman -S tmux |
| Alpine | sudo apk add tmux |
| openSUSE | sudo zypper install tmux |
| FreeBSD | sudo pkg install tmux |
| macOS(Homebrew) | brew install tmux |
Zellij
Debian、Ubuntu、Fedora 没有官方软件包,直接下载单个文件即可。这种方式不需要管理员权限,装在你的主目录里,XFiles 能找到它:
mkdir -p ~/.local/bin && curl -fsSL https://github.com/zellij-org/zellij/releases/latest/download/zellij-$(uname -m)-unknown-linux-musl.tar.gz | tar -xz -C ~/.local/bin
这条命令适用于 Intel / AMD(x86_64)和 ARM(aarch64)的 64 位 Linux。其他情况:
| 系统 | 命令 |
|---|---|
| Arch | sudo pacman -S zellij |
| Alpine | sudo apk add zellij |
| 装了 Homebrew 的 macOS 或 Linux | brew install zellij |
| 有 Rust 工具链的系统 | cargo install --locked zellij |
Herdr
支持 Linux(x86_64、arm64)和 macOS。安装脚本装到 ~/.local/bin,不需要管理员权限:
curl -fsSL https://herdr.dev/install.sh | sh
有 Homebrew 的话:brew install herdr。其他方式见 herdr.dev。
6. 第 2 步:在 XFiles 里打开
- 打开设置 → 网络位置。
- 点 SFTP 位置右侧的 ⓘ。(还没有位置?点 +,用服务器地址和 SSH 账号添加一个。)
- 在 SSH 终端一栏,点保持会话运行。
- XFiles 会登录服务器检测一遍。每个选项会显示已安装及版本号,或未安装,其中一个标为推荐。
- 点你要用的那个。如果它没装,页面会给出适合这台服务器的安装命令,带复制按钮。
- 返回,点保存。
也可以从终端里开启。位置还在用普通 shell 时,第一次打开它的终端、以及断线后 shell 被换成新的时候,XFiles 会弹出一张提示卡片。点去设置会打开同一个页面;保存后 XFiles 会询问是否立即重新连接,让设置马上生效。
7. 第 3 步:一分钟验证
- 打开终端,你应该能看到多路复用器的界面:tmux 在底部有一条绿色状态栏;Zellij 顶部是标签栏,底部是按键提示。第一次接上时,XFiles 还会提示tmux 正在保持会话运行(或 Zellij、Herdr)。
- 运行一个需要时间的命令,比如计数器:
for i in $(seq 1 600); do echo "$i"; sleep 1; done - 切到别的 App,或者锁屏,等一分钟。
- 回到 XFiles。它会自己重新连接,计数器还在继续数;你离开期间打印的数字都在历史记录里。
如果计数器没了、只剩一个新的提示符,说明多路复用器没有启动。这种情况 XFiles 会显示黄色卡片,请看常见问题。
8. 在手机上按出组合键
多路复用器靠 ctrl、alt 组合键操作。XFiles 在键盘上方加了两排按键:
- ctrl 和 alt 只作用于你接下来按的一个键。要按 ctrl+b:先点 ctrl,再按 b。
- 像 tmux 的“ctrl b 之后按 c”这种两步快捷键,就是依次点三下:ctrl、b、c。
- alt 会在按键前加一个 Escape,Zellij、tmux、Emacs 都把它当作 Alt。
- 手形图标开启时(默认),在全屏程序里滑动就像滚动鼠标滚轮;关闭后,滑动改为在手机上选中文字。
- 外接键盘上的 ctrl 和 option 也能直接用。
想离开时不需要按任何多路复用器的键:直接关闭终端或切换 App 就行,一切都会继续运行。
9. tmux 速查
tmux 的快捷键都以前缀 ctrl b 开头:先按前缀,松开,再按表里的键。
| 操作 | 按键 |
|---|---|
| 新建窗口 | ctrl b 然后 c |
| 下一个 / 上一个窗口 | ctrl b 然后 n / p |
| 从列表选窗口 | ctrl b 然后 w |
| 左右分屏 | ctrl b 然后 % |
| 上下分屏 | ctrl b 然后 " |
| 在窗格间切换 | ctrl b 然后方向键 |
| 放大当前窗格 / 还原 | ctrl b 然后 z |
| 关闭窗格或窗口 | 输入 exit |
| 向上翻看历史 | ctrl b 然后 [,用方向键或 pgup 移动,q 退出 |
| 重命名窗口 | ctrl b 然后 , |
| 查看全部快捷键 | ctrl b 然后 ?(q 关闭) |
滑动滚屏。tmux 默认不理会触摸,需要打开鼠标支持。在服务器上运行一次:
echo 'set -g mouse on' >> ~/.tmux.conf && tmux source-file ~/.tmux.conf
之后滑动就能翻看历史,点一下就能切换窗格。
ctrl b 然后 d 是“分离”。在 XFiles 里用不到它:分离后终端会显示“已断开”,要点 ↻ 重新连接才能回去。
10. Zellij 速查
Zellij 用“模式”来组织按键:ctrl + 字母切换模式,底部状态栏随时列出接下来能按什么。esc 或回车回到普通模式。
| 操作 | 按键 |
|---|---|
| 新建窗格 | alt n |
| 窗格模式:新建、向右 / 向下分屏、关闭、全屏 | ctrl p,再按 n、r、d、x 或 f |
| 在窗格间切换 | ctrl p,用方向键,再按 esc |
| 新建标签页 | ctrl t 然后 n |
| 跳到第 1–9 个标签页 | ctrl t 然后数字 |
| 向上翻看、搜索 | ctrl s,方向键或 pgup,s 搜索,esc 退出 |
| 会话管理器 | ctrl o 然后 w |
| 把所有按键交给里面的程序(vim、htop 等) | ctrl g 锁定;再按 ctrl g 解锁 |
ctrl q 会退出 Zellij 并结束整个会话,里面运行的一切都会停止。只是想离开的话,直接关闭 XFiles 终端即可。
Zellij 第一次启动时可能会出现一个简短的设置界面,让你选择按键方案,选 Default 即可。如果它的 ctrl 快捷键和你常用的程序冲突,可以在配置界面(ctrl o 然后 c)改用 Unlock-First 方案。
11. Herdr 速查
Herdr 是为同时盯着多个编程智能体而设计的,以鼠标操作为主:点窗格、标签页、工作区即可切换。键盘前缀是 ctrl b。
| 操作 | 按键 |
|---|---|
| 新建标签页 | ctrl b 然后 c |
| 下一个 / 上一个标签页 | ctrl b 然后 n / p |
| 向右 / 向下分屏 | ctrl b 然后 v / - |
| 工作区 | ctrl b 然后 w |
| 向上翻看(复制模式) | ctrl b 然后 [ |
| 查看全部快捷键 | ctrl b 然后 ? |
12. 多台设备,同一个会话
不需要设置会话名称。连接同一台服务器、同一个用户的每台设备,进入的都是同一个会话,可以在一台上开始、在另一台上接着做:
- tmux:你最近用过的那个会话,不管是在哪台设备上用的。
- Zellij:最新的仍在运行的会话。已结束(标为 EXITED)的会话不会被唤醒。
- Herdr:它的默认会话,也就是你在电脑上直接运行
herdr打开的那个。
在电脑上也能打开同一个会话:
| 在电脑上附加 | 离开时保持运行 | |
|---|---|---|
| tmux | tmux attach | ctrl b 然后 d |
| Zellij | zellij attach(有多个会话时,用 zellij ls 查看名称) | ctrl o 然后 d |
| Herdr | herdr | ctrl b 然后 q |
两块大小不同的屏幕同时看一个 tmux 窗口时,tmux 会按小的那块来排版。在 ~/.tmux.conf 里加上 set -g window-size latest,窗口大小就会跟随你最近操作的那台设备。
13. 彻底结束一个会话
在每个窗口或窗格里输入 exit,或者在服务器上运行(tmux ls 和 zellij ls 可查看会话名称):
tmux kill-session -t 名称
zellij kill-session 名称 && zellij delete-session 名称
herdr server stop
会话里最后一个 shell 退出后,多路复用器随之结束,XFiles 终端会显示“已断开”。点 ↻ 重新连接即可开一个新会话。
14. 常见问题
明明装了,XFiles 却说没装
XFiles 用登录 shell 的方式查找程序。如果你把它装在了特殊位置,并且只在 ~/.bashrc 里把那个目录加进了 PATH,登录 shell 是看不到的。请改在 ~/.profile(或 ~/.bash_profile、~/.zprofile)里添加。想知道 XFiles 能看到什么,可以在任意电脑上运行:
ssh 用户名@服务器 'sh -lc "command -v tmux"'
改好后,在保持会话运行页面点重新检测。
服务器重启后会话不见了
多路复用器的会话保存在内存里,重启就没了。下次连接时 XFiles 会新建一个。tmux-resurrect 这类插件或 Zellij 的会话恢复功能可以把布局找回来。
每次断开连接,会话都会消失
有些服务器会在用户登出时结束其所有进程(/etc/systemd/logind.conf 里的 KillUserProcesses=yes;大多数发行版默认是 no)。请管理员关掉这个选项,或参考 man systemd-run 让多路复用器运行在独立的 scope 里。禁止后台进程的共享主机则根本无法保留会话。
在 tmux 里滑动不能滚屏
打开鼠标支持(见 tmux 速查),或者用 ctrl b 然后 [,再按 pgup。另外确认按键栏上的手形图标是开启状态。
Zellij 抢走了我需要的按键
按 ctrl g 锁定 Zellij:在你再次按 ctrl g 之前,所有按键都会交给里面的程序。也可以改用 Unlock-First 按键方案。
旋转屏幕或弹出键盘后画面错乱
可用空间一变,XFiles 就会调整远端画面的尺寸。如果某个程序没有自动重绘,按 ctrl l。
输入 exit 之后显示“已断开”
exit 关掉了会话里最后一个 shell,会话也就结束了。点 ↻ 重新连接会开一个新的。只是想暂时离开的话,直接关闭终端,不要输入 exit。
XFiles 不能在后台一直保持连接吗?
任何 iOS App 都做不到:系统会挂起后台 App 并关闭它们的连接。要让工作继续,只能靠服务器上的程序,这正是多路复用器的用途。nohup 能让单条命令继续跑,但你回不到它的画面;多路复用器能把整个终端原样还给你。
15. XFiles 在服务器上运行了什么
- 连接时:通过你自己的 SSH 连接启动登录 shell,然后执行第 3 节里的附加命令。
- 检测服务器以及终端里的安装检查:只运行只读命令——
command -v、uname、id -u、读取/etc/os-release里的ID行、查看版本号,以及列出多路复用器的会话。不做任何修改。 - XFiles 从不替你安装软件,安装命令只是展示出来让你复制。
中间没有任何 XFiles 服务器,详见 XFiles Pro 隐私政策。