ARTICLE DETAIL

建站实战干货

来自一线的建站与推广经验沉淀,每一条都经过真实交付验证。

Weave Router 模型路由器两种部署模式深度对比:selfhosted 与 managed 的 8 个关键差异

2026/9/16 20:35:02 拓冰建站 浏览量
Weave Router 模型路由器两种部署模式深度对比:selfhosted 与 managed 的 8 个关键差异 Weave Router 模型路由器两种部署模式深度对比selfhosted 与 managed 的 8 个关键差异【免费下载链接】routerModel router for agentic systems. Routes every prompt to the right model in 50ms. Cut costs 40-70% with just an endpoint change.项目地址: https://gitcode.com/GitHub_Trending/router101/routerWeave Router 是一个面向 Agent 系统的开源模型路由器model router只需把 Claude Code、Codex、opencode 的端点指向它每个 prompt 都会在 50ms 内被路由到最合适的模型官方宣称可降低 40–70% 的成本。它有两种部署模式——selfhosted自托管与managed托管由启动时的环境变量ROUTER_DEPLOYMENT_MODE决定默认是 selfhosted。这篇指南带你逐条对比 8 个关键差异帮你 10 分钟选对方案。一张表看懂两种模式的核心定位维度selfhosted自托管managed托管默认值✅ 是变量未设置时需显式设置运行位置你自己的服务器 / 本地 DockerWeave 云平台SaaS典型命令make full-setupnpx weave-os/router控制台内置/ui/*仪表盘独立控制平面不挂载密钥管理环境变量数据不出本机平台统一管理模式判断逻辑在 cmd/router/main.go读取ROUTER_DEPLOYMENT_MODE只接受这两个值其他取值会直接拒绝启动两种模式的定义常量见 internal/server/server.go。差异 1安装与启动方式 selfhosted克隆仓库后用make full-setup一键拉起 Postgres 路由服务 仪表盘localhost:8080详见 README.md 的自托管章节。适合想要完全掌控基础设施的团队。managed一条npx weave-os/router即可无需 clone、无需 Docker、无需数据库安装器会自动完成 Claude Code / Codex / opencode / pi 的配置接线完整参数见 install/README.md。差异 2仪表盘与 Admin API 是否挂载 这是两种模式最本质的结构差异selfhosted挂载完整仪表盘/ui/*和管理 API/admin/v1/*登录、指标、密钥、provider-keys、配置、排除模型并启用仪表盘 Cookie 认证。managed这两个路由完全不注册——因为 Weave 托管部署有独立的管理控制平面官方刻意避免在 SaaS 部署上暴露冗余管理面。架构规范明确要求新端点应放在server.Register的 selfhosted 代码块内禁止在 managed 模式重新暴露管理面见 internal/api/AGENTS.md。差异 3Provider 密钥从哪里来 selfhostedProvider 密钥从环境变量读取ANTHROPIC_API_KEY、OPENAI_API_KEY等。某个 key 缺失时对应 provider 仍保持注册走客户端凭据透传如 Claude Code 自带的 OAuth 登录只是不参与硬钉扎模型解析。managed所有 provider 以空部署密钥注册代理进入BYOK-only 模式——请求若既无 BYOK 密钥也无客户端凭据直接返回 400而不会悄悄消耗平台预算。BYOK 是按安装实例逐项开启的控制平面在 installation 行上设置byok_enabled之前认证中间件会剥离外部密钥防止存储的密钥花掉预付费部署的额度。相关分支逻辑见 cmd/router/main.go凭据策略说明见 docs/CONFIGURATION.md。差异 4计费体系是否启用 managed启动时自动装配计费服务credit billing每个推理路由都挂上预付费余额检查BYOK 轮次不扣推理费用钱花在你自己的 provider 上平台可另收BYOK_FEE_RATE默认 0作为独立的byok_fee账本行。selfhosted不装配计费服务你花的是自己的上游 API 额度成本由上游账单体现路由器只通过响应头x-router-cost-usd帮你记账展示。装配条件在 cmd/router/main.go 中一目了然。差异 5出站网络限制的默认值 ️ROUTER_RESTRICT_UPSTREAM_EGRESS的默认值跟随部署模式managed默认true。provider 适配器拒绝拨号到公网以外的上游环回、内网、link-local、CGNAT并忽略HTTP_PROXY/HTTPS_PROXY——因为代理连接无法校验目的地。selfhosted默认false。把 provider 指向集群内或 loopback 网关是正常操作所以不限制。实现在 internal/providers/httputil/egress.go变量说明见 docs/CONFIGURATION.md。差异 6OpenRouter 平台源的默认开关 selfhostedOPENROUTER_API_KEY配置后即无条件把 OpenRouter 作为平台级模型来源这也是自托管的推荐基线。managed默认不启用OpenRouter 作为平台源需显式设置ROUTER_OPENROUTER_PLATFORM_ENABLEDtrue才开启BYOK 的 OpenRouter 密钥在两种模式下都可正常派发。对应代码在 cmd/router/main.go。差异 7模型选择与模型清单的管理位置 ⚙️selfhosted模型选择 API 可用。你可以在仪表盘设置页勾选或用命令行npx weave-os/router models enable/disable直接增删路由池若部署用ROUTER_EXCLUDED_MODELS/ROUTER_EXCLUDED_PROVIDERS钉死了清单则 API 会拒绝修改并明确提示。managed模型选择权在组织层面Weave 控制平面本地models命令只能列出清单并指向托管仪表盘不能逐机编辑。行为差异说明见 install/README.md 的 Choosing which models the router may pick 一节。差异 8管理员密码与遥测属性 selfhostedROUTER_ADMIN_PASSWORD只在该模式下有意义——未设置时推理照常工作但仪表盘登录和管理端点返回admin_login_disabled。managed根本不读该变量没有仪表盘可读它。此外OTel 遥测会把router.deployment_mode作为资源属性打到每个导出上采集端Honeycomb / Datadog / Grafana可据此区分两种部署的摄入行为见 cmd/router/main.go 与 docs/CONFIGURATION.md。怎么选30 秒决策清单 ✅你的情况推荐模式个人尝鲜、想让 Claude Code/Codex 立刻省钱managednpx weave-os/router零运维数据合规要求prompt 绝不出内网selfhosted路由器、打分器、Postgres、密钥全部本地已有内网模型网关loopback/内网地址selfhosted出站限制默认关闭直连无障碍多团队共享、需要预付费与组织级模型治理managed计费、组织级模型选择开箱即用两种模式可随时切换——managed 只是把ROUTER_DEPLOYMENT_MODE设为managed并剥离自托管管理面核心路由引擎、50ms的打分器、/v1/messages与/v1/chat/completions端点在两种模式下完全一致。更多部署语义可参阅 AGENTS.md 的 Deployment modes 章节和 docs/CONFIGURATION.md 配置参考。【免费下载链接】routerModel router for agentic systems. Routes every prompt to the right model in 50ms. Cut costs 40-70% with just an endpoint change.项目地址: https://gitcode.com/GitHub_Trending/router101/router创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考