authelia
The Single Sign-On Multi-Factor portal for web apps. OpenID Certified™ and Post-Quantum Cryptography Ready.
- 30k
- Go
- Apache-2.0
- 2 d ago
Rust building-block toolkit for microservices: a lifecycle-orchestration core plus contract crates with conformance-tested engine adapters — transport (axum/WS/QUIC/WebTransport/MQTT), storage, auth, config, discovery, observability, resilience, messaging, scripting, AI, object storage. 100% safe code.
Repo tx7do/rushwind, read from GitHub 2 d ago. tx7do has not joined Take My Repo.
tx7do/rushwind is a public repo on GitHub by tx7do. Rust building-block toolkit for microservices: a lifecycle-orchestration core plus contract crates with conformance-tested engine adapters — transport (axum/WS/QUIC/WebTransport/MQTT), storage, auth, config, discovery, observability, resilience, messaging, scripting, AI, object storage. 100% safe code. It declares the MIT license on GitHub. It is written mainly in Rust, has 5 stars and last changed on 2026-11-20. Nobody has reviewed it on Take My Repo yet, which says nothing about its quality. Read from GitHub on 2026-11-21.
In the maintainer's words. Shown from GitHub; Take My Repo does not keep a copy.
多数生态把框架和插件分仓:框架仓只管生命周期与契约,传输、存储、消息这些"插件"散落在外部仓,版本各自漂移、门禁各自为政。RushWind 二合一:同一个 workspace 里,框架核心与全部插件域一起演进——同一个一致性套件标准、同一条 "cargo test 全绿即合规" 的验收线。
二合一不等于全家桶——单仓是开发视图,不是链接视图:你不用的引擎不会进你的依赖树,域与域之间只通过契约 crate 相连。核心依旧不含日志、不含注册中心、不含配置中心:那些是积木,不是底板。
不是全家桶,而是积木盒。
框架核心只做一件事:可靠的多服务器生命周期编排——并发启动、级联停机、分阶段限时、结果观察。契约先行:每个能力域都是一份契约 crate,每个具体引擎、每个协议栈都是独立的适配器 crate,由使用者按需拼装。
一切按 Rust 的所有权、取消与错误模型原生设计;契约语义与预算、停机行为的规范细节见 docs/architecture.md,live 服务器验证的方法论与九服务器矩阵见 docs/live-verification.md。数据访问层是同一哲学的延伸:rushwind-storage 用一套 Repository 契约驾驭多种存储引擎——每引擎一个适配器 crate,按需引入。
依赖四个 crate:rushwind-core、rushwind-transport、rushwind-transport-axum、rushwind-http(外加 tokio 与 axum)。三十行跑起第一个带统一中间件栈的 HTTP 服务:
use std::net::SocketAddr;
use std::sync::Arc;
use std::time::Duration;
use axum::routing::get;
use axum::Router;
use rushwind_core::App;
use rushwind_http::HttpEdge;
use rushwind_transport::StopSignal;
use rushwind_transport_axum::AxumServer;
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
// HttpEdge:默认请求中间件栈(panic 恢复 / 请求 ID / 访问日志)
let router = HttpEdge::new().wrap(
Router::new().route("/hello", get(|| async { "hello rushwind" })),
);
let server = AxumServer::new(SocketAddr::from(([127, 0, 0, 1], 0)), router)?;
println!("listening on {}", server.endpoint()?);
// App:编排者——并发启动、级联停机、每阶段独立预算
let app = App::builder()
.name("hello-rushwind")
.version("0.1.0")
.erased_server(Arc::new(server))
.stop_timeout(Duration::from_secs(5))
.build();
// Ctrl+C / SIGTERM / app.stop() 都走到体面停机
app.run(StopSignal::new()).await?;
Ok(())
}
完整走法(含生命周期三原语 Server / StopSignal / App 的解释)见教程 01 · 生命周期与第一个服务,全系列 13 章见 docs/tutorials。可运行的完整示例见 examples/。项目长大后无需手写装配:rushwind-bootstrap 把各域引擎、HTTP 服务器与 cron 传输从一份 YAML 装配进单一生命周期(教程 02 · 装配器与配置,完整示例 examples/bootstrap-demo)。
框架之外的三个官方仓,构成 RushWind 的开发链。单体与微服务两种部署形态,各有一个从零可跑的参考实现:
| 仓库 | 定位 |
|---|---|
| rushwind-toolkit | 生态工具箱:rush CLI + rush-gen 核心库——领域实体后端全链生成、数据库内省反推实体规格、前端 CRUD 页面生成、项目脚手架(memory/sqlite/postgres 三变体)、契约清单校验、差分台架 |
| rushwind-admin | 单体的实现实例:契约驱动的企业级管理后台——单体后端(REST + SSE)对接 Vue3 Vben / Vue3 Element Plus / React19 三套前端,多租户 RBAC、审计留存、TOTP MFA 等保 2.0 合规 |
| rushwind-cms | 最简的 3 服务微服务实现实例:Rust 全栈 Headless CMS——core-service(领域层,gRPC 对内)+ admin / app 两个 BFF(REST + SSE 对外),同一 proto 契约同时产出 REST 与 gRPC 两面 |
前两节是框架(编排 + 传输契约 + HTTP 面),其后是插件域——每个域一份契约 crate + 按需引入的引擎矩阵,各自过一致性套件。
| 位置 | 职责 |
|---|---|
crates/rushwind-core |
生命周期编排:并发启动、级联停机、分阶段限时、结果观察 |
crates/rushwind-transport |
契约层:Server trait、StopSignal、Instance、ServerError |
crates/rushwind-transport-axum |
axum 适配器:Router 接入生命周期,优雅停机映射见架构文档 |
crates/rushwind-transport-ws |
WS 会话路由构建器:门链 + 准入策略 + 会话停机总线,契约见会话中间件文档 session-middleware.md |
crates/rushwind-transport-tcp |
裸 TCP 传输:accept 时刻门链 + 总帽/per-remote 帽原子双检,字节预算如实记 N/A(引擎不碰读路径,TCP 流控即预算),会话类型 = 原生 TcpStream |
crates/rushwind-transport-quic |
QUIC 适配器:quinn 接受循环接入生命周期,全套会话链(对端地址准入、按远端 IP 会话配额);stop() 为真实释放(Endpoint::close) |
crates/rushwind-transport-webtransport |
WebTransport 适配器:wtransport 端点接入生命周期,全套会话链(会话请求时刻的 HTTP 族门链、原子准入、握手截止),stop() 为真实释放 |
crates/rushwind-transport-h3 |
HTTP/3 适配器:h3/h3-quinn 请求服务接入生命周期,请求时刻门链(拒绝映射为状态响应)与连接级原子准入,stop() 为真实释放 |
crates/rushwind-transport-grpc |
gRPC 传输:tonic 0.14 服务调用方提供的 Routes(proto-build 的 tonic generator 编译域服务,部署覆写 stub),监听器构造期急切绑定、优雅排水随停机信号,端点 grpc://host:port |
crates/rushwind-transport-mqtt |
MQTT 消费桥:订阅外部 broker(每订阅 handler 注册 + 规范通配分发),重连退避 + 订阅重建,串行泵入 handler |
crates/rushwind-transport-sse |
SSE 通知传输:/events 线契约(CORS 预检、三源 token、401 纯文本错误行、反跨用户流检查、按用户过滤广播流)+ 进程内 Hub + bootstrap 工厂,授权经 Gate trait 插拔 |
crates/rushwind-transport-cron |
cron 传输:分钟对齐的周期调度器接入 Server 生命周期,cron 表达式命中整分即触发注册的作业 |
| 位置 | 职责 |
|---|---|
crates/rushwind-http |
HTTP 边缘:gRPC 对齐的错误信封 HttpError——code/reason/message/details,AuthnError/StorageError 内置转换;请求中间件栈 recovery / request-id / logging / CORS / timeout 与 HttpEdge 装配器;with_authn / with_authorization 把认证鉴权契约接上 axum 路由,Authenticated 提取器;feature 门控的 /healthz+/readyz 与 /metrics 挂载,设计见 docs/http-edge.md |
crates/rushwind-http-binding |
proto-HTTP 线格式契约(由调用方提供描述符池):表单绑定器(点路径、两种字段名拼写、map/list/oneof 结构、周知叶子白名单)、Content-Type codec 解析、认证前 bind 层、protojson 响应 codec、每路由生命周期尾部、四字段状态错误信封 |
crates/rushwind-gen-http |
描述符驱动的 proto-HTTP 路由面代码生成器:每 binding 路由表 + 表单绑定计划、(package, reason)→HTTP 状态码错误表、每 service 一个 trait + 空占位实现、public/gated 挂载发射器 |
crates/rushwind-proto-build |
契约构建引擎(build-dep):buf 注释闭包(选项字节保真)+ protox 类型面过滤 + prost/pbjson(可选 tonic)+ gen-http face 发射(字节级子闭包切片),部署 build.rs 缩为配置 |
crates/rushwind-redact |
静态响应脱敏:(redact.v1) 选项 fail-closed 编译成计划,序列化前原地改写动态消息(mask/email/固定值/element 嵌套/method_skip),语义锚定 protoc-gen-go-redact 的生成物 |
| 位置 | 职责 |
|---|---|
crates/rushwind-storage |
存储契约:Repository trait、三种分页(Page/Offset/Token)、过滤器树、Viewer 五级租户、FieldMask、审计钩子 |
crates/rushwind-storage-memory |
内存参考引擎:过滤器/排序/游标的语义基准,零依赖 |
crates/rushwind-storage-seaorm |
SeaORM 引擎:SQLite/PostgreSQL/MySQL 三后端同启,三方言 SQL 快照钉死渲染,SQLite 过一致性套件,live 套件跑 CI 容器 |
crates/rushwind-storage-seaorm-support |
类型化实体服务桥:PagingRequest select 装配(query 语法过滤/orderBy/三态切片、按列型绑定)、SeaORM 失败→信封、实体时间↔proto Timestamp |
crates/rushwind-storage-seaorm-migration |
SeaORM 服务的 schema 迁移机械:从实体定义生成建表语句,以带追踪的 sea-orm-migration 应用 |
crates/rushwind-storage-mongodb |
MongoDB 引擎:FilterExpr→BSON 翻译离线单测,LIKE 族编译为转义正则,live 套件跑 CI 容器 |
crates/rushwind-storage-elasticsearch |
Elasticsearch 引擎:REST + refresh-on-write,.keyword 精确匹配,bulk 原子批写 |
crates/rushwind-storage-opensearch |
OpenSearch 引擎:ES 线格式薄复用(wire 兼容) |
crates/rushwind-storage-cassandra |
Cassandra 引擎:bucket 固定分区 + 契约求值器过滤,LWT 原子批写 |
crates/rushwind-storage-influxdb |
InfluxDB 引擎:measurement 即表,id 为 series tag,InfluxQL 删除 |
crates/rushwind-storage-clickhouse |
ClickHouse 引擎:SQL over HTTP,mutations_sync 读己之写,探针式冲突检测 |
crates/rushwind-storage-cache |
Cache-Aside 装饰器:SingleFlight 合并击穿、缓存键含 viewer 作用域、generation 防陈旧回填 |
crates/rushwind-storage-soft-delete |
软删除装饰器:墓碑写入、全读路径过滤、restore/purge,引擎无关 |
crates/rushwind-storage-observe |
观测装饰器:每调用一个 tracing span(table/op/outcome),OTel 导出交由 subscriber 选型 |
crates/rushwind-storage-tree |
树形查询:children/roots/ancestors/subtree,契约级遍历 + 环检测,任意引擎可用 |
crates/rushwind-storage-proto |
proto 契约线格式:proto/rushwind/storage/v1/query.proto 生成(prost + pbjson),29 操作符映射 + AIP 文本解析 |
crates/rushwind-storage-macros |
ToRecord/FromRecord derive 宏:DTO↔Record 映射编译期生成;标量族加宽、#[record(as_text)] 枚举、#[record(with = "…")] 自定义转换、#[record(rename)] 列名 |
crates/rushwind-storage-axum |
HTTP 端点层:任意 Repository 挂成 CRUD 路由,列表查询双入口(protojson q / AIP filter),viewer 钩子收口租户 |
| 位置 | 职责 |
|---|---|
crates/rushwind-vector |
向量检索契约(RAG/语义检索):统一 VectorQuery、score 恒为越大越相似(余弦 1−d/L2 1/(1+d)/点积原值)、TopK 非分页、维度纪律、pgvector 文本编解码——纯类型与纯函数 |
crates/rushwind-vector-memory |
内存参考引擎:暴力 top-k + 维度固定/拒绝,外部引擎适配器的语义基准,附 criterion benchmark(搜索成本基线) |
crates/rushwind-vector-qdrant |
Qdrant 引擎:REST 上手写 reqwest 无 SDK——按 metric 后缀的命名向量({field}__cosine/euclidean/dot,服务端 top-k 对每个契约 metric 都正确,代价 3× 存储;既有的裸字段单 metric 集合走单 metric 模式)、维度纪律读服务端配置、自由字符串 id 经确定性 SHA-1→UUID 映射 + payload 回带原 id |
crates/rushwind-vector-milvus |
Milvus 引擎:v2 RESTful 手写 reqwest——metric 后缀三集合(服务端 top-k 对每个契约 metric 正确)、维度纪律读 describe、listCollections 扫描式跨字段删除 |
crates/rushwind-vector-weaviate |
Weaviate 引擎:REST batch + GraphQL nearVector 手写 reqwest——metric 后缀三类(CamelCase 净化)、引擎侧维度注册表(Weaviate schema 不报维度)、dot 面如实声明为保序余弦面 |
crates/rushwind-vector-neo4j |
Neo4j 引擎:HTTP 事务 Cypher 手写 reqwest——metric 后缀三标签 + 向量索引(服务端钉维度、错误 prose 映射 typed 失配)、kNN 查询、标签注册表跨字段删除;cosine 相似度直通/dot 原始积直通 |
| 位置 | 职责 |
|---|---|
crates/rushwind-authn |
认证契约:Authenticator trait(提取/验证两半)、AuthClaims 声明包、错误分类学、AuthenticationGate 门链接入层,见 docs/security-authn-authz.md |
crates/rushwind-authn-apikey |
API-key 引擎:静态 key 集 / 每键 claims / 验证回调 |
crates/rushwind-authn-basicauth |
Basic-Auth 引擎:RFC 7617 凭证对静态用户表或验证回调 |
crates/rushwind-authn-hmac |
HMAC 引擎:keyID.timestamp.signature 签名校验,时钟偏移窗口 |
crates/rushwind-authn-jwt |
JWT 引擎:HS/RS/PS/ES/EdDSA 族的铸造与验证 |
crates/rushwind-authn-oidc |
OpenID Connect 引擎:discovery + JWKS 构造期拉取并按 kid 缓存,验证本地同步(门链可用),refresh 显式/后台任务,iss/aud/exp 严格钉死,minting 拒绝 |
crates/rushwind-authn-noop |
Noop 引擎:全放行、铸造空凭证 |
crates/rushwind-authn-presharedkey |
预共享 key 引擎:集合成员校验、铸造为随机抽取 |
crates/rushwind-authn-session |
会话引擎:不透明会话 ID + 可插拔 SessionStore |
crates/rushwind-authn-gate |
门会话阶段:AccessTokenChecker 契约(Redis 白名单/黑名单)与 authenticate-then-check 阶段头,trace-id 解析、未验签 bearer 嗅探;信封渲染留部署侧错误表 |
crates/rushwind-authz |
鉴权契约:Engine trait(单裁决 + 三批量过滤)、Subject/Action/Resource/Project 模型、策略 JSON 互通,见 docs/security-authn-authz.md |
crates/rushwind-authz-acl |
ACL 引擎:有序 allow/deny 规则 + 通配匹配,默认拒绝、拒绝优先 |
crates/rushwind-authz-rbac |
RBAC 引擎:角色→权限、用户→角色双表,传递继承带环检测 |
crates/rushwind-authz-noop |
Noop 引擎:单裁决全通过、批量过滤全空 |
crates/rushwind-password |
密码哈希契约:PasswordHasher 一脸包 PHC 字符串——验证由存量哈希内嵌参数驱动,needs_rehash 是升级闭环的另一半 |
crates/rushwind-password-argon2 |
Argon2id 引擎:OWASP 默认成本(m=19456,t=2,p=1),遗留面(argon2i/v16)验证通过但读作待升级 |
crates/rushwind-password-bcrypt |
bcrypt 引擎:MCF 串 + 常数时间验证,72 字节截断是算法本身行为(文档与钉子都说实话) |
crates/rushwind-password-scrypt |
scrypt 引擎:OWASP 默认(ln=17,r=8,p=1),存量哈希内嵌 ln/r/p 驱动验证 |
crates/rushwind-password-pbkdf2 |
PBKDF2-HMAC-SHA256 引擎:OWASP 默认 60 万轮,SHA-512 验证放行、SHA-1 拒为 InvalidHash |
| 位置 | 职责 |
|---|---|
crates/rushwind-config |
配置源契约:Source trait(load + 可选 watch/watch_value 能力默认方法)、SignalStream/ValueStream 流契约、FallbackSource 优先级合成(首答胜出 + 有效值变更流合并,无任务边界) |
crates/rushwind-config-env |
环境变量引擎:默认键 + 前缀解析,未设变量为"缺席"而非错误 |
crates/rushwind-config-file |
文件引擎:整文件读取 + 父目录监视(编辑器原子重命名安全),事件突发合并、陈旧值内容抑制,流 Drop 即停 |
crates/rushwind-config-http |
HTTP 配置源:URL 即键的 GET + 轮询 ValueWatcher |
crates/rushwind-config-etcd |
etcd 配置源:按键 GET + 原生 Watch,signal/push 双模式 |
crates/rushwind-config-consul |
Consul KV 配置源:按键 GET + blocking query 的 push 式 watch |
crates/rushwind-config-embedded |
编译期嵌入源:include_bytes!/include_str! 喂进的静态键→字节树,零 I/O、不可 watch(链接期即定) |
crates/rushwind-config-apollo |
Apollo 配置源:configs REST 读(canonical JSON、404=缺席)+ notifications/v2 长轮询 watch,手写 reqwest 无 SDK |
crates/rushwind-config-nacos |
Nacos 配置源:v1 cs/configs REST 读(原文直传、404=缺席、可选 tenant/accessToken)+ 轮询 watch,手写 reqwest 无 SDK |
crates/rushwind-config-kubernetes |
Kubernetes ConfigMap 配置源:v1 configmaps REST 读(canonical key-sorted JSON、404=缺席、可选 namespace/bearer token)+ 轮询 watch,手写 reqwest 无 SDK |
| 位置 | 职责 |
|---|---|
crates/rushwind-registry |
注册中心契约:Registrar + Discovery 双 trait,键布局/线格式以 golden 测试字节级钉死 |
crates/rushwind-registry-etcd |
etcd 适配器:注册 + 发现,租约 TTL + 自愈 keepalive,句柄 Drop 回退过期;live 套件(CI etcd 容器)钉死互操作 |
crates/rushwind-registry-consul |
Consul 适配器:agent HTTP API 上的注册与发现 |
crates/rushwind-registry-eureka |
Eureka 适配器:eureka v2 REST API 上的注册与发现 |
crates/rushwind-registry-kubernetes |
Kubernetes 适配器:kube 客户端的 in-cluster pod 标签注册 + pod watch 发现 |
crates/rushwind-registry-nacos |
Nacos 适配器:nacos-sdk naming 客户端上的注册与发现 |
crates/rushwind-registry-polaris |
Polaris 适配器:polaris v1 HTTP 客户端 API 上的注册与发现 |
crates/rushwind-registry-servicecomb |
ServiceComb 服务中心适配器:v4 注册 API 上的注册、心跳与 WebSocket watch |
crates/rushwind-registry-zookeeper |
ZooKeeper 适配器:ZooKeeper 协议上的注册与发现 |
| 位置 | 职责 |
|---|---|
crates/rushwind-metrics |
指标契约:Metrics trait(counter 累加 / histogram 记录 / gauge 设置),标签规范化排序,记录永不失败调用方 |
crates/rushwind-metrics-prometheus |
Prometheus 引擎:按名懒注册 + 每类缓存表,encode() 渲染文本格式挂 /metrics 路由 |
crates/rushwind-metrics-otel |
OTel 引擎:OTLP 导出(gRPC/HTTP 二进制 protobuf),仪表懒创建缓存,gauge 以 up-down counter 代位 |
crates/rushwind-metrics-datadog |
Datadog 引擎:手写 DogStatsD 线协议 over UDP,标签排序、采样率后缀、可选批量缓冲 |
crates/rushwind-tracer |
追踪契约:OTLP tracer-provider 装配 + W3C trace-context 载体助手 |
crates/rushwind-health |
健康检查契约:Status/Result/Checker + 每检查独立超时的聚合器 + TCP/HTTP 检查器 + axum 处理器 |
| 位置 | 职责 |
|---|---|
crates/rushwind-retry |
可组合重试:指数退避 + 抖动、重试谓词、总超时 |
crates/rushwind-ratelimit |
限流契约:算法无关的 Limiter trait |
crates/rushwind-ratelimit-tokenbucket |
令牌桶引擎:按速率回填 + 突发容量,Allow/Wait/Close,时钟可注入(记账走注入钟) |
crates/rushwind-ratelimit-bbr |
BBR 式自适应引擎:滑窗吞吐估计 + inflight 上限,时钟可注入(窗口旋转走注入钟) |
crates/rushwind-ratelimit-slidingwindow |
滑动窗口日志引擎:任意滑动窗内至多 limit 次准入,边界精确无固定窗双预算缝,日志内存以 limit 为界,时钟可注入 |
crates/rushwind-ratelimit-leakybucket |
漏桶(整流)引擎:背漏恒速排出、准入按 drain_rate 节流、空闲不攒额度(与令牌桶的突发语义相对),时钟可注入 |
crates/rushwind-circuitbreaker |
熔断契约:State + CircuitBreaker trait(Allow/MarkSuccess/MarkFailure/Execute/State/Close) |
crates/rushwind-circuitbreaker-vegas |
Vegas 式引擎:延迟膨胀探测 |
crates/rushwind-circuitbreaker-sres |
Google SRE 概率式引擎:以接受率优雅衰减取代硬开/硬闭 |
crates/rushwind-circuitbreaker-hystrix |
Hystrix 式引擎:错误率阈值 + 睡眠窗 + 半开试探 |
| 位置 | 职责 |
|---|---|
crates/rushwind-cache |
KV 缓存契约:get/set/SetNX/批量 + TTL |
crates/rushwind-cache-local |
进程内 KV 引擎:TTL 惰性过期 + 容量驱逐 |
crates/rushwind-cache-redis |
Redis 引擎:GET/SET/SETNX/DEL/EXISTS + MGET 与管道批量 |
| 位置 | 职责 |
|---|---|
crates/rushwind-lock |
分布式锁契约:try-once 获取 + 所有权 token + TTL 强制(无 forever-lock)+ 属主校验的 release/extend |
crates/rushwind-lock-memory |
进程内引擎:TTL 惰性过期的 map + token 校验——单进程部署与测试,语义与分布式引擎同套件 |
crates/rushwind-lock-redis |
Redis 引擎:SET NX PX 获取 + token 比对的 Lua 原子 release/extend,live 套件走 CI redis 容器 |
| 位置 | 职责 |
|---|---|
crates/rushwind-broker |
消息契约:Broker / Subscriber trait、Message/Event 形状、JSON handler 助手、AckMode::{Auto, Manual} 与 Event::settle_with 双钩结算、NackAction::{Requeue, Drop}、with_error_handler 错误观察点 |
crates/rushwind-broker-kafka |
Kafka 引擎:samsa 纯 Rust 协议客户端上的每 topic 生产者 + 消费组订阅(免 librdkafka C 工具链);批量自动提交位移,无 ack 面(文档如实声明) |
crates/rushwind-broker-pulsar |
Pulsar 引擎:pulsar-rs 多 topic 生产者 + Shared 消费者,固定订阅名;Manual 结算经 mpsc 回泵(ack_with_id/nack_with_id) |
crates/rushwind-broker-gcpubsub |
Google Cloud Pub/Sub 引擎:v1 REST 手写 reqwest——publish/pull/acknowledge,manual 结算走 ack deadline 清零(零即立即可重投),token 由部署供给与刷新 |
crates/rushwind-broker-sqs |
Amazon SQS 引擎:Query API 手写 reqwest + 手写 SigV4(参考向量钉死签名链)——SendMessage/ReceiveMessage/DeleteMessage/ChangeMessageVisibility,manual 结算 = 删除或可见性归零 |
crates/rushwind-broker-nsq |
NSQ 引擎:nsqd v2 二进制协议手写 tokio(无 SDK)——PUB/SUB/FIN/REQ,Identify 关心跳,Manual 结算 = FIN(成功)/REQ 0(立即重投),头走 JSON 信封(payload base64) |
crates/rushwind-broker-rocketmq |
RocketMQ 引擎:4.x remoting JSON 序列化模式手写 tokio(无 SDK)——SEND_MESSAGE/PULL_MESSAGE/UPDATE_CONSUMER_OFFSET,结算面 = 队列位移(Auto 逐批提交 / Manual 单批窗口),头走 \u0001/\u0002 properties 串;nameserver 路由不在面内(部署直供 broker 地址) |
crates/rushwind-broker-azuresb |
Azure Service Bus 引擎:实体 HTTP REST 面手写 reqwest + 手写 SAS 签名(固定参考向量钉死签名链,token 或静态密钥两立场)——POST /messages 发送(载荷走体、属性走头、id 走 BrokerProperties 信封)、receive-and-delete / peek-lock 两种接收,Manual = complete/abandon(abandon 即 DeliveryCount++ 重投) |
crates/rushwind-broker-memory |
进程内参考 broker:精确主题 pub/sub,Manual 结算真实 in-flight 停驻 + REQ 式立即重投——broker 消费方代码的测试替身(语义基线) |
crates/rushwind-workflow |
工作流契约:上游 Client.Close + Worker.Stop/IsRunning 生命周期 + submit/status/cancel/run 实用面,manifest 不透明 |
crates/rushwind-workflow-memory |
工作流参考引擎:in-process 状态存储,complete() 驱动相位,worker 轮询至终态(语义基线) |
crates/rushwind-workflow-argo |
Argo Workflows 引擎:Argo Server REST 手写 reqwest——submit(POST manifest)/status(phase 映射)/cancel(terminate),worker 轮询至终态 |
crates/rushwind-workflow-temporal |
Temporal 引擎:gRPC-gateway HTTP API 手写 reqwest——start/describe/terminate,gRPC 枚举相位映射(TimedOut→Failed),id 由调用方铸造 |
crates/rushwind-workflow-conductor |
Netflix/Orkes Conductor 引擎:服务器 REST API 手写 reqwest——POST /workflow(id 调用方铸造或服务端铸造——conductor 的诚实差异)、GET /workflow/{id} 状态枚举相位映射(PAUSED→Running)、DELETE /workflow/{id} 终止 |
crates/rushwind-broker-rabbitmq |
RabbitMQ 引擎:lapin 上的 AMQP 0-9-1 发布/订阅,走 amq.topic 交换机;AMQP acker/nacker 直挂结算双钩,nack 按 NackAction requeue |
crates/rushwind-broker-nats |
NATS 引擎:async-nats 上的 core-NATS 发布/订阅;at-most-once,无 ack 面(文档如实声明) |
crates/rushwind-broker-redis |
Redis 引擎:每 topic 专属订阅连接上的 pub/sub;无确认面(文档如实声明) |
crates/rushwind-broker-mqtt |
MQTT 引擎:rumqttc 上的发布/订阅,重连自动重订阅;PUBACK 挂 ack 钩,nack 钩为"扣住 PUBACK"(MQTT 3.1.1 无 NACK 帧) |
crates/rushwind-broker-stomp |
STOMP 引擎:裸 TCP 上的极简 STOMP 1.2 客户端,对接 RabbitMQ stomp 插件;ack:client 订阅,ACK/NACK 帧原生两动作 |
crates/rushwind-transaction |
分布式事务契约:引擎之上的最小客户端面 |
crates/rushwind-transaction-dtm |
DTM 引擎:DTM HTTP 协议(reqwest)上的 saga / TCC / 二阶段消息 / XA |
crates/rushwind-apalis-postgres |
任务队列的 Postgres 存储后端(apalis):SKIP LOCKED 认领、可见性超时、孤儿恢复 |
| 位置 | 职责 |
|---|---|
crates/rushwind-encoding |
编码契约:命名注册的 codec 之后的 serde 编解码 |
crates/rushwind-encoding-json |
JSON 引擎:serde_json 入册命名 codec 注册表 |
crates/rushwind-encoding-msgpack |
MessagePack 引擎:rmp-serde |
crates/rushwind-encoding-yaml |
YAML 引擎:serde_yaml |
crates/rushwind-encoding-toml |
TOML 引擎:toml |
crates/rushwind-encoding-cbor |
CBOR 引擎:ciborium |
crates/rushwind-encoding-bson |
BSON 引擎:bson |
crates/rushwind-encoding-xml |
XML 引擎:quick-xml |
crates/rushwind-encoding-proto |
Protobuf 引擎:prost 二进制 proto,作为类型化 sidecar |
| 位置 | 职责 |
|---|---|
crates/rushwind-script |
脚本引擎契约:能力拆分 trait 族(loader / executor / global / function / module / watch 六能力聚合,sandbox / runtime-hook / sync / quota 四能力独立),probe 方法即能力探测面,ScriptValue 数据桥,名称键工厂注册表,EnginePool / AutoGrowEnginePool,Manager;源契约 ScriptSource / SignalStream 与本地载体、组合(memory、file mtime 轮询、静态树 + 前缀、双策略多源聚合、TTL 失效监视缓存、变换链) |
crates/rushwind-script-wasm |
Wasm 引擎:wasmi 纯解释器上的模块实例化与 _start 导出调用、标量全局存取、按签名严格编组的导出函数调用;异步宿主函数诚实拒绝(同步解释器无桥),其余能力恒拒 |
crates/rushwind-script-cel |
CEL 引擎:cel-rust 表达式编译与求值,ScriptValue 变量桥,map 扁平化为前缀全局变量 |
crates/rushwind-script-lua |
Lua 引擎:mlua vendored Lua 5.4,标准库白名单沙箱、宿主函数注册、指令配额钩子真中断与事后超时检查、watch 重载 |
crates/rushwind-script-javascript |
JavaScript 引擎:boa 运行于专属 actor 线程(命令通道 + 一次性应答,串行执行),全局/模块/脚本函数桥接、结果数组语义、配额事后检查 |
crates/rushwind-script-starlark |
Starlark 引擎:starlark-rust 标准方言模块求值、宿主环境注入、脚本函数调用、JSON 序列化值读回、watch 重排队 |
crates/rushwind-script-config |
配置源桥:任意配置域 Source 适配为脚本 ScriptSource——缺席映射为未找到、错误分类桥(NotWatchable→能力不支持)、信号流直通 |
| 位置 | 职责 |
|---|---|
crates/rushwind-ai |
AI 模型契约:chat 补全 + 流式(含拼装完整的工具调用事件)+ embeddings 三面 trait,对象安全(Arc<dyn …> 是部署形状) |
crates/rushwind-ai-openai |
OpenAI 兼容引擎:reqwest 上的 chat / 流式 / embeddings(SSE 工具调用 delta 按 index 拼装),通吃 OpenAI、Qwen、Ollama |
crates/rushwind-oss |
对象存储契约:S3 兼容存储上的 put/get/delete/list 与 presign,外加 multipart 上传四面(begin/put/complete/abort,部分号 1..=10000、连续组装;presign 仅签名权威引擎可用,缺省 Unsupported) |
crates/rushwind-oss-s3 |
S3 引擎:reqwest 上的 SigV4 签名 REST,覆盖 AWS S3 与 MinIO |
crates/rushwind-oss-local |
本地盘引擎:每 bucket 一实例、目录随 put 物化、缺失读 NotFound、删除幂等、键穿越拒绝;multipart 以暂存目录实现 |
| 位置 | 职责 |
|---|---|
crates/rushwind-bootstrap |
配置驱动装配:YAML → 各域引擎(存储/注册中心/认证/鉴权/broker/缓存/熔断/限流/锁/向量检索/AI/对象存储/指标/配置源/脚本)+ HTTP 服务器(路由包、边缘中间件栈与 CORS、按子树的认证鉴权包装、特性门控的健康与指标挂载)+ cron 传输,全部汇入单一生命周期 |
crates/rushwind-testkit |
跨适配器一致性测试套件(生命周期/存储/密码/向量/锁,特性门控)——任何传输/引擎必须整套通过 |
| 位置 | 职责 |
|---|---|
examples/multi-server |
双服务器生命周期演示(级联停机、阶段顺序) |
examples/axum-admin |
axum 适配器演示:健康路由 + 信号驱动的优雅停机 |
examples/ws-gateway |
WS 网关演示:门拒绝 + 会话上限 + 生命周期级联的会话关闭 |
examples/quic-gateway |
QUIC 网关演示:环回门 + 会话上限 + 握手截止 + 端点级联关闭 |
examples/mqtt-ingest |
MQTT 消费演示:对接外部 broker,信号驱动的干净退出 |
examples/bootstrap-demo |
装配演示:一份 YAML + memory 引擎工厂 + 路由包,起完整服务 |
examples/storage-basics |
同一段 Repository 代码跑内存与 SQLite 双引擎,输出逐行一致 |
examples/storage-json-filter |
JSON/regex 过滤面演示:ARRAY_CONTAINS/JSON_CONTAINS/json_path 双引擎结果一致,REGEXP 在内存引擎命中、在 SQLite 如实拒绝(无 regexp 函数——拒绝而非静默收窄) |
examples/vector-multi-engine |
向量检索演示:同一段检索代码跑内存 + qdrant/milvus/weaviate/neo4j 四外部引擎(各自 VECTOR_*_URL 环境变量启用) |
examples/broker-manual-ack |
AckMode::Manual 端到端演示(MQTT):well-formed 消息 ack、毒 payload nack 重投、错误观察点不杀订阅 |
examples/oss-multipart |
分片上传演示:乱序部分按部分号组装、abort 零残留、S3 半场铸 presigned GET 免凭据拉取 |
examples/apalis-postgres-demo |
任务队列演示:Postgres 存储上的投递/调度/消费全程(认领、重试退避、死信、孤儿恢复) |
┌─ 启动:全部 Server 并发运行 ────────────────────────────┐
│ 触发集合:OS 信号 / 内部 stop() / 外部信号 / 任一 Server 退出 │
└────────────────────────┬──────────────────────────┘
▼
阶段 2:before 钩子(顺序执行,各自独立预算)
▼
阶段 3:全部 Server.stop 并发执行(各自独立预算,panic 隔离)
▼
阶段 4:after 钩子(顺序执行,各自独立预算)
▼
终局:outcome() / subscribe_done() 对外可观察
每一阶段的预算都在该阶段开始的时刻现取现造,绝不继承自更早的上下文。忽略停机信号的 Server 在排水截止时被丢弃(Rust 的 drop 即取消),挂死的 stop() 被截止切断并记录 Timeout。规范细节见 docs/architecture.md。
| 文档 | 内容 |
|---|---|
| docs/architecture.md | 架构与契约语义规范:预算、停机映射、一致性套件用例清单 |
| docs/http-edge.md | HTTP 边缘与中间件栈设计 |
| docs/session-middleware.md | WS/QUIC 会话中间件契约 |
| docs/security-authn-authz.md | 认证/鉴权层契约与威胁面速记 |
| docs/threat-model.md | 威胁模型 |
| docs/tutorials | 13 章系列教程:生命周期 → 装配与配置 → 存储契约 → 查询语法 → HTTP 服务栈 → 认证鉴权 → 消息 → 缓存 → 注册发现与韧性 → 可观测 → 脚本 → 多协议传输 → 测试 |
新传输 = 实现 Server + 过一致性套件,两件事:
// crates/rushwind-transport-<你的栈>/tests/conformance.rs
rushwind_testkit::rushwind_conformance_suite!(crate::your_server_factory);
新存储引擎同理 = 实现 Repository + 过存储套件:
// crates/rushwind-storage-<你的引擎>/tests/conformance.rs
rushwind_testkit::rushwind_storage_conformance_suite!(crate::fresh_repo);
cargo test 全绿即合规。契约语义与套件用例清单见 docs/architecture.md,贡献流程见 CONTRIBUTING.md。
stop() 拖不死进程:每个阶段有硬预算tx7do/rushwind is a public repo on GitHub by tx7do. Rust building-block toolkit for microservices: a lifecycle-orchestration core plus contract crates with conformance-tested engine adapters — transport (axum/WS/QUIC/WebTransport/MQTT), storage, auth, config, discovery, observability, resilience, messaging, scripting, AI, object storage. 100% safe code.
It declares the MIT license on GitHub.
Its maker has not tagged a system, so it is unknown here. Its README says what it needs.
Open "Take it" on its page: Take My Repo writes an install plan for your machine and hands it to your AI agent (Claude Code, Codex or Cursor), which asks you before each step. Take My Repo has not tested it on any machine.
Its last change on GitHub was on 2026-11-20. Take My Repo does not judge from that whether it is maintained.
The Single Sign-On Multi-Factor portal for web apps. OpenID Certified™ and Post-Quantum Cryptography Ready.
Nobody has reviewed it on Take My Repo yet, which says nothing about its quality.

Reverse engineer anything with agents, from app behavior down to native binaries.

A list of Free Software network services and web applications which can be hosted on your own servers

Enterprise admin platform in Go on go-kratos (Ent): Protobuf as the single API contract with full-stack codegen (Go APIs + TypeScript clients, one-click CRUD scaffolds), multi-tenant RBAC (Casbin / OPA / Zanzibar), TOTP MFA, 180-day audit logging aligned with China MLPS 2.0 (等保) — with Vue3 (Vben / Element Plus) and React 19 (Antd) frontends.
Unified transport and broker extension set for the Kratos microservice framework: 30+ message-queue, RPC-framework, realtime, and network-protocol transports as pluggable modules, with generic typed handlers, a unified message abstraction, publish/subscribe middleware chains, and OpenTelemetry tracing.

Go full-stack headless content platform on go-kratos: Protobuf as the single API contract with Go/TypeScript/OpenAPI codegen, REST + gRPC dual-protocol admin/app/core services, multi-tenant isolation with menu/API/data-level RBAC and native i18n — with a Vue3 (Vben) admin and Vue/React/Taro/Flutter app frontends.

User behavior analytics on go-kratos: 25 analysis models (events, funnels, retention, attribution, paths, cohorts, game telemetry) fed by a zero-code web SDK through Kafka into switchable ClickHouse/Doris OLAP storage, with multi-tenant isolation, risk-rule alerts, and Superset reporting.
A comprehensive Go utility library collection, featuring crypto, crypto-currency, UUID/OrderID, mapper, date/time, bankcard, name generator & pagination.