Android 应用

在 Android 手机上，客户端是一个应用。加入中枢之后，中枢发布的网页、端口、AI 网关、共享、终端和远程桌面，都能在手机上打开。应用只连中枢的 8443，手机在家在外用法相同。

怎么装、怎么扫码加入中枢，见安装客户端。

中枢

竖屏时，屏幕底部一排按钮依次打开 中枢、网页、端口、AI、文件、终端、远程桌面 和 设置。横屏时，以及宽度至少 720 dp 的平板上，这一排换成左边的侧栏。

中枢 屏上一行是一台中枢：名字、状态行、地址和它运行的软件包版本。连上以后，状态写出通道走的路，例如 已连接 · 局域网，旁边的标签是往返时间，例如 35 ms。

已连接 · 直连 表示手机从外面直接连上了中枢开放的地址，见打开直连。已连接 · SSH 中继 表示手机连的是一台服务器上的公网端口，服务器归中枢的主人，见 SSH 中继。

没连着时，状态行只有一行，写成“状态词 · 动作”。拨号时写 连接中…。停下来时，状态词写原因，· 后面写怎样结束，例如 证书不符 · 60 秒后重试。倒计时每秒走一次，到 0 时变回 连接中…。自动重拨的间隔从 5 秒起，每失败一轮翻倍，最长 60 秒。

每个状态词的原因和处理，桌面客户端和手机相同，见故障排查。

手机在移动网络和 Wi-Fi 之间切换时，应用马上重拨每台中枢，倒计时作废。右上角的刷新按钮也这样做；连着的中枢马上回一份完整的状态。写着 已被替换 或 已停用 的行，网络变化和刷新都不改动它。

圆点在连着时是绿色，拨号时是闪动的黄色，倒计时或等中枢时是黄色，要你动手时是红色。从没连上过的中枢停下来时，圆点是灰色。

离开与重新连接

一行上的 离开 按一次变成 再按一次离开，五秒内再按，手机才离开这台中枢。手机删掉这台中枢的链接和密钥，它在手机上的转发和共享随之结束。

状态行写着 已被替换 时，这一行上多一个 重新连接。选它，手机把这台中枢要回来。

面板

中枢在 客户端 页给了这部手机 免密码进入中枢面板 时，这一行上有 面板。选它，面板在手机浏览器里打开，打开时已经登录。打不开时，原因写在这一行上。

虚拟网

中枢发布了 NetBird 或 EasyTier，而且允许这部手机用虚拟网时，中枢那一行下面多一行 虚拟网。要加入这个网络：

1. 在这一行上选 连接。
2. 第一次连接时，Android 弹出 VPN 连接请求，在里面选 确定。

这一行先写 连接中…，下面写 正在登录 加引擎名，取消 能停下它。引擎拿到地址后，这一行写 已连接 · 加手机在网络里的地址，按钮变成 断开。失败时这一行回到 未连接，原因写在下面，见故障排查。

EasyTier 用控制台模式时，登录之后这一行仍写 连接中…，下面写手机已登记到控制台。控制台的主人把手机挂到一个网络上，这一行才变成 已连接。

手机同一时间只在一台中枢的网络里。一台中枢的网络没断开时，其他中枢的 连接 变灰；先在那台中枢的虚拟网行上选 断开。中枢两种引擎都发布时，按钮旁边有一个选择框，这一行写着 未连接 时能换引擎。

转发

转发是应用为一个条目在手机 127.0.0.1 上开的端口。所有转发和所有中枢连接都在应用的一个前台服务里运行，切到别的应用时照常工作。这个服务的通知写着已连接几台中枢。

网页 和 端口 屏上，行里的 配置 设定 本地端口：

• 自动：条目自己的端口空闲时用它，否则从 20000 往上找一个。
• 指定：用你填的号，范围 1024～65535。

同一个号可以 TCP 用一次，UDP 再用一次。条目转发着时 配置 变灰。转发行上的各个原因见故障排查。

网页

网页 屏列出各中枢发布的网址：Gitea、VS Code、code-server、CloudCLI、Codeg，以及中枢 服务 页上声明的网址。

在一行上选 打开。应用为这个条目开好转发，在手机浏览器里打开 127.0.0.1 上的页面。断开 关掉转发。

端口

端口 屏列出中枢发布的每个端口，地址写的是服务在中枢网络上的位置。

1. 在条目上选 连接。这一行后面多出 → 127.0.0.1: 和本地端口，按钮变成 断开。
2. 选 复制，把这个回环地址粘进手机上要用它的应用。

UDP 条目写成 host:port/udp，复制 复制的地址不带 /udp。经中枢转发的 UDP 适合 DNS、校时这类量小的流量，原因见 UDP 端口。

AI

AI 屏上，每个运行 AI 网关的中枢有一行。

1. 选 连接，网关转发到手机上。
2. 从两行地址里选一行，按它的 复制。
3. 按 此客户端的密钥 右边的 复制。
4. 把地址和密钥填进手机上支持 OpenAI 接口的应用。

标签	地址
应用自己会加 /v1 时用这个	回环地址，末尾不带 /v1
应用要求地址带 /v1 时用这个	同一个地址，末尾加 /v1

密钥默认藏着，点输入框里的眼睛按钮显示。这一行下面写着 只有这个客户端开着时，工具才连得到网关。 应用开着这个转发时，回环地址才连得上。

文件

文件 屏把中枢发布的每个共享，变成 Android “文件”应用里的一个位置。还没存密码的共享，行上带 未存密码。

1. 在共享上选 在“文件”中打开。
2. 选或填 共享用户名，再填 共享密码。
3. 保持勾选 记住，密码存进 Android Keystore；不勾选的话，应用进程退出后密码就没了。
4. 选 连接。应用先用这组登录试连共享，成功后在“文件”里打开它。

在“文件”应用的侧栏里，这个位置以共享名命名，下面一行写着中枢和机器。里面的文件能打开、写入、新建和删除，视频边读边放。中枢断线时，这个位置在“文件”里再留 60 秒，标着正在重新连接。

没存密码的共享在“文件”里打不开，这时照上面的步骤重新填。行上的 忘掉密码 按一次变成 再按一次以忘掉，再按一次，存着的密码才删掉。

终端

终端 屏在受管机器上开一个 shell。中枢要允许这部手机打开终端。

1. 在上方的机器里选一台，绿色圆点表示它在线。
2. 选 新终端。

键盘上方一行补上手机键盘缺的键：Esc、Tab、Ctrl、Shift、Alt 和四个方向键。修饰键按一下亮起，作用在下一个键上。在 shell 上长按，弹出 复制、粘贴 和 清屏。

持久 开关打开后，手机不连着时机器仍保留这个会话。应用再启动时，持久的标签页回来，先写 已断开，正在等待中枢，连上后接回会话。它的 × 按一次变成 再按一次结束，再按一次，机器上的 shell 才结束。

远程桌面

远程桌面 屏打开受管机器共享出来的桌面。那台机器在面板 模块 页上打开 远程桌面 共享后，条目出现。

1. 可选：在条目上选 配置，在 画面 对话框里选 编码 和 画质，再选 保存。
2. 选 连接。

查看器占满整个屏幕，系统的状态栏从屏幕边缘划出来。

右上角一直有三个圆按钮：

按钮	作用
键盘	弹出或收起手机键盘
特殊键	显示按键条：Esc、Tab、Ctrl、Shift、Alt、Win、粘贴 和方向键
断开	结束这次远程桌面

键盘弹出时画面大小不变，键盘盖住画面的下半部分。用两指拖动和缩放，去看键盘盖住的地方。

设置

在 设置 屏上选 语言 和 主题，再选 保存。关于 卡片列出手机的名字和平台、应用的版本和 AGPL-3.0 许可证，以及应用携带的每个核心。