Nango 是什么?1.3 万星的 Agent 集成层,1200 个 API 的登录态它全包,自托管却只给一半(基础篇)

Nango 是什么?1.3 万星的 Agent 集成层,1200 个 API 的登录态它全包,自托管却只给一半(基础篇)

Agent 真要干活,绕不过第三方系统:查 Linear 的 issue、改 HubSpot 的 deal、读 Gmail 的附件。难的不是拼 URL——是每个用户各自的 OAuth 登录态、token 到期刷新、多租户隔离、限流重试,还有连接断了要通知人回来重连。做十个集成和做一个集成的痛苦程度是一样的,因为每家的认证方式都不一样。Nango 就是专门收这一段的。

它到底是什么

Nango 2022 年成立,YC W23 批次,两位创始人 Robin Guldener 和 Bastien Beurier。GitHub 上 NangoHQ/nango 目前 13,225 星、1,533 个 fork,TypeScript 写的,许可证是 Elastic License 2.0。创始人 11 月初自己发帖说,这个项目一年里从 6,000 星涨到 13,000 星。官网现在的口径是 1,200+ 个 API 与 MCP、10,000+ 个预制工具、100 万个已连接的账号;README 里点名的生产用户是 ServiceNow、Replit、Ramp、Mercor。

整套东西只有三个原语:Auth 管 OAuth 和 API key、刷新 token、按租户存连接;Proxy 带着凭据替你把请求打出去,顺手处理重试和限流;Functions 让你用 TypeScript 写集成逻辑,跑在它的运行时上。provider 目录是数据不是代码——providers.yaml 一个文件将近 3 万行、约 1,000 条,每条记着这家用哪种认证、authorize 和 token 地址、分页怎么翻、限流头叫什么名字。

钱上,2026 年 4 月 1 日拿了 750 万美元种子,Gradient 领投,Horizon 和 YC 跟投。官方说这轮不是非拿不可:融资前已经现金流转正,ARR 数百万,10,000+ 个工程团队用过,每月经手几十亿次 API 请求。

给 Agent 用的那一层

2026 年这版的核心叫 Agent Sessions。后端建会话,会话里定死三件事:tenant(替谁干活)、toolset(能用哪些工具)、discovery(怎么找到工具)。会话本身就是一个 MCP 服务器,地址形如 api.nango.dev/session/<id>/mcp,用 session_token 做 bearer,任何支持 MCP 的客户端都能连上来。

Agent 经 Nango 取凭据调第三方 API 的时序:后端下发 session_token,Agent 连 session MCP 后用 nango_tool_search 找工具、nango_execute 执行,Nango 从凭据库取 token 调第三方 API,遇到 429 退避重试,最后只把结果回给 Agent
凭据只在 Nango 与凭据库之间出现,Agent 手里只有一个 session_token

默认只开两个元工具:nango_tool_search 用几句人话找工具,nango_execute 按名字执行。另外两个 nango_proxy(直接代理任意接口)和 nango_create_connection(现场拉起授权)默认是关的。工具默认不进 tools/list,全靠搜索发现,只有 pinned_tools 里的才预先列出来——这是为了防止几百个工具定义一下把模型上下文塞满。单个工具 60 秒超时,结果上限 5MB;会话会过期,而且不能续期,过期就得重建。

想自己跑一遍

自托管一条 docker compose:nango-server 加 Postgres、Redis,Elasticsearch 可选,providers.yaml 要挂进容器。NANGO_ENCRYPTION_KEY 必须自己填一个 base64 的 256 位密钥——这个忘了设,凭据就是明文躺在库里。前端一行 nango.openConnectUI 就能拉起授权弹窗。

免费额度是 10 个连接、每月 10 小时计算、10GB 流量,硬顶不超额。按量付费 50 美元一个月起,含 50 美元额度,之后 0.29 美元一个连接、0.72 美元一小时计算、0.5 美元 1GB。想省钱的思路和之前那篇《十个 Agent 平台几个能装进自己机器》一样:先自托管试通,跑出量了再算账。

几句实话

第一,许可证是 ELv2,不是 OSI 开源。自己用、改、自托管都行,但不能拿它对外提供托管服务卖钱。

第二,免费自托管是阉割版。官方镜像在 build 时直接删掉 jobs、runner、persist 三个包,剩下的只有 auth、Connect UI 和 proxy;sync、action、function 这些要 Cloud 或者 NANGO_ENTERPRISE。10 月 2 日的 v0.71.12 又把免费自托管改成单租户,之前做多租户部署的,升级会直接断。

第三,安全上有两个点得自己盯:nango_proxy 一旦打开就绕过 allow/deny,deny 名单基本等于摆设;执行器用的是 node:vm,那不是安全边界,生产隔离靠的是把每个团队分到不同的 runner 节点。

所以它适合「产品里要做几十上百个集成」的团队——两周上线一个集成能压到两天。如果你只是想给个人 Agent 接几个工具,Composio 那类平台更省事。Nango 更像水管,不是插座。

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注