XFiles 使用说明
XFiles 是 iPhone 和 iPad 上的文件管理器。它把设备上的文件夹和服务器上的文件夹放进同一棵树,分成两栏显示;通过 SFTP 连接的服务器还带一个 SSH 终端。
本页讲的是 iPhone 和 iPad 版。在 App 里随时可以从设置 → 使用说明打开它。
先知道这五件事
- 点文件夹,它会在自己那一行下面就地展开;再点一次收起。
- 长按一行,选中它并显示可以做的操作。
- 在 iPhone 上左右滑动切到另一栏。复制和移动会把选中的文件送到那一栏。
- 每一栏最后一行的添加位置,用来添加服务器或其他 App 里的文件夹。
- 在 SSH 终端里,“粘贴”不只能粘贴文字,还能粘贴图片和文件。看具体做法。
浏览文件树
每一栏是一棵树。最上面一层是你的各个位置:本机(XFiles 在这台设备上的存储空间)、从其他 App 添加的文件夹,以及网络位置。
- 点文件夹,在它下面就地展开;再点一次收起。ZIP 这样的压缩包也是这样打开。
- 点文件,打开它。
- 顶部的路径条显示当前位置。点路径中的任意一段,可以跳回那个文件夹。
- 底部工具栏的刷新会重新载入当前文件夹。
设置 → 浏览里有两个开关会改变文件树的行为:
- 显示隐藏文件:显示以点开头的文件名。
- 同层只展开一个:展开一个文件夹时,自动收起它旁边的文件夹,树不会越拉越长。默认是开的;想同时展开几个文件夹,就把它关掉。
双栏
XFiles 有两栏,所以“从哪里复制”和“复制到哪里”可以同时开着。
- iPad 上两栏并排显示。点一下某一栏,就在那一栏里操作。
- iPhone 上向旁边滑一下就是另一栏。顶部的小标签写着另一栏当前打开的文件夹,点它也能切换。
- 选中文件后,工具栏里的复制和移动会直接把它们送到另一栏当前打开的文件夹。如果那个文件夹不可写,按钮会变灰。
想在 iPhone 上只用一栏,关闭设置 → 浏览 → iPhone 双栏。这时复制和移动会先问你放到哪里。
添加服务器和文件夹
点每一栏最后一行的添加位置。
服务器或网盘
- 选网络位置。
- 点协议并选择一种:SFTP (SSH)、FTP、FTPS、WebDAV、Nextcloud、SMB / NAS、S3 对象存储、HTTP 目录、Google Drive、Dropbox、OneDrive、Jellyfin 或 Emby。
- 填好地址和登录信息,点保存。
这个位置会出现在两栏的最上面一层。地址和密码只保存在这台设备上。
要修改或移除,打开设置 → 网络位置。点 ⓘ 进入编辑;向左滑可以删除,删除立即生效,不会动服务器上的文件。
本机或其他 App 里的文件夹
选本地文件夹,在系统的选取界面里选一个文件夹:iCloud 云盘里的、U 盘上的,或者其他 App 共享出来的都可以。它会出现在最上面一层,带已置顶标记。想把它从 XFiles 里移除,到设置 → 置顶文件夹,在它上面向左滑,点取消置顶。文件夹本身不会被删除。
选择、复制、移动、删除
长按一行。这会选中它并打开菜单。对文件来说,菜单里有预览、选择、复制到…、移动到…、分享…、重命名…和删除。继续长按其他行,可以把它们加入选择。这时底部工具栏显示已选数量,以及复制、移动、分享和删除;点 ✕ 清除选择。
复制或移动
- 到另一栏:先在另一栏打开目标文件夹,再选中文件,点工具栏里的复制或移动。
- 到任意文件夹:在长按菜单里选复制到…或移动到…,在位置里一层层点进目标文件夹,再点选取。同一个界面里还有若目标已有同名文件:跳过已有文件、覆盖或保留两者。
如果你没有另选规则,遇到同名文件时会两个都保留,新文件命名为 名称 (1).扩展名。
工具栏上方的小标签显示进度,期间可以继续浏览。点它可以看详情或取消。如果 XFiles 在后台时系统暂停了一次耗时较长的复制,标签会显示已暂停 — 点按继续,继续时从中断的地方接着传。
删除和分享
删除立即生效。XFiles 不会再次确认,也没有废纸篓,删掉的文件无法在 App 里找回。
分享通过系统的分享面板把文件交给其他 App。服务器上的文件会先下载。文件夹不能分享。
新建、重命名、搜索
没有选中任何东西时,底部工具栏有:
- 新建文件夹和新建文件:建在当前文件夹里。新建的文本文件会直接在编辑器里打开。
- 搜索:在当前文件夹及其子文件夹里按名称查找文件和文件夹。至少输入两个字符。点结果可以跳到它。
- 刷新。
- 更多:里面有设置和打开文件夹(等同于“添加位置 → 本地文件夹”)。
重命名…在文件或文件夹的长按菜单里。在网络位置的顶层那一行上,它改的是这个位置保存的名称。
打开和编辑文件
| 文件 | 打开后 |
|---|---|
| 文本和代码 | 文本视图。点编辑,修改后点保存。只有所在文件夹可写时才有“编辑”。 |
| Markdown | 预览或源码。在预览里点任务前面的方框可以勾选,改动会保存到文件。 |
| JSON、JSON Lines | 树状或源码。点一项可以折叠它或查看它的路径;底部有拷贝值和拷贝路径。 |
Claude Code 和 Codex 的会话日志(.jsonl) | 对话把整个会话显示成聊天记录,包括工具调用。树状和源码显示原始日志。 |
| 图片 | 全屏显示。双指捏合缩放;点一下隐藏或显示关闭按钮。 |
| 视频和音频 | 用系统播放器播放。 |
| PDF 和其他文稿 | 系统预览。 |
| 压缩包 | ZIP、7z、RAR、TAR、GZ、BZ2 和 XZ 像文件夹一样打开,把需要的文件复制出来即可。不能往压缩包里复制。 |
其他 App 与“文件”App
- 把东西存进 XFiles:在其他 App 里点“分享”,选 XFiles。内容会存到“本机”。
- 在其他 App 里使用你的服务器:XFiles 是“文件”App 里的一个位置,里面有“本机”、置顶文件夹和可写的网络位置。在任何 App 的存储或打开界面里,选 XFiles,再选里面的文件夹。如果“文件”里没有列出 XFiles,在“文件”的位置列表里把它打开。
SSH 终端 Pro
每个 SFTP 位置都带一个连到同一台服务器的终端。
打开终端
- 长按 SFTP 位置(或它里面的任意一项),点打开终端。
- 或者打开设置 → 网络位置,点那个 SFTP 位置。
顶部的按钮
| ✕(左侧) | 关闭终端。 |
| 回形针 | 添加照片或文件。见下一节。 |
| 输入框(方框加铅笔) | 打开或关闭输入框。 |
| 重新连接(环形箭头) | 重新连接。 |
这些按钮过一会儿会淡出,免得挡住屏幕。双击屏幕顶部可以让它们重新出现。
键盘上方的按键行
- ctrl、alt 和 ⇧(Shift)作用于下一个键:先点 ctrl,再点 c,就是 Ctrl-C。先点 ⇧ 再点 tab 就是 Shift-Tab;⇧ 之后点方向键,发送的是 Shift 加该方向键。
- 长按 alt 可以换行而不发送命令。
- 按住方向键、pgup 或 pgdn 可以连续触发。
- ✋ 决定在 vim、tmux 这类全屏程序里滑动屏幕做什么:像鼠标滚轮一样滚动那个程序,还是选取屏幕上的文字。
- ⌨ 把键盘换成一块符号面板(
[ ] { } < > & # $等)。再点一次换回来。 - 想换键,打开设置 → 终端按键栏:点按按键可更换或移除,按住可拖动调整位置,还可以添加或删除页面。
在屏幕上
- 拖动可以回看之前的输出。
- 双指捏合调整文字大小。XFiles 会记住这个大小。
- 长按选取文字,然后点拷贝。双击可以选中一个词。
- 同一个长按菜单里还有粘贴和草稿。
输入框:先把整行写好
点输入框按钮。之后你是在一个普通的文本框里打字,可以移动光标、修改写错的地方,再点发送执行。它适合长命令、给编程助手写的提示,以及中文、日文、韩文输入。
- 换行键在输入框里另起一行。“发送”会发出文字并按下回车。
- 输入框为空时,“发送”只按一次回车,退格键删除的是服务器那一行上的字符。
- 按键行上的键仍然直接发给服务器,所以 ctrl c、方向键和 tab 照常可用。
草稿:写长文本并留存
长按终端,点草稿。想写多长都行,写完点插入:文字会输入到光标处,但不会按回车。历史记录保留你插入过的草稿,常用的可以置顶。
连接断开时
信号中断或你回到 App 后,XFiles 会自动重新连接。输入 exit 之后它保持关闭,直到你点“重新连接”。普通的 shell 在重连后是全新的;想让程序一直运行,见让终端会话一直运行。
把图片和文件粘贴到终端 Pro
终端只能接收文字,其余的由 XFiles 来做:它把图片或文件上传到服务器,并在光标处输入它的路径。命令,或者在终端里运行的编程助手,就可以按这个路径读取文件。
粘贴
- 在设备上任意位置拷贝一张图片或一个文件:一张截屏、“照片”里的照片、“文件”里的文件。
- 在终端里长按屏幕,点粘贴。如果开着输入框,就在输入框里长按再点“粘贴”。
- 顶部会有一个小标签显示上传进度。随后,带引号的路径出现在光标处。
或者直接选取
点顶部的回形针(开着输入框时,是输入框里的 +),然后选:
- 照片图库:一次最多十张。XFiles 不需要访问你的整个图库。
- 选取文件:“文件”App 能访问到的任何文件。
- 从剪贴板粘贴:剪贴板里有图片或文件时才会出现。
文件去了哪里
- 它通过同一条 SFTP 连接上传到服务器的
/tmp,文件名是xfiles-…-原文件名,只有你的账户可以读取。如果/tmp不能用,会放到你的主目录。 - 每个文件最大 32 MB。
- XFiles 不会替你执行任何东西。路径只是被输入进去,等你按回车,或者在它前后补上命令。
例如,先输入 cp ,粘贴一张照片,再输入目标位置:
cp '/tmp/xfiles-3f9a…-IMG_2041.jpg' ~/site/images/
大多数服务器会不定期清理 /tmp。想保留的文件请移到别处。
让终端会话一直运行 Pro
离开 App 后不久,iOS 就会关闭 SSH 连接,普通 shell 里运行的程序也跟着停掉。在服务器上装一个终端多路复用器(tmux、Zellij 或 Herdr)可以让程序继续运行,XFiles 每次连接时会自动接回去。
在设置 → 网络位置 → ⓘ → 保持会话运行里打开。那个界面会检测服务器上装了什么,并给出安装命令。完整的步骤另有一页:让终端会话一直运行。
端口转发 Pro
端口转发让这台设备打开只有服务器才能访问的服务,比如 NAS 的管理页面,或者跑在 localhost 上的开发服务器。
- 长按 SFTP 位置,点端口转发,再点 +。
- 填远端主机(按服务器看到的地址填;留空表示服务器自己)和远端端口,点保存。
- 打开这条转发的开关。点这一行可以拷贝地址,或者在 App 内的浏览器里打开它。
地址是 127.0.0.1 加这台设备上的一个端口。只要 XFiles 开着,Safari 和其他 App 都可以用它。
免费版与 Pro
- 免费:本机上的全部功能,外加三个任意类型的网络位置。
- XFiles Pro:不限数量的网络位置、SSH 终端和端口转发。
打开设置 → 升级到 XFiles Pro查看各个方案。换了设备或重装之后,用同一界面里的恢复购买。
获取帮助
点设置 → 发送反馈,在一个简短的网页表单里告诉我们你的想法,不需要邮件 App。点联系支持会写一封邮件,里面已经带上 App 和 iOS 的版本号。也可以直接写信到 nearby@local1st.app。