SSH、SFTP 与远程工具

你可以

• 用 搜索主机… 搜索：可匹配名称、主机名和标签。
• 用分组胶囊按钮筛选：全部，然后每个分组和子分组各有一个胶囊按钮（分组的胶囊按钮包含其子分组）。管理分组 会打开分组管理器。
• 选中某个分组后，全部连接 (N) 会连接该分组及其子分组中的每台主机。
• 加星标的主机列在 收藏 下，其余的列在 所有主机 下。
• 点按主机即可连接。每张卡片的菜单里有 连接、收藏、编辑 和 删除。
• 添加主机 打开表单；快速 打开 快速连接。
• 在分组管理器中，新建分组 需要填写 名称、父分组、主题(由主机继承) 和 自动录制会话：该分组及其子分组中的主机一连接就会开始会话日志（LOG 标记）。删除分组 会让其中的主机变为无分组。

你不能，以及原因

• 在免费版通过任何入口保存第二台主机：添加主机、快速连接、导入（JSON、SSH 配置、CSV）和云实例导入都会在 1 台已保存的主机处停下，并显示 Terminal Pro 提示页。上限是 1 台已保存的主机。Pro
• 给整个分组设置代理、默认身份或环境变量：分组上只能设置主题和 自动录制会话。尚未提供

你可以

• 连接：可选的 标签、主机名、端口（默认 22）和 用户名。
• 身份验证 → 验证方式：密码、密钥对 或 键盘交互。密码以加密方式保存；编辑主机时该字段显示 （未更改）。
• 选择 密钥对 时，从 SSH 密钥 中选一个密钥（设备绑定的密钥有标记），或选择 手动粘贴 并粘贴私钥，如果有 密钥口令 也一并填写。设备绑定密钥不会显示口令字段。
• 选择 键盘交互 时，服务器会在连接过程中询问它需要的内容，例如一次性验证码：连接过程中将提示您输入。
• 使用身份 会用已保存身份中的用户名和凭据填写表单；保存为身份 会保存当前的这些内容。身份是复制到主机里的模板，不是实时链接：之后修改身份，不会改变已经使用过它的主机。
• 组织：选择一个 分组，并添加以逗号分隔的 标签。
• 高级：代理 / 跳板主机，可选 SOCKS5 或 HTTP 代理（主机和端口）；跳板机，即用作堡垒机的另一台已保存主机，最多 3 跳，你有另一台已保存的主机后才会出现；以及 Agent 转发 开关。
• 选择一个 颜色，并给主机加星标作为收藏。

你不能，以及原因

• 给主机设置启动命令或已保存的端口转发：表单里没有对应字段，而且从表单保存主机会把这两项清空。尚未提供
• 单独使用 SSH Jump Host 胶囊按钮：它是为旧数据保留的，没有任何作用。真正起作用的跳转是 跳板机 列表。尚未提供

你可以

• 在 连接字符串 中输入 user@host 或 user@host:port；IPv6 地址要放在方括号中，user@[::1]:22。预览会显示用户、主机和端口。
• 在 密码（可选） 中输入密码，然后点按 连接。文本中包含 @ 之前，按钮一直是关闭状态。
• 连接之前，如果套餐还有空位，主机会先保存到 主机 中。在免费版已有 1 台已保存主机时，它仍会连接，但新主机不会被保存，并会打开 Terminal Pro 提示页。

你不能，以及原因

• 用密钥或一次性验证码连接：快速连接创建的始终是 密码 主机，没有密码时标签页会显示 Error: No password stored for this host。密钥和 键盘交互 请使用 添加主机。尚未提供

你可以

• 查看 主机、密钥类型 和 指纹（SHA256: 格式），并与你的服务器显示的指纹进行比对。
• 新服务器会显示 验证主机密钥：信任并连接 会保存密钥并继续；拒绝 则取消。
• 如果已保存的密钥与服务器的密钥不同，对话框标题会变成 主机密钥已更改！，显示 先前的指纹，并警告可能存在中间人攻击。只有确定服务器重装或重新配置过时，才可以继续。
• 如果 60 秒内没有回应，连接会被拒绝。

你不能，以及原因

• 查看或移除受信任服务器的列表：没有对应的界面。你可以通过导入 known_hosts 文件来添加条目。尚未提供

你可以

• 在对应的 响应 N 字段中回答每个提示（文字会按服务器要求隐藏或显示），然后点按 提交。取消 会放弃这次尝试。
• 你有 120 秒的时间作答。

你不能，以及原因

• 保存答案：每次连接都会重新询问。有意为之

你可以

• 通过 设备绑定 标记识别设备绑定的密钥。
• 用系统文件选择器从手机上 导入 私钥文件；文件名会成为标签。
• 生成密钥 创建新的密钥对（见下一节）。
• 复制公钥 把公钥放到剪贴板。
• 部署 会把公钥追加到当前会话所在服务器的 ~/.ssh/authorized_keys 中，目录权限为 700，文件权限为 600，目录不存在时会创建。会话打开时才会出现该按钮。命令执行后，标签页会输出 [Key deployed to authorized_keys]；PocketCode 不会检查命令的结果，所以请事后试一下这个密钥。
• 删除 会移除密钥；对于设备绑定的密钥，还会把它从 Android Keystore 中删除。

你不能，以及原因

• 复制或部署导入密钥的公钥：应用不会为导入的密钥保存公钥（卡片上显示 imported 而不是指纹）。导入的密钥只能用于签名连接。尚未提供
• 导出设备绑定密钥的私钥：它永远不会离开 Android Keystore。有意为之

你可以

• 填写 密钥标签，并选择 密钥类型 及其 位数：RSA（2048 或 4096，默认选中 4096）、ED25519（256）、ECDSA（256、384 或 521）、DSA（1024）或 DEVICE-BOUND。
• 可以为私钥添加可选的 口令（DEVICE-BOUND 不支持）。
• DEVICE-BOUND 会在 Android Keystore 内创建一个 ECDSA P-256 密钥。私钥无法导出、复制或同步，只有公钥会离开手机。签名前需要最近的生物识别/PIN验证 默认开启：此时密钥只会在你通过生物识别或设备 PIN 验证后的 30 秒内签名。连接时 PocketCode 自己不会显示验证提示。

你不能，以及原因

• 在另一部手机上使用设备绑定密钥，或从备份中恢复它。设备

你可以

• 长按标签页会打开 重命名、复制会话（针对来自已保存主机的标签页）和 关闭其他标签页（有多个标签页时）。
• 关闭仍处于连接状态的标签页时会询问 关闭活动会话？：关闭会断开连接，并停止它的端口转发。关闭其他标签页 总是会询问。
• 网络恢复后，PocketCode 会自动重新连接已断开的会话。开关在 设置 → 终端 → 终端自动重连，默认开启。标签页会输出 [Network connection lost]，之后输出 [Network restored — reconnecting…]。

你不能，以及原因

• 在免费版同时打开多个会话：再打开一个标签页、连接第二台主机、复制会话 和 多路复用 Shell 都会显示 Terminal Pro 提示页。上限是同一时间 1 个活动的 SSH 会话；终端界面上的本地 Shell 单独计数。Pro
• 不借助 Android 就让会话在后台持续运行：除非把 PocketCode 排除在电池优化之外，否则切换应用时 Android 可能会暂停或中断 SSH 会话和端口转发。应用会提示一次：让 SSH 会话在后台保持连接 → 打开设置。设备

你可以

• 多路复用 Shell 在同一个 SSH 连接上再打开一个 shell，放在名为 <host> (mux) 的新标签页中。
• 广播 会把你输入的每条命令同时发送到所有已连接的标签页；已连接的本地 shell 标签页也会收到。开启期间会显示 BROADCAST 标记，点按 广播关闭 即可停止。

你不能，以及原因

• 在免费版使用 广播：会显示 Terminal Pro 提示页。Pro
• 在宽屏上从停靠面板访问 广播 和 多路复用 Shell：它们只在工具菜单中，而停靠布局会隐藏该菜单。把窗口缩窄到约 660 dp 以下，或者开启分屏（Pro），就能让菜单回来。有意为之

你可以

• 浏览服务器：先显示文件夹，再显示文件，每一行都带有权限，文件还带有大小。点按文件夹即可打开，用返回箭头回到上一级。
• 新建文件夹，以及在每行的 更多选项 菜单中 重命名 或 删除。
• 长按某一行开始选择，再点按以添加更多项目，然后一起删除。系统会询问 删除已选择的 N 项？此操作无法撤销。 每个项目是单独删除的，所以某一项失败不会影响其余项目。
• 双栏视图 会切换到双面板布局。

你不能，以及原因

• 在这个视图中下载、上传或打开文件：点按文件没有任何反应，只有文件夹能打开。尚未提供
• 删除仍有文件的文件夹：文件夹是通过 SFTP 的 rmdir 调用删除的，所以要先清空它。有意为之
• 查看操作失败的原因：错误不会显示。无法读取的文件夹看起来是空的（此目录为空），重命名或删除失败后列表保持原样。尚未提供

你可以

• 本地 面板从存放你的项目的文件夹开始；远程 面板从 / 开始。点按文件夹即可打开，用面板顶部的箭头回到上一级。
• 用 单栏视图 返回。

你不能，以及原因

• 通过拖动在两个面板之间复制文件：该页面提供了这个操作，但放下操作还没有接入传输功能，所以不会复制任何内容。尚未提供

你可以

• 查看排队中的传输（等待中、已完成、失败），取消其中一个，或用 清除已完成 清掉已结束的。

你不能，以及原因

• 向队列中添加传输：应用中目前没有任何功能会往里发送文件，所以它始终显示 没有进行中的传输。尚未提供

你可以

• 点按 附加文件 并选择一个文件：它会通过 SFTP 上传到服务器的 /tmp/<file name>，路径会被输入到输入栏中，方便你接着输入下一条命令。

你不能，以及原因

• 选择目标位置或保留已有的文件：文件总是放到 /tmp，同名文件会被覆盖。有意为之

你可以

• 添加规则 会打开一个表单：类型（本地 (L)、远程 (R) 或 动态）、标签、本地端口、远程主机（预设为 localhost）、远程端口 和 自动启动。
• 本地 (L) 在你手机的某个端口上监听，并通过服务器把流量发送到 远程主机 的 远程端口（以服务器的视角解析）。例如，通过 localhost:5432 访问服务器上的数据库。
• 远程 (R) 在服务器的 远程端口 上监听，并把流量发送到 远程主机 的 本地端口，从你的手机去访问（默认是 localhost）。例如，对外暴露运行在手机上的开发服务器。
• 每条规则会显示 活动 或 已停止；可以启动、停止或删除它。
• 关闭标签页或断开连接，会结束该会话的转发。

你不能，以及原因

• 在免费版同时使用超过 1 条规则（按当前所在的会话计算）。Pro
• 把 动态 当作 SOCKS 代理使用：这条规则的标签是 SOCKS 代理，并记录 SOCKS5 proxy on localhost:N，但应用实际是把该端口原样转发到同一端口号的 localhost，并不是 SOCKS5 代理。尚未提供
• 在多次会话之间保留规则：规则不会随主机一起保存，所以下次连接时 自动启动 没有可启动的内容。尚未提供

你可以

• 新建连接：协议 VNC（端口 5900）或 RDP（3389）、标签、主机、端口、用户名（RDP）和密码、画质级别以及 仅查看。
• Conectar 会直接连接到该主机和端口（不经过 SSH），完成 VNC 握手（无需验证，或使用 VNC 密码），并在新标签页中输出 Connected: 以及服务器的名称和屏幕尺寸，还会输出服务器发来的任何提示音或剪贴板文本。

你不能，以及原因

• 查看或控制远程屏幕：连接会读取屏幕更新然后丢弃，没有视图，也没有鼠标或键盘输入。尚未提供
• 使用 RDP：选择 RDP 运行的是同一套 VNC 代码，并没有 RDP 客户端。尚未提供

你可以

• 查看 已检测到的设备，即 Android 报告的 USB 设备。
• 添加配置：设备（空 = 自动）、波特率（默认 115200）、数据位（8）、停止位（1）和一个名为 Paridad 的校验位菜单（Ninguna、Impar、Par、Mark、Space）。该菜单以及 Guardar 和 Cancelar 按钮无论应用使用什么语言，都是西班牙语。
• 已保存配置上的播放按钮用于连接：它会通过 Android 的 USB 主机 API 查找设备，打开它的串行数据接口并设置线路编码；成功后标签页会显示 Connected to …。
• 第一次连接时，Android 会弹出自己的对话框，询问是否允许使用该 USB 设备（标签页会输出 Requesting USB permission for <device>…）。允许后连接继续；PocketCode 最多等你 60 秒。

你不能，以及原因

• 在拒绝 USB 权限，或对话框 60 秒内没有回应之后仍然连接：标签页会输出 USB permission not granted for <device>，会话以错误结束。再次点按播放按钮即可重试。设备
• 使用没有暴露带批量端点的 CDC 或厂商自定义数据接口的适配器：标签页会输出 USB device does not have expected CDC serial endpoints。设备

你可以

• 点按某个胶囊按钮，即可在当前会话所在的服务器上运行该服务商的 CLI（aws ec2 describe-instances、gcloud compute instances list、az vm list、doctl compute droplet list、kubectl get pods、docker ps）。服务器上必须已安装该 CLI。标签页会输出 [Cloud discovery (AWS): N bytes received]。
• 导入实例（JSON）：粘贴一个 JSON 数组，例如 [{"provider":"AWS","name":"…","publicIp":"…"}]。每个带有 IP 地址的实例都会保存为主机（用户 root、端口 22，并标注其服务商标签），出现在 实例（N） 下，并带有 连接 按钮。在免费版，只有放得进 1 台主机上限的实例才会保存为主机，但所有实例仍会出现在 实例（N） 中；其余的会打开 Terminal Pro 提示页。

你不能，以及原因

• 自动导入实例：发现功能只会输出 CLI 返回了多少字节，不会把输出转换成实例。JSON 必须手动粘贴。尚未提供
• 不先添加凭据就连接导入的实例：导入的主机是没有保存密码的 密码 主机。请编辑主机，添加密码或选择密钥。尚未提供

你可以

• 添加看门狗：标签、命令（预设为 systemctl is-active nginx）、期望输出（预设为 active）和 间隔（秒）（预设为 60）。
• 用开关启动或停止监控，也可以删除它。第一次检查在一个间隔之后运行。
• 每次检查都会在你启动监控时所在的会话中运行该命令。如果输出不包含预期文本（忽略大小写），标签页会输出 ⚠ Watchdog alert: <command> → <output>，并把该监控标记为失败。

你不能，以及原因

• 在免费版创建看门狗。Pro
• 收到系统通知：警报只是终端标签页中的一行文字，而且监控只在应用运行时才会工作。有意为之
• 把监控绑定到某一台主机：它会在你启动时所在的任意会话上运行。有意为之

你可以

• 创建 webhook：名称、选择主机 和 命令。每个 webhook 都会显示它的链接 pocketcode://terminal/webhook/<id>?secret=<secret>（在屏幕上被遮盖，旁边有复制按钮），以及 活动 / 非活动 开关、N 次执行 和 删除。
• 当有东西打开这个链接时，PocketCode 会检查 id 和密钥。只有 webhook 处于开启状态且两者都匹配，才会询问 要执行此自动化吗？（有链接请求在 HOST 上执行规则「X」。）。运行 会连接到主机并发送命令；取消 则什么也不做。密钥错误则完全没有任何回应。

你不能，以及原因

• 在免费版创建 webhook。Pro
• 无人值守地运行 webhook：每次触发都会先征求你的确认。有意为之
• 从网页触发 webhook：只有 pocketcode:// 链接。应用不会在你的手机上打开监听端口来在你的服务器上运行命令。有意为之

你可以

• 列出主机上已安装的软件包（它会读取 pkg list-installed，失败时再读取 dpkg -l，只保留已安装的），用 搜索软件包… 搜索，并刷新。
• 全部更新（apt update && apt upgrade -y）、列出全部、清理（apt autoclean）和 安装（询问 输入软件包名称： 并运行 apt install <name> -y）。
• 对某个软件包：查看其信息（apt show）和移除（apt remove <name> -y）。

你不能，以及原因

• 使用其他软件包管理器（yum、dnf、apk……）：命令固定为 apt。尚未提供
• 自动用 sudo 运行命令：命令会以你的 SSH 用户身份原样运行，所以在该用户不是 root 的服务器上可能会因权限错误而失败。有意为之

你可以

• 同步 会生成一份备份，包含你的主机、代码片段和一些终端设置；要同步的数据 下的开关决定包含哪些内容。上次同步 显示它运行的时间。
• 你账户中的连接（与这份备份是不同的路径）：在设置的 设置同步 对话框中打开 启用同步（云同步，Pro 功能）并勾选 连接（SSH/DB） 后，保存、编辑、加星标或删除主机会把它的信息发送到你的 PocketCode 账户：名称、地址、端口、用户名、认证类型、标签、收藏、分组、代理和代理转发设置。密码、密钥、密钥口令和启动命令仍留在手机上。通过 JSON、SSH 配置或 CSV 导入的主机不会被发送。同一个选项也会带上数据库模块的连接，但只带它自己更精简的信息（名称、主机、端口、引擎和分组），绝不包含用户名或密码。云同步关闭，或该选项未勾选时，不会发送任何内容。
• 端到端加密 → 启用加密 会要求设置一个 主密码，并用 AES-256-GCM 加密备份，密钥由该密码派生（PBKDF2，100,000 轮）。一旦丢失将无法恢复。

你不能，以及原因

• 在另一台设备上取回已同步的主机：应用会保存下载下来的列表，但没有任何功能会把它变成主机。尚未提供
• 把这份备份同步到另一台设备或云端：备份会写入应用内的一个文件（terminal_sync_backup.json），不会上传任何内容；应用也没有办法从中恢复。尚未提供
• 包含 SSH 密钥：虽然有 SSH 密钥 开关，但备份中从不包含密钥。尚未提供

你可以

• 创建房间：为它起一个 房间名称，并分享它显示的 6 位数验证码。
• 加入房间：会在本地网络中发现附近的房间，或者你输入 6 位数验证码。房主会看到 新的加入请求（N 想要加入），并点按 接受 或 拒绝。
• 成员列表会显示每个人的角色：只读、读写 或 管理员。房主可以更改角色和移除成员；任何人都可以 离开房间，房主可以 关闭房间。
• 设备之间的流量是加密的（ECDH 密钥协商和 AES-GCM）。在 Android 13 及更高版本上，第一次创建房间、查找房间或加入房间时，Android 会请求附近设备（本地网络）权限；在你授予之前，这三项操作都会保持被阻止。

你不能，以及原因

• 在房间中共享主机或代码片段：提示语说要创建或加入房间才能实时共享，但目前只有成员和角色可以使用。尚未提供
• 在本地网络之外使用房间：发现和连接都仅限局域网。需要网络
• 在应用重启后保留房间：房间只在活动期间存在。有意为之

你可以

• JSON 中包含你的主机（名称、地址、端口、用户名、验证类型、标签、颜色、收藏和启动命令）、你的分组（名称、颜色、图标）以及你自己的代码片段，不含预置的片段。

你不能，以及原因

• 导出密码、密钥或设置：它们永远不会出现在 JSON 中。导回时会重新创建分组，但不会把主机放回分组里。尚未提供
• 用密码加密导出内容、保存为文件或显示为二维码：文本是明文，复制和粘贴是唯一的导入导出方式。尚未提供

你可以

• JSON：上面导出的内容。已保存的主机（主机名、端口和用户名都相同）会被跳过。
• SSH 配置：每个 Host 块会变成一台主机；带通配符模式的块（例如 Host *）会被跳过。带有 IdentityFile 的块会变成一台没有密钥的 密钥对 主机，ProxyJump 在指向已存在的主机时会变成 跳板机。
• known_hosts：明文条目会变成受信任的服务器；哈希条目（OpenSSH 的默认格式）无法还原，会被跳过。
• CSV：需要有表头行。可识别的列：label（或 name）、hostname（或 host、address）、port、username（或 user）和 group（或 folder）；只有 hostname 是必需的。分组按名称查找，找不到则新建。

你不能，以及原因

• 从文件或二维码导入：该页面只接受粘贴的文本。尚未提供
• 导入密码或密钥：没有任何格式携带它们，所以导入的主机需要在 编辑主机 中补充凭据。有意为之