Rivet 的 Agent 状态存进自建 RustFS:主桶配置与上线边界

2026-11-05 的 Hacker News Launch HN 帖把 Rivet 带进视野,截至 11-06 约 75 分、42 条评论。做自托管的人会盯住它的存储选择。Rivet 把每个 Agent 的持久状态最终都放进一个对象存储桶,这个桶默认指向 S3。把这桶落到自建的 RustFS 上,动的是控制面的一段存储配置:五个环境变量,加上回源读延迟和两个集群不共桶这两条边界。

状态最终落在对象存储桶里

Rivet 是 Apache 2.0 开源项目,YC W23 批次,仓库在 GitHub 上的 rivet-dev/rivet。它的核心单元叫 Actor,一个 Agent、一个用户或一个会话各对应一个。每个 Actor 自带内存态、一个随进程带着走的 SQLite 小数据库、WebSocket 连接和调度。SQLite 在这里就是存会话状态的那份本地库文件,进程走到哪它跟到哪。官方列出的几类场景,耐用 AI Agent、多人协作、工作流回放,都依赖这个 SQLite 库存活,库不在了,会话历史和回放就接不上。这些库最终收进对象存储桶,机器重启或换机都不影响状态还在。

存储分成两层,各管一段。靠近写入的一层是磁盘桶,最近的写入先落在各控制面实例的本地盘,多数派确认之后才算写成功;多数派确认指同一份数据要在过半实例上都落盘,才回给调用方成功。另一层是主桶,也就是 S3,它给每个 volume 留一份持久副本,写入在后台批量刷进去,volume 可以理解成一段被单独管理的状态空间。官方 README 的表述是,对象存储是唯一依赖,控制面实例之间靠这个桶互相发现,不需要 Postgres、FoundationDB 或 NATS。

主桶因此不在写路径上,缓存没命中时会从对象存储回源读。真正要落到 RustFS 的,是主桶这一层。

兼容范围里本来就有 S3 兼容实现

Rivet 自己是从 FoundationDB 迁到 S3 的。官方给的缘由很实在,用户往 Actor 里塞的数据量远超预期,为大量冷掉的转录养一批昂贵 SSD 不划算,索性把冷数据交给对象存储。对象存储这一层在架构里就是定好的持久位置。

能接的也不止 AWS 一家,Rivet 自托管存储文档 列了 Amazon S3、Google Cloud Storage、Azure Blob,还有 MinIO、Cloudflare R2、Hetzner Object Storage,并写明任意 S3 兼容实现都在范围内。本地文件系统后端单独标注了只供单机试玩。自建 RustFS 提供的是 S3 API,落在这一档里,属于这套配置本来就留好的口子。

性能数字也一并给了出来(Rivet 官方 README 与发布贴,基准 3.0.3;第三方尚未独立复现)。p99 是一百次请求里排第九十九位的那个延迟,看的是长尾,平均值容易把最慢的那一小撮盖过去。SSD 层持久写 p99 1.07 毫秒,读 p99 1.36 毫秒,缓存未命中时会从对象存储回源读。

这一档回源读,p99 138 毫秒。

HN 评论里还有人指出,跨可用区复制的账单可能远超预期。

RustFS 侧的 9000 与 9001

RustFS 官方 Docker 安装文档 把起一个实例要用的值都列全了。镜像是 rustfs/rustfs:latest,S3 API 落在 9000 端口,控制台落在 9001,两个端口一个收数据请求一个给人看板子用。地址变量 RUSTFS_ADDRESS=":9000" 和 RUSTFS_CONSOLE_ADDRESS=":9001" 跟这两个端口对应,RUSTFS_CONSOLE_ENABLE=true 把控制台打开,凭证由 RUSTFS_ACCESS_KEY 和 RUSTFS_SECRET_KEY 两个变量传进去。

RustFS 默认用 path-style 寻址,桶名直接写在 URL 的路径里。同一份文档还交代了几处和身份、凭证有关的设定,容器以非 root 的 UID 10001 运行,默认凭证值 rustfsadmin 不要保留,强随机值官方建议用 openssl rand -base64 24 生成。健康检查是 curl --fail http://localhost:9000/health。下面这段配置只用到该文档给出的镜像、端口与五个环境变量,没有另加参数。

bash 复制代码
RUSTFS_ADDRESS=":9000"
RUSTFS_CONSOLE_ADDRESS=":9001"
RUSTFS_CONSOLE_ENABLE=true
RUSTFS_ACCESS_KEY=<生成的强随机值>
RUSTFS_SECRET_KEY=<生成的强随机值>

openssl rand -base64 24

curl --fail http://localhost:9000/health

object_storage.primary.s3 怎么填

Rivet 侧的配置落在 JSON 路径 object_storage.primary.s3 下,字段一共五个,bucket、region、endpoint、access_key_id、secret_access_key,分别管桶名、区域、端点、访问键和密钥。换成环境变量用的是双下划线嵌套那一套,前缀统一 RIVET__OBJECT_STORAGE__PRIMARY__S3__,后面分别接 ENDPOINT、BUCKET、REGION、ACCESS_KEY_ID、SECRET_ACCESS_KEY,双下划线对应 JSON 里一层层往下走的路径。

access_key_id 与 secret_access_key 这一对,对应 RustFS 侧 RUSTFS_ACCESS_KEY、RUSTFS_SECRET_KEY 那两个值。两侧字段名分别出自前面引用的那两份文档,这里的对应是按字段名接起来的。bucket 填自建 RustFS 上给这批状态用的桶。前面那份自托管存储文档里,region 可以留空,官方示例填 us-east-1 一样能用。

寻址这块,官方 MinIO 示例把桶名写进 endpoint,用的是 path-style 写法,前面那份 Docker 文档里 RustFS 默认也是 path-style 寻址,桶名走 URL 路径。Rivet 控制面自己的健康检查是 curl http://localhost:6420/health,和 RustFS 侧 9000 端口那条分属两端。

bash 复制代码
RIVET__OBJECT_STORAGE__PRIMARY__S3__ENDPOINT=http://<RustFS 地址>:9000/<桶名>
RIVET__OBJECT_STORAGE__PRIMARY__S3__BUCKET=<桶名>
RIVET__OBJECT_STORAGE__PRIMARY__S3__REGION=us-east-1
RIVET__OBJECT_STORAGE__PRIMARY__S3__ACCESS_KEY_ID=<RustFS access key>
RIVET__OBJECT_STORAGE__PRIMARY__S3__SECRET_ACCESS_KEY=<RustFS secret key>

curl http://localhost:6420/health

写路径之外的回源读与备份

缓存没命中时会从对象存储回源读,这一条在两层存储的结构里就定好了,前面那组 p99 里回源读那一档对应的就是它。SSD 层那组读写 p99 落在磁盘桶,磁盘桶的多数派确认在写路径上;主桶这份持久副本的写入在后台批量刷入,不挡在写路径上。主桶是全部 Actor 数据的持久副本,需要定期备份,桶复制或独立快照都算,定期备份针对的就是自建 RustFS 上那个主桶。

官方给的生产口径是至少三个控制面实例共享一个桶,每个实例各有持久卷,生产前启用 TLS;单机试用则可以用文件系统后端加单实例,这是官方把试用和生产分开列出的两套口径。搬迁时两端都是标准 S3,用 aws s3 sync 或 rclone 指两个端点,不需要做 schema 迁移。

主桶这一侧要核对的字段与约束

  • RIVET__OBJECT_STORAGE__PRIMARY__S3__ 后面五个字段齐,ENDPOINT 指向 RustFS 的 9000 端口,path-style 写法把桶名带上
  • region 可留空,官方示例填 us-east-1 也能用
  • 两个集群不指向同一个桶或前缀
  • 凭证用 openssl rand -base64 24 生成,没有沿用默认值 rustfsadmin
  • RustFS 侧 curl --fail http://localhost:9000/health 与 Rivet 控制面 curl http://localhost:6420/health 两条健康检查分属两端
  • 主桶做定期备份,桶复制或独立快照都算
  • 搬迁两端都是标准 S3,aws s3 sync 或 rclone 指两个端点,不做 schema 迁移
相关推荐
瑞雪兆丰年兮1 小时前
Linux零基础快速入门-第二章 Linux基础命令
linux·运维·服务器
lambo mercy1 小时前
01初识docker
运维·docker·容器
阿里云云原生3 小时前
云原生开源项目周报(2026 / 11.09 — 11.16)
云原生·开源
时间的拾荒人4 小时前
Docker 入门实战:从核心概念、安装配置到镜像操作与 Dockerfile 定制
运维·docker·容器·eureka
光电笑映4 小时前
TCP 为什么可靠?从三次握手、滑动窗口到拥塞控制全面拆解(上)
运维·服务器·网络·udp
飞奔的瓜牛4 小时前
Linux 下使用 OpenSSL 生成自签名证书完整指南
运维·服务器·nginx
无奈笑天下5 小时前
银河麒麟桌面上USB打印机无法打印问题标准处理流程
linux·运维·网络协议
Bigger5 小时前
我扒了 GitHub Trending 前 20,8 个在做同一件事:给 Coding Agent 造基础设施
开源·github·ai编程
Decay__5 小时前
附 - 02・SQLServer 分库分表与中间件 —— 原生分区表、横向分库实践与联邦查询
运维·数据库·sql·mysql·架构
openUBMC5 小时前
从带外管理到开源共建:openUBMC 走进华南高校
开源