XFiles
XFiles 让终端会话一直运行

让终端会话一直运行

在 iPhone 和 iPad 上,只要离开 App,SSH 连接就保不住,连接里运行的程序也会跟着停掉。在服务器上装一个终端多路复用器(multiplexer)就能解决:程序在服务器上继续跑,XFiles 每次连接都会自动接回去。

这份教程从“为什么会断”讲起,帮你在 tmux、Zellij、Herdr 里选一个,装到服务器上,在 XFiles 里打开,并学会在手机键盘上操作它。适用于 iOS 版 XFiles Pro 中 SFTP 位置的 SSH 终端。

两分钟快速上手

  1. 在服务器上安装 tmux,例如 Debian / Ubuntu:sudo apt install tmux。
  2. 在 XFiles 里:设置 → 网络位置,点 SFTP 位置右侧的 ⓘ,再点保持会话运行,选 tmux,返回后点保存。
  3. 打开终端。之后你可以随意切换 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 都没法把它找回来。办法只能放在服务器上。

2. 多路复用器做了什么

终端多路复用器是跑在服务器上的程序,由它来“拥有”你的 shell。SSH 连接变成了看进去的一扇窗:窗关了,屋子还在,里面的东西照常运行。重新连上,看到的还是同一个画面,连你不在时滚过去的输出都在。

它还带来一些在小屏幕上很顺手的功能:一条连接里开多个窗口或标签页、分屏、可搜索的历史记录,以及从电脑上打开同一个会话。

3. XFiles 帮你做了什么

给位置选好多路复用器后,你不需要再敲任何 attach 命令。每次连接(包括自动重连),XFiles 都会:

4. tmux、Zellij 还是 Herdr?

tmuxZellijHerdr
适合所有人,最稳妥。新手:按键提示一直显示在底部。同时跑多个 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 OSsudo apt update && sudo apt install -y tmux
Fedora、RHEL、Rocky、Almasudo dnf install -y tmux
Arch、Manjarosudo pacman -S tmux
Alpinesudo apk add tmux
openSUSEsudo zypper install tmux
FreeBSDsudo 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。其他情况:

系统命令
Archsudo pacman -S zellij
Alpinesudo apk add zellij
装了 Homebrew 的 macOS 或 Linuxbrew 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 里打开

  1. 打开设置 → 网络位置。
  2. 点 SFTP 位置右侧的 ⓘ。(还没有位置?点 +,用服务器地址和 SSH 账号添加一个。)
  3. 在 SSH 终端一栏,点保持会话运行。
  4. XFiles 会登录服务器检测一遍。每个选项会显示已安装及版本号,或未安装,其中一个标为推荐。
  5. 点你要用的那个。如果它没装,页面会给出适合这台服务器的安装命令,带复制按钮。
  6. 返回,点保存。

也可以从终端里开启。位置还在用普通 shell 时,第一次打开它的终端、以及断线后 shell 被换成新的时候,XFiles 会弹出一张提示卡片。点去设置会打开同一个页面;保存后 XFiles 会询问是否立即重新连接,让设置马上生效。

7. 第 3 步:一分钟验证

  1. 打开终端,你应该能看到多路复用器的界面:tmux 在底部有一条绿色状态栏;Zellij 顶部是标签栏,底部是按键提示。第一次接上时,XFiles 还会提示tmux 正在保持会话运行(或 Zellij、Herdr)。
  2. 运行一个需要时间的命令,比如计数器:
    for i in $(seq 1 600); do echo "$i"; sleep 1; done
  3. 切到别的 App,或者锁屏,等一分钟。
  4. 回到 XFiles。它会自己重新连接,计数器还在继续数;你离开期间打印的数字都在历史记录里。

如果计数器没了、只剩一个新的提示符,说明多路复用器没有启动。这种情况 XFiles 会显示黄色卡片,请看常见问题。

8. 在手机上按出组合键

多路复用器靠 ctrl、alt 组合键操作。XFiles 在键盘上方加了两排按键:

图中蓝色的是 ctrl、alt 和 ⇧(Shift)。✋ 切换滑动模式,⌨ 把键盘换成符号面板。左右轻扫按键栏可切换到符号、F1–F12 和翻页键;在“设置 → 终端按键栏”里可以重新排列。

想离开时不需要按任何多路复用器的键:直接关闭终端或切换 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. 多台设备,同一个会话

不需要设置会话名称。连接同一台服务器、同一个用户的每台设备,进入的都是同一个会话,可以在一台上开始、在另一台上接着做:

在电脑上也能打开同一个会话:

在电脑上附加离开时保持运行
tmuxtmux attachctrl b 然后 d
Zellijzellij attach(有多个会话时,用 zellij ls 查看名称)ctrl o 然后 d
Herdrherdrctrl 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 在服务器上运行了什么

中间没有任何 XFiles 服务器,详见 XFiles Pro 隐私政策。