AiHummer
中文
登录帐户
v1.1.x
{ }Swagger

边车

v1.1.x · 已更新 2026-07-05

一些功能——语音、视频、网络搜索、无头浏览器——并不是网关本身的一部分。它们作为运行 边车: 网关访问的小型独立 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 工具连接到网络。开启 强化或隔离部署审查出口和隔离设置 在启用它们之前——网关只会调用你连接的边车。

接下来去哪儿