一条 neoserver:// 链接，点一下，NeoServer 自动唤醒、连上服务器、把终端开到你想要的位置—— 可能是某台机器、某个 tmux 会话、或某个目录。

把它存进 Safari 收藏、备忘录、桌面图标、Siri 快捷指令，或 AirDrop 给同事，都能用。

一、终端链接怎么写

所有终端链接长这样：

neoserver://terminal?host=<服务器>&port=<端口>&user=<用户>&tmuxName=<tmux会话>&zellijName=<zellij会话>&workdir=<目录>

⚠️ tmuxName / zellijName / workdir 只能填一个。填了多个，只认 tmuxName， 其次 zellijName，最后 workdir。

照着抄，改成你的就行：

# 最简单：只给 host
neoserver://terminal?host=1.2.3.4

# 指定端口和用户
neoserver://terminal?host=1.2.3.4&port=2222&user=deploy

# 连上直接进 main 这个 tmux 会话
neoserver://terminal?host=1.2.3.4&user=root&tmuxName=main

# 连上直接进 dev 这个 zellij 会话
neoserver://terminal?host=1.2.3.4&user=root&zellijName=dev

# 连上自动 cd 到日志目录
neoserver://terminal?host=1.2.3.4&user=root&workdir=/var/log/nginx

二、连上之后，终端会停在哪

这是终端链接最有用的部分——填不同的参数，连上后终端开到的地方不一样：

为什么要分这三种？

• tmux / zellij 会话：断网、关 App、换手机再连，会话还在，进程不丢。把一台服务器的 tmux 会话分享给同事，两个人能进同一个画面一起排查。
• 目录：你每次连上来都要 cd /opt/app/logs，不如让链接直接把你放过去。

三、在 App 里复制链接（不用手写）

手写链接容易写错。NeoServer 在三个地方能一键复制，复制完粘贴到任意地方即可。

1. 复制「这台服务器」的链接

服务器 tab · 服务器列表 → 在某台服务器上左滑 → Copy Scheme Link

复制出来是：

neoserver://terminal?host=...&port=...&user=...

2. 在终端 quick 模式里复制

终端 tab · 服务器列表（quick 模式）→ 长按某台服务器 → Copy Scheme Link

3. 复制「这个会话」的链接 ⭐ 最有用

终端 tab · 会话列表 → 长按某个会话 → Copy Scheme Link

这条链接会把「连到 X 服务器的 Y 会话」打包进去：

• 这个会话是 tmux → 自动带上 &tmuxName=...
• 这个会话是 zellij → 自动带上 &zellijName=...
• 普通会话 → 只有 host/port/user

复制成功会弹 Link Copied，链接已经在剪贴板。

💡 把一个正在跑的 tmux 会话长按复制发给同事，他用 NeoServer 点开，直接 attach 到同一个会话——你们俩进入同一个终端画面。

四、怎么打开这条链接

neoserver:// 是 iOS 链接协议，任何能点链接的地方都能唤起 NeoServer：

• Safari：粘进地址栏回车，或存进收藏夹点。
• 备忘录 / 提醒事项：存一条，点一下直达。
• 快捷指令：「打开 URL」动作里填链接 → 可绑 Siri 语音、桌面图标、自动化。
• AirDrop：两台 iPhone 互发一条链接，对方点开即连。
• 邮件：把链接当文本发出去，对方复制到 Safari 打开。

📱 真机首次点击 neoserver://，iOS 会弹「在 NeoServer 中打开？」，确认即可，之后不再弹。

五、三个实战场景

🏠 场景 1：把「连生产 tmux」做成桌面图标

你每天都要连生产机的 main tmux 会话。与其每次开 App → 找服务器 → 连 → attach， 不如做成一个图标：

1. App 里复制这台服务器的链接，再手动补上 &tmuxName=main；
2. 打开 iOS「快捷指令」→ 新建 → 加「URL」动作，粘贴这条链接；
3. 加「打开 URL」动作；
4. 点分享 → 添加到主屏幕，起名「连生产」，选个图标。

以后桌面点这个图标，NeoServer 自动连上并进到 main 会话，全程零操作。

🎙️ 场景 2：用语音连

把上面的快捷指令接入 Siri，设一句「嘿 Siri，连生产」。说完手机自动连。

🤝 场景 3：把一个会话丢给同事

1. 终端 · 会话列表 → 长按这个会话 → Copy Scheme Link；
2. 发给同事（AirDrop / 微信都行）；
3. 他用 NeoServer 点开 → 自动 attach 到同一个 tmux 会话。

（前提：他那台 iPhone 上 NeoServer 的服务器库也要能连上同一台 host。）

六、终端链接常见问题

Q：点了链接，连到了错误的服务器？ A：NeoServer 按 host（+ port 若填了 + user 若填了）找服务器。如果你库里有两台 host 相同的服务器，会连第一个匹配的。填上 port 或 user 能精确区分。

Q：库里没这台服务器，点链接会怎样？ A：会跳到「新建服务器」页面，host/port/user 已经帮你填好。你补上密码或私钥 → 保存 → 自动连上，原链接带的会话 / 目录也会照样生效。

Q：链接里能直接带密码，省得每次填吗？ A：不能。 这是安全限制——链接里永远不带密码。就算你手动加 password=xxx 也会被忽略。 密码只走 App 内的钥匙串。

Q：带中文或空格的目录能填进 workdir 吗？ A：能。直接写，比如 workdir=/home/me/my logs。特殊字符 App 会自动处理。 最稳的办法是用 App 复制，而不是手写。

Q：点了没反应？ A：① 确认是 neoserver:// 开头；② 首次会弹「在 NeoServer 中打开」确认；③ 检查 host 没留空；④ App 没在前台也没关系，它会自动唤起。

Q：Android / Windows 能点开吗？ A：不能。neoserver:// 只有装了 NeoServer 的 iPhone / iPad 才认。

七、附：打开通知中心

除了终端，还有一条链接打开通知中心：

neoserver://notifications

桌面通知小组件点进去，走的就是它。