局域网部署

目标

让一台机器运行 VILab，局域网内其他机器调用它的 /v1/* 接口。

推荐方式

• 一台机器运行 VILab 桌面宿主
• 这台机器负责管理 Provider 与 external API key
• 其他内部应用使用各自独立的 external API key

把服务绑定到局域网

内嵌服务会绑定到 Server URL 里的主机和端口。

宿主机推荐配置：

http://0.0.0.0:8765

客户端访问时请使用宿主机的真实局域网 IP 或主机名，例如：

http://192.168.1.24:8765

防火墙与可达性

• 放行服务端口的入站 TCP 流量
• 确认局域网其他机器可以访问宿主机 IP
• 只在可信内网开放该服务

在另一台机器上检查健康状态

curl http://192.168.1.24:8765/health

鉴权模型

• /health 不需要 API key
• /v1/* 需要 Authorization: Bearer <external_api_key>
• /admin/* 需要 Authorization: Bearer <adminKey>

当前实现里 adminKey 仍可访问 public 接口，但这不是推荐用法。正常集成请只发 external API key。

Key 签发规则

建议按以下粒度分别签发：

• 项目
• 脚本
• 设备
• 集成方

推荐命名：

• web-dashboard-prod
• ios-prototype-lab
• robot-gateway-01

当前范围之外

这一阶段还没有：

• 用户账号
• 团队登录
• Key scope
• Key 过期时间
• 按 Key 限流

这些属于后续安全增强，不是第一阶段自托管局域网可用性的前置条件。