很多团队在初次部署 NATS 时,往往只在配置文件里写一个 listen: 4222,甚至只在顶层 authorization 块里加几组用户名和密码就上线了。在这种配置下,所有客户端其实都落在了 NATS 内置的默认全局账户 $G 里。
开发阶段这样做很省事,但在生产环境里,这种“全员挤在同一个 $G 账户”的做法隐藏着明显风险:同一个账户内的客户端共享同一片 Subject 命名空间,默认彼此信任。只要没有为每个用户逐一收紧权限,一个边缘日志采集服务的凭据一旦泄露,攻击者就能直接订阅订单消息、向核心主题注入伪造事件,甚至调用 JetStream 管理接口。
这篇文章把 NATS 的账户模型拆开讲清楚:$G 为什么不够安全、Account 到底提供了哪些隔离边界、跨账户如何受控通信,以及在生产环境中如何设计一套可落地的安全账户体系。
1. 默认 $G 账户到底是什么,为什么不够安全?
在 nats-server 中,G(Global Account)是服务端在未启用多账户配置时隐式创建的默认全局账户。只要你的配置文件里没有显式定义 accounts 块,或者沿用了早期的顶层 authorization.users 写法,所有连入的客户端都会被放进 G。
用 $G 跑生产业务,主要会撞上三类安全与稳定性问题:
同一账户内默认全通(Flat Trust):NATS 账户内部默认不设防。如果一个用户没有配置
permissions(账户也没有设置default_permissions),它就可以向当前账户内的任意 Subject 发布消息,也可以用>通配符订阅所有流量。订单、支付、日志和监控脚本全在$G里,等同于没有任何横向隔离。JetStream 与系统资源缺少边界:在单一全局空间里,如果开启了 JetStream,任何未受限制的用户都能访问
$JS.API.>管理接口创建、修改或删除 Stream。即使业务上互不相关,一个服务失控建出大量 Stream 或打满连接数,也会直接波及同账户内的其他服务。配置演进时的隐式暴露陷阱:有些团队为了接入监控工具,会在配置里加上
system_account(系统账户),或者为了兼容旧客户端而保留no_auth_user。如果配置边界没有写严密,未认证连接或遗留用户仍可能回落到开放的默认空间中,让原本以为已经锁死的集群留下旁路入口。需要注意的是,G是nats-server的内部保留名称,你不能在accounts块里手动声明一个名为G的账户,否则服务启动时会直接报错。
下面这张结构图对比了两种部署形态:上方红色虚线框展示的是默认 $G 下的隐式扁平空间,所有服务暴露在同一张平面里;下方蓝色实线框则是显式多账户架构,每个业务域拥有独立边界,跨界通信必须走显式契约。
默认 $G 账户共享全量 Subject,显式多账户体系通过独立边界与 Exports/Imports 契约实现硬隔离。
2. NATS Account 的核心概念与四大特性
要理解为什么 NATS 推荐用账户来做多租户隔离,可以先看清 Account 在服务端承担的四项职责。
逻辑隔离的 Subject 命名空间
在 NATS 中,Account 是最基本的隔离边界,User 只是某个 Account 内的访问凭据。两个不同账户的客户端连到同一套 NATS 集群时,彼此的 Subject 空间完全不可见。哪怕 ORDERS 账户和 ANALYTICS 账户里都使用了 orders.created 这个 Subject,两边收发的消息也互不干扰。
独立的 JetStream 开关与资源配额
一旦在服务端引入显式的 accounts 块,JetStream 就会变为按账户显式开启(Opt-in)的模式。你可以精确决定哪个账户允许使用持久化流,并为每个账户单独设定配额上限,例如最大连接数(max_connections)、最大订阅数、单条消息体上限,以及 JetStream 的存储空间与 Stream 数量限制。这样即使某个业务团队的程序发生死循环或内存泄漏,影响也会被锁死在它自己的账户配额内。
特殊账户:$G 与 $SYS 的分工
除了自定义业务账户,NATS 里还有两个特殊的系统级概念需要分清:
$G(默认全局账户):面向历史兼容和单机快速启动的隐式默认域,生产环境应当通过显式配置彻底替代它。SYS(系统账户):通过配置文件中的system_account指定(通常命名为SYS)。它专门承载集群内部的控制面事件、服务端心跳、客户端上下线审计(SYS.SERVER.>)、监控查询以及动态账户解析通信。把运维与遥测流量放进独立的$SYS账户,可以确保普通业务账号无法窥探集群拓扑和节点状态。
跨账户通信:Exports 与 Imports
隔离并不意味着彻底孤立。当不同账户之间确实需要交换数据时,NATS 提供了严格受控的 Export(导出) 与 Import(导入) 机制,并且只支持两种通信契约:
Stream(流导出/导入):对应单向的发布/订阅(Pub/Sub)模式。导出方把某个 Subject(支持通配符)暴露出去,导入方以只读方式订阅这些事件。
Service(服务导出/导入):对应双向的请求/响应(Request-Reply)模式。导入方把请求发送到本地映射的 Subject,由导出方账户内的微服务处理并返回结果。其中可以通过
response_type声明响应形态:默认的single表示每次请求只回传一条消息,而stream则允许服务针对单次请求返回多条流式响应(如分片进度或持续推送)。
为了避免跨账户引入 Subject 命名冲突,导入方可以在 imports 规则里使用 prefix 或 to 字段做本地重映射(例如把 ORDERS 导出的 orders.shipped 映射为本地的 ext.orders)。此外,在更严格的场景下,导出方还可以把导出标记为私有(Private),要求导入方必须持有由导出方私钥签发的 Activation Token(激活令牌) 才能完成绑定。
3. 从静态配置到 Operator 模式:三种账户体系对比
明确了 Account 的能力后,接下来的问题是“怎么管这些账户”。NATS 支持从静态配置文件过渡到去中心化的密码学信任链。看下面这张对照表,横向对比默认 $G、静态 accounts 配置块和 Operator JWT 模式在隔离、权限、变更与密钥治理上的差异。
NATS 三种账户管理模式对比:Operator JWT 模式实现了动态下发与离线根密钥治理。
如果团队规模较小、账户数量固定,直接在 nats.conf 里写静态 accounts 块就能满足隔离需求;但当账户和微服务频繁增减时,每次改权限都要同步所有 NATS 节点配置并执行 reload,很容易成为运维瓶颈。
这时就需要 NATS 的 去中心化认证模式(Operator Mode)。它用基于 Ed25519 算法的 NKey 密钥对和签名 JWT 取代了配置文件里的静态用户列表,构建出一条三级信任链。顺着下面流程图从上往下看:服务端不再保存成百上千个用户密码,只需信任最顶层的 Operator 公钥,客户端连接时再由 Account Resolver 动态拉取账户策略并逐级验签。
Operator 模式下的三级密码学信任链:服务端只信任根公钥,通过 Nonce 挑战与 Resolver 动态完成鉴权。
在这条信任链中,各层实体按前缀即可一眼区分:
Operator(
O.../ 私钥SO...):整个 NATS 系统的根信任锚点,负责签发各个 Account 的 JWT。生产环境中,Operator 的主私钥通常离线冷存,日常操作通过可轮换的 Operator Signing Key 代理签名。Account(
A.../ 私钥SA...):代表独立租户或业务域。Account JWT 里写明了该账户的 Subject 规则、JetStream 配额、Exports/Imports 契约以及吊销列表。User(
U.../ 私钥SU...):客户端连接时使用的具体身份。User JWT 可以直接由账户签发,更推荐由受限签名密钥(Scoped Signing Key)签发——这样你可以把“只读订单”或“只写日志”的权限模板绑定到特定 Signing Key 上,即便某个签名密钥泄露,也能精准吊销由它签发的一批用户,而不影响账户根密钥。
4. 如何设计一套安全的 NATS 账户体系?
结合上述机制,一套可直接落地的 NATS 安全账户架构可以按以下五个步骤推进。
第一步:显式声明 accounts 与 system_account,淘汰 $G
无论集群规模大小,第一步都是把隐式的 $G 替换为显式声明的账户结构。在静态配置模式下,至少应当把系统管理域(SYS)和业务域拆开,且避免在生产环境设置开放的 no_auth_user。
下面是一个用于理解边界划分的配置示例(仅作结构示意,生产环境需补充 TLS 证书与强凭据,切勿直接复制占位密码上线):
listen: "0.0.0.0:4222"
# 显式指定系统账户,专门承载 $SYS.* 运维与监控流量
system_account: "SYS"
accounts: {
SYS: {
users: [
{ user: "sys_monitor", password: "CHANGE_ME_SYS" }
]
},
ORDERS: {
jetstream: enabled
users: [
{ user: "order_writer", password: "CHANGE_ME_ORDER" }
]
},
ANALYTICS: {
# 按需开启或保持关闭 JetStream,与 ORDERS 完全隔离
users: [
{ user: "bi_reader", password: "CHANGE_ME_BI" }
]
}
}
第二步:按信任边界切分 Account,并设置资源配额
不要把“一个公司”或“一个环境”笼统塞进单个账户,建议按安全信任边界与故障隔离域拆分 Account。通常可以按业务域(如订单域、支付域、日志平台)或 SaaS 租户拆分。
对于每个业务账户,应当显式限制连接数、订阅数和 JetStream 磁盘/内存配额,防止单个异常客户端把整个集群的文件描述符或磁盘空间打满。
第三步:账户内部坚持最小权限(默认拒绝)
Account 解决了“跨账户隔离”,但账户内部的 User 之间依然需要权限约束。设计内部权限时可以遵循三条实操规则:
配置
default_permissions作为兜底:在账户级设置保守的默认权限(例如默认禁止任意发布与订阅),再为具体业务用户或 Scoped Signing Key 授予所需的精确 Subject(如只允许发布orders.created)。用
allow_responses替代放开_INBOX.>:在 Request-Reply 场景里,服务端需要把响应发回请求方生成的临时_INBOX.*地址。不要为了省事给服务账号配置publish.allow: ["_INBOX.>"],而应启用allow_responses。开启后,nats-server会自动追踪该连接收到的请求所携带的 reply subject,只允许它向当前合法的回复通道发回消息。隔离 JetStream 管理面与数据面:普通业务生产者只需要发布业务 Subject 的权限,不应持有
$JS.API.STREAM.CREATE.>或删除权限;Stream 与 Consumer 的变更应交由专门的部署/运维账号或 IaC 管道执行。
第四步:跨账户共享走显式契约与私有激活
当 ANALYTICS 需要消费 ORDERS 的事件,或者需要调用某个跨团队微服务时,不要把两个服务合并回同一个账户,而是通过 Exports / Imports 建立最小契约:
只导出必须共享的精确 Subject 或受控子前缀,严禁把账户根通配符
>导出。导入侧统一加上
prefix或映射为新的本地 Subject(如ext.orders.*),一眼就能区分本地消息和外部导入消息。涉及敏感业务数据或跨团队 API 时,将 Export 设为 Private,通过有时效限制的 Activation Token 授权给指定的导入账户公钥,并在合作终止或超时后及时移除或吊销。
第五步:生产级密钥治理与传输层加固
对于需要长期演进的多团队集群,建议采用 nsc 或新版 nats auth 工具链迁移到 Operator JWT 模式,并落实三项密钥治理规范:
根私钥离线化:Operator 主 Seed(
SO...)与 Account 主 Seed(SA...)离线保管,日常签发全部通过中间 Signing Key 完成。短有效期与吊销机制:为 User JWT 设置合理过期时间,结合自动化凭据分发轮换;一旦发现异常客户端,通过更新 Account JWT 中的吊销列表(Revocation)即可在不重启服务端的情况下立即踢出受影响凭据。
认清 Account 的安全边界:Account 和 JWT 解决的是逻辑多租户隔离、身份认证与 Subject 级授权,它们不能替代 TLS / mTLS 传输加密,也不能替代网络层的防火墙与安全组策略。公网或跨机房链路必须同时开启 TLS 加密,防止 JWT 或业务载荷在传输过程中被窃听或篡改。
5. 什么时候可以留在静态配置,什么时候该上 Operator 模式?
安全架构不是越复杂越好,选择账户管理方式同样需要权衡运维成本:
适合静态
accounts配置块的场景:内部系统数量稳定(例如只有 3~5 个核心服务域)、变更频率低、配置完全由 GitOps 或 Ansible 统一托管且允许滚动 reload。这种方式无需额外理解 NKey、Signing Key 和 Account Resolver 的概念,排查问题也更直观。值得引入 Operator JWT 模式的场景:多团队自助接入 NATS、需要为外部合作伙伴或 SaaS 租户动态开通隔离空间、要求密钥定期轮换且不能接受服务端重启。虽然初期需要投入学习
nsc/nats auth和配置分布式 Account Resolver(如基于内置 NATS KV 的 Full Resolver),但换来的是服务端零重启的动态权限治理能力。
把默认 $G 换成显式的 Account 边界,再把账户内部的默认全通收紧为基于 allow_responses 与精确 Subject 的最小权限,就已经能消除 NATS 部署中绝大部分横向越权风险。在此基础上,再按团队的变更频率决定是否演进到 Operator JWT 体系,才是最稳妥的落地路径。

