边车
一些功能——语音、视频、网络搜索、无头浏览器——并不是网关本身的一部分。它们作为运行 边车: 网关访问的小型独立 HTTP 服务 通过 URL. 每个边车都是 免费且本地: 它们背后没有任何强制付费的 API。
侧车是什么
Sidecar 是一个独立的进程,提供 HTTP API。网关从不将其链接进程或在进程中运行它——它只是调用你配置的 URL。每个 sidecar
- 在……下运行 它自己的 systemd 单元 (宿主原生,不含容器),
- 通过环境变量连接到网关,并且
- 可以 本地安装在网关旁边,或指向现有的 实例 你已经去别处跑了。
因为合同只是 HTTP,无论 sidecar 是否开启,相同的配置都适用 localhost 或者在另一台主机上。
[!NOTE] 边车是可选的——只有一个例外:网页搜索(SearXNG)和 反检测浏览器(CloakBrowser)是开箱即装的。它们的载荷随签名的 安装程序捆绑包一起提供并离线安装。 用安装程序标志
--no-search和--no-browser关闭它们。 其他任何功能只有在配置了其 URL 时才会激活;最小安装 仍然只是网关加上 PostgreSQL。
边车及其端口
| 港口 | 边车 | 由……支持 | 力量 | 连接有 |
|---|---|---|---|---|
| 8001 | 语音转文字 | 更快的耳语 | 语音转文字 | AIHUMMER_STT_URL |
| 8002 | 文字转语音 | edge-tts | 文本转语音 | AIHUMMER_TTS_URL |
| 8005 | 视频 | ffmpeg | 视频理解 | AIHUMMER_VIDEO_URL |
| 8888 | SearXNG | SearXNG | 这 web_search 工具 |
由安装程序安装,设置隐藏;外部实例—— --external-search=URL |
| 9222 | Chrome / CDP | Chrome(CDP) | 这 browser 工具 |
由安装程序安装,设置隐藏;外部实例—— --external-browser=URL |
语音旁车是开箱即用的路径:STT(:8001) 提供代理轮次和 TTS (:8002)在自由/本地引擎上都能说出答案。视频理解(:8005) 是一个额外的、可选择的 sidecar。SearXNG (:8888) 背部 web_search,以及一个 Chrome/CDP 端点(:9222) 支持 browser 工具。
接线边车
你将网关对准每个边车进行匹配 目录设置 — 来自管理员界面 (管理 → 设置) 或者与 aihummer settings set. gateway.env 仅限于 Bootstrap,对于这些密钥会被忽略。对于主机本地安装,语音辅助程序(STT/TTS)已经为你配置;网页搜索和浏览器由安装程序自己接线——你永远不用设置它们的地址,它们也不显示在设置中;其余的根据需要启用。
# Voice in/out (auto-configured by the installer for STT/TTS)
aihummer settings set AIHUMMER_STT_URL http://127.0.0.1:8001
aihummer settings set AIHUMMER_TTS_URL http://127.0.0.1:8002
# Optional video sidecar
aihummer settings set AIHUMMER_VIDEO_URL http://127.0.0.1:8005
[!TIP] 因为每个边车只是一个 URL,你可以将大型服务集中管理。让 多个网关指向一个共享的 STT/TTS 实例,而不是每台主机运行 一份副本;对于搜索和浏览器,安装程序标志
--external-search=URL和--external-browser=URL起同样的作用。
本地运行它们或共享运行
每个 sidecar 都在主机上的其自己的 systemd 单元下运行,所以你可以像操作其他服务一样操作它——独立于网关启动、停止和读取日志。如果你已经运行了比如 SearXNG 或 Chrome/CDP 端点,就给安装程序传 --external-search=URL 或 --external-browser=URL:不会安装本地副本,网关会改为调用你的实例。对于语音和视频,把对应的设置指向现有实例。无论哪种方式,网关的视图都是相同的:一个它可以调用的配置 URL。
[!WARNING] 这
browser(CDP) 和web_search工具连接到网络。开启 强化或隔离部署审查出口和隔离设置 在启用它们之前——网关只会调用你连接的边车。