Do I need a public server?

No. LinkShell includes a built-in CLI gateway for local network use. A public server or the official gateway is only needed for cross-network access.

Which AI agents does LinkShell support?

LinkShell terminal mode supports Claude Code, OpenAI Codex, Gemini, GitHub Copilot, and custom shell processes. Agent Workspace auto-detects Claude Code and Codex providers.

Where can I download the mobile app?

The iOS app is available on the App Store. Android APK builds are available from GitHub Releases.

Does LinkShell support remote desktop and port forwarding?

Yes. LinkShell can stream your desktop with the --screen option and can forward development server ports for mobile preview.

> LinkShell v1.0 现已发布

终端漫游，随时随地，自由接管

本地终端桥接 + Agent Workspace。长耗时任务留在高性能桌面上，用手机接管 PTY、Claude Code 与 Codex 对话。

🚀 Pro 订阅用户可直接使用官方 Gateway，无需自建服务器。了解更多 →

🎉 限时免费网关开放中：linkshell start --gateway wss://zkiwacrrxzaj.sealosbja.site/ws

立即部署查看仓库

Android 下载 App Store 下载

只需三步，建立你的终端链路

[1] 安装 CLI

一条命令全局安装。内置网关开箱即用，无需额外部署服务器。

# 全局安装 CLI $ npm i -g linkshell-cli # 初始化配置 $ linkshell setup # 检查环境 $ linkshell doctor ✓ All checks passed

[2] 启动桥接

一条命令启动内置网关、桥接 AI 终端，并自动开放 Agent Workspace channel。

同一局域网内，CLI 内置网关直连，零配置。

$ linkshell start Built-in gateway started on port 8787 LAN address: http://192.168.1.10:8787 ➜ Code: 847293

先在公网服务器部署网关，本地 CLI 连接远程网关。

# 服务器端：启动网关 $ linkshell gateway --daemon Gateway listening on 0.0.0.0:8787 # 本地：连接远程网关 $ linkshell start --gateway wss://gw.example.com Connected to remote gateway Public address: https://gw.example.com ➜ Code: 293847

Pro 订阅用户直接使用官方托管 Gateway，一条命令登录即可连接。

# 登录 iTool 账号 $ linkshell login Opening browser for login... ✓ Logged in as user@example.com (Pro) Available gateways: [1] Official Gateway (Asia) wss://gw.linkshell.app/ws [0] Skip Connect to gateway [1]: 1 ✓ Bridge started in background (PID 12345) Open the LinkShell app on your phone to connect.

限时免费公网网关，无需登录、无需自建服务器，直接连接体验。

# 直接连接免费网关 $ linkshell start --gateway wss://zkiwacrrxzaj.sealosbja.site/ws Connected to free gateway ➜ Code: 519382

[3] 手机扫码，即刻接管

打开 LinkShell App（iOS / Android），对准终端二维码扫一扫，立刻接管会话。

> scanning QR... > pairing code: 847293 > connected to session #1 > control acquired

原生的终端体感，去中心化的控制。

> 本地 PTY 驱动

繁重的计算过程完全依赖本地机器。保留颜色、光标、readline 输出及信号等完整终端语义。

> 全平台客户端

支持 React Native / Expo 移动端与 Web 页面调试端。统一协议同时承载终端、Agent、桌面和 Browser 预览。

> 强一致性同步

独有的单控制者防冲突模型。避免多端并抢焦点，画面精准对齐不串流。

> 远程桌面

不只是终端。加上 --screen 参数，在手机上实时查看电脑桌面。WebRTC 30fps 丝滑体验，自动降级到截图流兜底。

linkshell start --daemon --provider claude --screen

> 端口转发预览

远程启动 dev server，手机直接预览页面。支持 CSS/JS/图片完整加载、HMR 热更新、PC/手机视图切换和全屏模式。

# 远程终端启动 dev server $ npm run dev ➜ Local: http://localhost:3000 # App 切换到 Browser 标签，输入端口 3000，即可预览

Agent Workspace，让 AI 触手可及

Agent 标签结构化展示 Claude Code 与 Codex 对话。模型、权限、推理强度随 CLI capabilities 动态同步。

┌─ Agent Workspace ───────────────────────┐ │ Claude Code · Sonnet · workspace_write │ ├─ timeline ─────────────────────────────┤ │ tool: npm test PASS · file: App.tsx +12 │ ├─ permission ───────────────────────────┤ │ Run `git push`? [deny] [approve] │ └────────────────────────────────────────┘

结构化时间线 — 消息、计划、tool call、命令执行和文件变更一屏呈现

权限审批 — 在手机上直接允许、拒绝或回复补充输入

动态能力 — provider 模型、权限模式和推理强度由 CLI 下发

恢复历史 — 本地缓存对话与 timeline，重连后自动同步快照

项目空间，并行掌控

每个会话支持多项目并行。选择项目文件夹，独立执行命令，像在本地一样自如。

$ linkshell status Session #3 | 2 projects active PROJECTS linkshell-app ~/projects/linkshell-app [████████░░] 85% api-server ~/projects/api-server [██████░░░░] 60% ml-pipeline ~/projects/ml-pipeline [████░░░░░░] 40% TERMINALS [1] linkshell-app $ npm test PASS 12/12 [2] api-server $ cargo build Compiling...

多项目并行 — 同一会话内切换不同项目目录

独立终端 — 每个项目拥有独立的命令执行环境

最近项目 — 智能记忆常用项目，一键直达

实时状态 — 并行任务进度一览无余

LinkShell 工作流

不仅是远程命令行桥接；更是打破工位束缚的极客探索。

01. 挂起并离开

编译、构建、拉镜像... 常驻任务在桌面上飞速运转。你可以去喝杯咖啡，LinkShell 默默守护当前状态。

02. 随时审查

随时掏出手机接入会话。审查构建进度，翻看彩色日志输出，体验不到任何画面的延迟衰减。

03. 直接修正

发现报错？内置 xterm.js 拿过焦点，敲下修复命令，然后再次从容地把手机放回口袋。

文档

从安装到部署，你需要知道的一切。

01 架构概览

LinkShell 采用三层架构：本地 CLI 捕获 PTY 输出，通过网关中继转发，最终在移动端渲染完整终端。所有计算留在本地，手机只是一个远程窗口。

┌──────────────────┐ ┌──────────────────┐ ┌──────────────────┐ │ CLI (Host) │ <─ WS ─> │ Gateway │ <─ WS ─> │ Mobile App │ │ │ │ │ │ │ │ PTY Bridge │ │ Session Relay │ │ xterm.js Render │ │ Screen Share │ │ Pairing Service │ │ QR Pairing │ │ Scrollback Buf │ │ Control Rights │ │ Multi-Gateway │ └──────────────────┘ └──────────────────┘ └──────────────────┘

02 CLI 命令参考

linkshell start

启动桥接会话。自动启动内置网关，桥接 AI 终端，开放 Agent Workspace，并生成配对二维码。

FLAGS --daemon 后台守护模式运行 --provider 指定终端 provider (claude / codex / gemini / copilot / custom) --agent-ui 启用 Agent Workspace --screen 启用远程桌面共享 --port 指定网关端口 (默认 8787)

linkshell gateway

单独启动网关服务器。适用于独立部署网关到远程服务器的场景。

FLAGS --port 指定监听端口 --host 指定绑定地址 --daemon 后台守护模式运行

linkshell setup

交互式初始化配置。引导你完成网关地址、AI 提供者等基础设置。

linkshell doctor

环境诊断工具。检查 Node.js 版本、依赖完整性、网络连通性等。

linkshell status

查看当前运行状态。显示活跃会话、网关连接状态和守护进程信息。

linkshell stop

停止守护进程。优雅关闭桥接会话和内置网关。

linkshell login

登录 iTool 账号。浏览器跳转授权后自动保存凭证，Pro 用户可直接选择官方 Gateway 连接。

linkshell logout

退出登录，清除本地凭证。

linkshell list

列出官方 Gateway 上你的活跃会话。需要先登录。

03 部署方式

根据你的网络环境选择合适的部署方式。

本地直连（最简单）

CLI 内置网关，同一局域网内手机直连电脑。零配置，开箱即用。

$ npm i -g linkshell-cli $ linkshell start --daemon

手机和电脑需在同一 Wi-Fi 下

无需任何服务器，开箱即用

延迟最低，数据不出局域网

远程服务器 [推荐]

将网关部署到公网服务器，配合 Nginx 反向代理 + HTTPS，跨网络访问。

# 服务器端 $ linkshell gateway --daemon # 本地 $ linkshell start --gateway wss://your.server

Docker 部署

使用 Docker Compose 一键部署网关。最低要求 1 核 512MB 内存。

$ docker compose up -d

支持跨网络、4G/5G 随时接入

推荐 Nginx 反代 + Let's Encrypt HTTPS

数据仅经过你自己的服务器中继

官方托管 Gateway [Pro]

订阅 iTool Pro 即可使用官方托管的 Gateway，无需自建服务器。登录后自动连接，手机 App 自动发现会话。

# 登录 $ linkshell login ✓ Logged in as user@example.com (Pro) ✓ Bridge started in background # 查看会话 $ linkshell list ✓ Official Gateway (Asia) └ ● a1b2c3d4 — claude · my-project · just now

零配置，登录即用，无需部署服务器

手机 App 登录后自动发现会话，无需扫码

订阅到期自动断开，数据不留存

限时免费网关 [限时]

限时开放的免费公网网关，无需登录、无需自建服务器，一条命令直接体验跨网络连接。

# 直接连接免费网关 $ linkshell start --gateway wss://zkiwacrrxzaj.sealosbja.site/ws

无需登录、无需注册，直接使用

支持跨网络访问，体验与 Pro 一致

限时开放，随时可能关闭

04 远程桌面

启动时加上 --screen 参数，App 端会出现 Desktop 标签页，实时查看电脑桌面。

$ linkshell start --daemon --provider claude --screen Screen sharing enabled Mode: WebRTC (30fps) | Fallback: Screenshot stream

WebRTC 模式 — 默认以 30fps 实时推流桌面画面，延迟极低

截图流兜底 — 网络条件不佳时自动降级为截图流模式，保证可用性

自动切换 — 无需手动配置，运行时根据网络质量自动选择最优方案

App 端切换 — 在 App 内切换 Terminal / Desktop 标签，随时查看桌面

05 端口转发

在远程终端启动 dev server 后，直接在手机上预览页面。通过 Gateway 中继 HTTP 请求，支持完整的 Web 应用预览。

# 远程终端启动 dev server $ npm run dev ➜ Local: http://localhost:3000 # App 切换到 Browser 标签（globe 图标），输入端口 3000 ➜ Preview: http://gateway:8787/tunnel/{sessionId}/3000/

完整加载 — HTML、CSS、JS、图片等所有资源通过 tunnel 代理

HMR 支持 — WebSocket 热更新自动转发，Vite / Next.js / webpack 均可

视图切换 — 一键切换 PC / 手机视图，桌面模式以 1024px 宽度渲染

全屏预览 — 隐藏所有 UI，沉浸式查看页面效果

需要 linkshell-cli ≥ 0.2.53 / gateway ≥ 0.2.17

06 协议与可靠性

40+

消息类型 (Zod)

ACK

双层缓冲确认

1000

回滚缓冲区

15s

心跳检测

可靠性保障

指数退避自动重连（CLI 和 App 双端）

会话持久化（主机断连后保持 60 秒）

空闲会话 30 分钟自动清理

协议版本协商，向前兼容

控制模型

单控制者模型，防止多端输入冲突

控制权请求 / 释放 / 转移机制

6 位配对码 + QR 码安全配对

CORS 和速率限制保护

07 常见问题

Q: 需要公网服务器吗？

不需要。CLI 内置网关，同一局域网内手机可以直连电脑。如果需要跨网络访问，才需要将网关部署到公网服务器。

Q: 支持哪些 AI 代理？

终端模式支持 Claude Code、OpenAI Codex、Gemini、GitHub Copilot 和任意自定义 Shell 进程；Agent Workspace 会自动检测 Claude Code 与 Codex。

Q: 手机 App 在哪里下载？

iOS 版本已上架 App Store，Android 版本可从 GitHub Releases 下载 APK。

Q: 数据安全吗？会经过第三方服务器吗？

本地直连模式下数据完全在局域网内传输。远程模式下数据经过你自己部署的网关中继，不经过任何第三方服务器。

Q: 远程桌面功能如何工作？

使用 --screen 参数启动后，通过 WebRTC 以 30fps 实时传输桌面画面。网络条件不佳时自动降级为截图流模式。

Q: 官方 Gateway 是什么？和自建有什么区别？

官方 Gateway 是 LinkShell 团队托管的公网网关，订阅 iTool Pro 即可使用。无需自建服务器，登录后一键连接。手机 App 登录同一账号后自动发现会话，无需扫码。自建网关则完全独立，不依赖任何第三方服务。

选择你的方案

免费使用全部核心功能。升级 Pro 解锁官方托管 Gateway，随时随地连接。

Free

$0

永久免费

内置网关（局域网直连）
终端桥接 + 二维码配对
Claude / Codex / Gemini / Copilot / 自定义
远程桌面（WebRTC）
端口转发预览
自建网关部署

开始使用

POPULAR

Pro ⚡

$1 /mo

¥9.9/月（爱发电）

Free 全部功能
官方托管 Gateway
App 自动发现会话（免扫码）
多区域节点
优先技术支持

常见问题

Q: 免费版有什么限制？

没有功能限制。免费版包含所有核心功能，只是需要自建网关。Pro 提供官方托管网关，省去部署和维护。

Q: 可以随时取消吗？

可以。PayPal 订阅可随时取消，取消后在当前周期结束前仍可使用。

Q: 支持哪些支付方式？

国际用户推荐 PayPal（支持信用卡），国内用户可使用爱发电（支持微信/支付宝）。

Buy Me a Coffee

如果 LinkShell 对你有帮助，可以请作者喝杯咖啡。