局域网配置

这是最简单的连接方式。iPhone 通过局域网直接连接 Mac。延迟最低，且无需互联网。

适用场景

• iPhone 和 Mac 在同一 WiFi 网络。
• 你在家中、办公室或任何可信网络。
• 需要最低延迟和最简配置。

步骤 1：检查网络

两台设备必须在 同一 WiFi 网络和子网。可能阻止连接的因素：

• 企业或酒店 WiFi 隔离设备（客户端隔离）。
• 任一设备上的 VPN 改变了网络路径。
• Mac 防火墙阻止了服务器端口的入站连接。

步骤 2：获取 Mac IP

Mac App 菜单栏面板中显示你的 IP。也可以通过命令行查看：

ipconfig getifaddr en0

返回类似 192.168.1.42 的地址。

步骤 3：启动服务器

使用 Mac App 时，点击菜单栏中的 Start Server。默认端口为 8765。

使用独立服务器时：

cd MacServer && npm start

可通过 PORT 环境变量自定义端口：

PORT=9000 npm start

步骤 4：从 iPhone 连接

方式 A：二维码（最快）

• 点击 Mac App 菜单栏中的二维码图标，用 iPhone App 扫描。

方式 B：Bonjour 自动发现

• 服务器通过 Bonjour/mDNS 广播。你的 Mac 会出现在 iPhone App 的服务器列表中。

方式 C：手动输入

• 在 iPhone App 中输入 192.168.x.x 和端口 8765（或自定义端口）。
• 输入 API Key（如已设置）。
• 点击 Connect。

步骤 5：验证

连接成功后，创建或选择会话并发送测试提示。终端输出应在 1-2 秒内出现。

使用提示

• Mac 休眠：Mac App 可在服务器运行时阻止休眠。如果 Mac 在长任务期间进入休眠，请在应用设置中启用此功能。
• 固定 IP：如果 Mac IP 经常变化（DHCP），可以在系统设置 > 网络中分配固定 IP，或使用 Bonjour 自动发现代替手动 IP。
• 防火墙：如果 macOS 防火墙已启用，允许 Tactic Remote App（或独立服务器的 node 进程）的入站连接。