MangoTart 是无屏设备，需要从另一台手机或电脑的浏览器管理。首次设置使用有线网络，这样无需 captive portal、临时热点、蓝牙或外接键盘，就能稳定加入网络。
网络要求
你需要：
- 能通过 DHCP 分配地址的路由器或网络；
- 首次设置时可用的网口；
- 可访问模型、消息平台、网站、更新、外部工具和可选云端备份的互联网连接；
- 与 MangoTart 在同一局域网的手机或电脑。
普通家庭或小型办公室网络最简单。访客网络、client isolation、独立 VLAN、企业认证和部分 mesh 设置，会阻止同一地点的设备互相访问。
第一次连接
- 用包装内网线连接 MangoTart 和路由器。
- 接上官方电源。
- 等待约一分钟，让设备和本地服务启动。
- 在同一局域网的手机或电脑打开标签上的地址，例如
http://mango-abc-def.local。
这是 mDNS／.local 局域网地址，不是公开网站，只能从能访问同一网络的设备打开。
.local 地址打不开
使用查找 MangoTart页面：
- 输入设备上的
MT-XXXXXXXX设备码。 - 页面会显示最近上报的局域网 IP 和 hostname。
- 保持手机或电脑在同一局域网，再打开该链接。
返回的是你网络内部地址。页面显示它，并不会让这个地址从公网可访问。
仍打不开时，检查：
- 手机是否正在走移动数据，而不是同一 Wi‑Fi。
- 网线是否接到访客、隔离或 WAN-only 端口。
- 路由器是否开启 AP/client isolation。
- 手机与 MangoTart 是否处于互相不可达的 VLAN／子网。
- VPN、Private Relay、防火墙或受管网络策略是否拦截局域网。
- 路由器是否尚未分配地址；再等一分钟后重试。
查找页面不是远程访问
查找页面只是帮助已经在同一局域网的浏览器定位 MangoTart，不会通过 MangoTart 服务器中转管理台，也不会把它暴露到公网。
初始化后切换 Wi‑Fi
- 在本地管理台打开 WiFi。
- 如有提示先设置无线地区；地区未设置时可能扫描不到网络。
- 扫描并选择网络，输入密码。
- 确认页面显示已连接。
- 新连接可用后再拔掉网线。
Hostname 通常不变，但局域网 IP 可能变化。优先使用 .local 地址或再次使用查找页面，不要长期收藏旧 IP。
界面支持开放 Wi‑Fi，但保存模型凭证、浏览器 session 和个人 agent 状态的设备不应长期放在不可信公共网络。
使用 Mac 互联网共享
没有路由器时，Mac 可以通过以太网共享互联网。USB-C 转网口适配器接在 Mac 侧，MangoTart 直接使用自带网口。开启 Mac 的互联网共享、连接网线，再从 Mac 打开 .local 地址。
酒店和公共网络常有 captive portal 或客户端隔离，不适合作为长期无人值守 agent 环境。
离家后访问
当前管理台 仅限局域网，不会暴露在公网，机主通过 Tailscale 远程打开管理台也还不是现有产品功能。
但 agent 仍可在你离家后工作：
- 已连接的消息平台可以通过互联网收发对话；
- 定时任务可以继续执行；
- 浏览器和工具任务在外部服务可用时仍可运行。
只是你回到同一局域网前无法打开管理页面。如果任务等待批准、供应商重新登录或设备维护，它可能暂停到你回来。
网络安全
- 保持管理 PIN 和管理台锁定，尤其是在共享网络。
- 不要在路由器把管理台端口转发到公网。
- 使用可信私人局域网，不要长期依赖访客或公共 Wi‑Fi。
- 保持 agent 命令审批开启。
- MangoTart 支持另有管理员维护路径，详见隐私、安全与权限。
设备离线时
Agent 任务需要电源、局域网、互联网、可访问的模型供应商，以及任务所需的外部服务。任何一层中断，任务都可能失败或等待。消息平台可能短暂保留入站消息，但 MangoTart 不保证断网期间的持续投递。
完整恢复步骤见故障排查。