安装

安装 QuickTUI 服务端

两种路径装好服务端，加上完整安装参数、手势速查与镜像说明。

两种安装路径

能 SSH 的机器 → App 向导。

在 iOS App 里添加服务器，选"快速设置"，填入 SSH 凭据。App 自动帮你装好服务端，全程不用开终端。

不能 SSH？直接到机器上跑。

curl -fsSL https://quicktui.ai/q.sh | sh

irm https://quicktui.ai/q.ps1 | iex

把上面那行命令复制到电脑终端运行即可。一分钟搞定。

中国镜像入口。

curl -fsSL https://dl.quicktui.cn/q.sh | sh

这是面向中国用户的并列入口。已通过 quicktui.ai/q.sh 安装的服务不会自动迁移; 重新执行 dl.quicktui.cn/q.sh 后才会走 OSS 自动更新。

Windows 电脑？PowerShell 里跑一行。

irm https://quicktui.ai/q.ps1 | iex

自动下载安装器、自动安装 qscn 会话后端，并注册登录时自启的计划任务。中国镜像入口将在 qscn 资产镜像完成后支持 Windows。老旧 Windows PowerShell 5.1 若未启用 TLS 1.2，在同一行前面加上 [Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor 3072; 即可。

配对 App，或用浏览器。

在电脑上运行 quicktui-server --pair-qrcode，然后在 App 里点 + → 扫描。桌面环境下可加 --browser，用系统默认浏览器打开二维码。写入 QR 的公开地址可用 --list-addr 或 --addr <host:port|URL> 指定。安装完成后也可随时运行 quicktui-server --welcome 重开配对向导。
浏览器用户：访问 http://<host>:8022，粘贴一次 access token（浏览器登录仍用服务端 token；App 扫码配对使用短期 pairing code，不粘贴该 token）。

设备配对运维。

列出或撤销已配对设备，无需重启服务：

quicktui-server --list-paired-devices
quicktui-server --revoke-device <device_id>

--rotate-server-identity 会轮换服务端 E2E identity 并清空全部配对；执行前必须先停止服务。仅在你打算让所有设备重新配对时使用。

安装脚本参数

非交互式安装、自定义端口、环境检查。通过 sh -s -- 传入：

curl -fsSL https://quicktui.ai/q.sh | sh -s -- -y --port 9000

手势操作

在手机或 iPad 上驾驭终端的方式。部分单指 / 双指动作可以在设置里互换。