北京祺智科技 知识库
知识库 / Aegis AI网关
🕸关系图谱

运维与常见问题 FAQ

状态
标题 · 目录 · 标签 · 摘要（自动填写，可展开查看/修改）
基于后台配置的 AI 模型（智谱 GLM 等）
标题
目录
标签（逗号分隔）
摘要
阅读 6 · 最后更新 2026-06-26
运维FAQ健康检查故障排查

健康检查（validate / production-check）、状态与日志查看、升级注意，以及默认密码、架构选择、WAN≠LAN、写卡设备、Docker DHCP 等常见问题速查。

运维与常见问题 FAQ

健康检查与状态

sudo aegis-gateway --config /etc/aegis/aegis.conf validate
sudo aegis-gateway --config /etc/aegis/aegis.conf production-check
sudo systemctl status aegis-gateway.service --no-pager
  • validate：校验配置语法/一致性；production-check：上线前生产环境检查；
  • 控制台「内核日志」可查看系统日志；AI 异常先看「AI 服务」用量与拒绝统计。

常见问题

Q：控制台进不去？ A：确认从 LAN 侧访问 http://192.168.8.1 或正确的部署主机地址/端口；Web 端口由 web-serve --bind 决定。

Q：默认密码安全吗？ A：root/123456 只适合出厂/离线/首登录。上线后立即修改。

Q：选 aarch64 还是 x86_64？ A：arm64 主机用 aarch64，amd64 主机用 x86_64；选错无法运行。

Q：完整网关启动失败？ A：完整网关模式 WAN 与 LAN 必须是不同物理接口或 VLAN 子接口；先 validate 再 production-check。

Q：写卡 / 刷机失败？ A：写卡时 /dev/sdX 必须是实际 microSD（写错会毁本机磁盘）；eFlasher 仅适用于带 eMMC 的设备，未写入时用 lsblk 确认 eMMC 并查串口/eFlasher 日志。

Q：Docker 模式没分到 IP？ A：docker-egress 默认 dhcp=disabled（由现网路由器负责 DHCP）；需 host network 运行，并核对 wan/lan/DNS/出口节点。

Q：业务应用要持有上游大模型密钥吗？ A：不需要。应用只用网关签发的客户端 API Key 访问 /v1/chat/completions，上游 Provider 密钥只在网关侧。

Q：怎么用流式响应？ A：请求体设 "stream": true，服务返回 text/event-stream。