企业官网建设流程全解析

AIRI 怎么通过连接设置让其他设备控制桌面端：WebSocket 地址、TLS 与访问令牌

【免费下载链接】airi💖🧸 Self hosted, you-owned Grok Companion, a container of souls of waifu, cyber livings to bring them into our worlds, wishing to achieve Neuro-sama's altitude. Capable of realtime voice chat, Minecraft, Factorio playing. Web / macOS / Windows supported.项目地址: https://gitcode.com/GitHub_Trending/ai/airi

如果您想让手机等其他设备接入同一局域网内的 AIRI 桌面端（例如从 AIRI Pocket（口袋）版连接桌面主端），需要配置桌面端设置里的「连接」页：填入 WebSocket 服务器地址、按需要启用安全 WebSocket（WSS/TLS）、把服务暴露到本地网络，并让其他设备用访问令牌（配对令牌）或扫描配对二维码完成配对。以下操作基于 AIRI 说明书（对应版本 AIRI-0.11.3）。

打开桌面端的「连接」设置

「连接」用于配置 AIRI 的服务通道，即 WebSocket 服务器地址、加密传输（TLS）与访问令牌，页面会提供二维码方便其他设备连接。桌面端有两种打开方式：

1. 在主窗口点击「展开 ⌃」，然后选择「打开设置」。
2. 右键系统托盘中的 AIRI 小图标，选择「设置」。

进入设置界面后，在左侧九大内容中选择「连接」。在部分早期版本中，主窗口右上角还有一个「websocket 状态」选项，点击它也可以直接打开连接设置。

配置 WebSocket 服务器地址

在「WebSocket: 服务器地址」中填入 WebSocket 服务器的完整地址，界面给出的示例为ws://localhost:6121/ws。这个地址是本应用连接本地服务器时使用的地址，填写前先确认本地服务已按实际端口运行。

需要加密传输时启用安全 WebSocket（WSS）

「启用安全WebSocket (WSS)」开关用于开启 WSS（WebSocket Secure），以便在开发模式下允许移动设备（Pocket）连接 HTTPS，启用后会自动生成一个自签名证书。仅在需要加密传输时开启。

::: tip macOS 可能需要管理员验证 启用安全 WebSocket 时，AIRI 会将本地证书加入 macOS 登录钥匙串，系统会弹出 System Certificate Trust Settings 的授权提示，要求使用 Touch ID 或输入 Mac 登录密码。验证指纹或输入 Mac 登录密码以继续；选择取消则证书不会写入钥匙串。 :::

允许局域网设备接入并设置访问令牌

「是否暴露在连接的网络下（WiFi，有线）」决定允许哪些设备与 AIRI 进行配对，有三个选项：

• 仅此设备：只允许当前设备与 AIRI 配对，其他设备无法接入。
• 本地网络所有人：允许来自其他本地网络的设备连接到此服务器。要让其他设备接入，需要选择此项。
• 高级配置：展开高级主机名（Bind Hostname）选项，按说明书说明该高级主机名目前暂不可用。

令牌配置位于「认证凭据」：

• 「配对令牌」供其他设备使用它来与服务器配对；如果此字段为空，AIRI 会自动生成一个令牌。
• 界面会给出备选连接地址列表，并提示二维码中已包含配对令牌。

安全边界说明书中有明确要求：仅在受信任的网络中开放局域网访问，并妥善保管访问令牌；二维码包含配对令牌，请勿公开分享此二维码。令牌属于服务凭据，和 API Key 一样只应保存在您的设备中，不要提交、截图或发送给他人。

让其他设备通过二维码或令牌连接

配对完成后，桌面端会显示「从 Pocket（口袋）版配对」区域，其中包含配对二维码和「备选连接地址」：

1. 展开「从 Pocket（口袋）版配对」区域，查看配对二维码。
2. 在移动应用中使用「快速连接」功能，将相机中心位置对准配对码，点击「扫描」。
3. 移动应用会尝试每个本地地址，并保存第一个可用地址；配对成功时界面显示「连接地址已更新」，并提示当前已配对到的 AIRI 主端地址（界面文案为“现在配对到的 AIRI 主端 {url}”，{url} 为实际配对地址）。

如果二维码无法生成，页面会显示「二维码暂不可用 / 无法生成配对二维码」；移动端扫描失败时显示「二维码扫描失败 / 扫描或连接二维码失败」，可回到桌面端点击「刷新」重新生成二维码后再试。

限制与说明

• 「本地网络所有人」与访问令牌、二维码都属于桌面端能力，用于让同一局域网内其他设备配对；不在受信任网络中不要开放。
• 高级配置中的 Bind Hostname（高级主机名）按说明书说明暂不可用。
• 接口文案以 AIRI 当前版本为准：界面中「WebSocket 服务器地址」「Enable Secure WebSocket (WSS)」「Expose On Network」「Auth Token」等英文文案与上文中文选项一一对应。

相关设置界面与说明可继续参考 说明书·连接一节 与界面文案定义 settings.yaml。

【免费下载链接】airi💖🧸 Self hosted, you-owned Grok Companion, a container of souls of waifu, cyber livings to bring them into our worlds, wishing to achieve Neuro-sama's altitude. Capable of realtime voice chat, Minecraft, Factorio playing. Web / macOS / Windows supported.项目地址: https://gitcode.com/GitHub_Trending/ai/airi