XFiles
XFiles 使用说明

XFiles 使用说明

XFiles 是 iPhone 和 iPad 上的文件管理器。它把设备上的文件夹和服务器上的文件夹放进同一棵树,分成两栏显示;通过 SFTP 连接的服务器还带一个 SSH 终端。

本页讲的是 iPhone 和 iPad 版。在 App 里随时可以从设置 → 使用说明打开它。

先知道这五件事

  1. 点文件夹,它会在自己那一行下面就地展开;再点一次收起。
  2. 长按一行,选中它并显示可以做的操作。
  3. 在 iPhone 上左右滑动切到另一栏。复制和移动会把选中的文件送到那一栏。
  4. 每一栏最后一行的添加位置,用来添加服务器或其他 App 里的文件夹。
  5. 在 SSH 终端里,“粘贴”不只能粘贴文字,还能粘贴图片和文件。看具体做法。

浏览文件树

每一栏是一棵树。最上面一层是你的各个位置:本机(XFiles 在这台设备上的存储空间)、从其他 App 添加的文件夹,以及网络位置。

设置 → 浏览里有两个开关会改变文件树的行为:

双栏

XFiles 有两栏,所以“从哪里复制”和“复制到哪里”可以同时开着。

想在 iPhone 上只用一栏,关闭设置 → 浏览 → iPhone 双栏。这时复制和移动会先问你放到哪里。

添加服务器和文件夹

点每一栏最后一行的添加位置。

服务器或网盘

  1. 选网络位置。
  2. 点协议并选择一种:SFTP (SSH)、FTP、FTPS、WebDAV、Nextcloud、SMB / NAS、S3 对象存储、HTTP 目录、Google Drive、Dropbox、OneDrive、Jellyfin 或 Emby。
  3. 填好地址和登录信息,点保存。

这个位置会出现在两栏的最上面一层。地址和密码只保存在这台设备上。

要修改或移除,打开设置 → 网络位置。点 ⓘ 进入编辑;向左滑可以删除,删除立即生效,不会动服务器上的文件。

本机或其他 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

SSH 终端 Pro

每个 SFTP 位置都带一个连到同一台服务器的终端。

打开终端

顶部的按钮

✕(左侧)关闭终端。
回形针添加照片或文件。见下一节。
输入框(方框加铅笔)打开或关闭输入框。
重新连接(环形箭头)重新连接。

这些按钮过一会儿会淡出,免得挡住屏幕。双击屏幕顶部可以让它们重新出现。

键盘上方的按键行

左右轻扫这一行还有两页:符号页,以及 F1 到 F12 加 ins、del、pgup、pgdn。iPad 或横屏的 iPhone 会并排显示两页。

在屏幕上

输入框:先把整行写好

点输入框按钮。之后你是在一个普通的文本框里打字,可以移动光标、修改写错的地方,再点发送执行。它适合长命令、给编程助手写的提示,以及中文、日文、韩文输入。

草稿:写长文本并留存

长按终端,点草稿。想写多长都行,写完点插入:文字会输入到光标处,但不会按回车。历史记录保留你插入过的草稿,常用的可以置顶。

连接断开时

信号中断或你回到 App 后,XFiles 会自动重新连接。输入 exit 之后它保持关闭,直到你点“重新连接”。普通的 shell 在重连后是全新的;想让程序一直运行,见让终端会话一直运行。

把图片和文件粘贴到终端 Pro

终端只能接收文字,其余的由 XFiles 来做:它把图片或文件上传到服务器,并在光标处输入它的路径。命令,或者在终端里运行的编程助手,就可以按这个路径读取文件。

粘贴

  1. 在设备上任意位置拷贝一张图片或一个文件:一张截屏、“照片”里的照片、“文件”里的文件。
  2. 在终端里长按屏幕,点粘贴。如果开着输入框,就在输入框里长按再点“粘贴”。
  3. 顶部会有一个小标签显示上传进度。随后,带引号的路径出现在光标处。

或者直接选取

点顶部的回形针(开着输入框时,是输入框里的 +),然后选:

文件去了哪里

例如,先输入 cp ,粘贴一张照片,再输入目标位置:

cp '/tmp/xfiles-3f9a…-IMG_2041.jpg' ~/site/images/

大多数服务器会不定期清理 /tmp。想保留的文件请移到别处。

让终端会话一直运行 Pro

离开 App 后不久,iOS 就会关闭 SSH 连接,普通 shell 里运行的程序也跟着停掉。在服务器上装一个终端多路复用器(tmux、Zellij 或 Herdr)可以让程序继续运行,XFiles 每次连接时会自动接回去。

在设置 → 网络位置 → ⓘ → 保持会话运行里打开。那个界面会检测服务器上装了什么,并给出安装命令。完整的步骤另有一页:让终端会话一直运行。

端口转发 Pro

端口转发让这台设备打开只有服务器才能访问的服务,比如 NAS 的管理页面,或者跑在 localhost 上的开发服务器。

  1. 长按 SFTP 位置,点端口转发,再点 +。
  2. 填远端主机(按服务器看到的地址填;留空表示服务器自己)和远端端口,点保存。
  3. 打开这条转发的开关。点这一行可以拷贝地址,或者在 App 内的浏览器里打开它。

地址是 127.0.0.1 加这台设备上的一个端口。只要 XFiles 开着,Safari 和其他 App 都可以用它。

免费版与 Pro

打开设置 → 升级到 XFiles Pro查看各个方案。换了设备或重装之后,用同一界面里的恢复购买。

获取帮助

点设置 → 发送反馈,在一个简短的网页表单里告诉我们你的想法,不需要邮件 App。点联系支持会写一封邮件,里面已经带上 App 和 iOS 的版本号。也可以直接写信到 nearby@local1st.app。