2026-11-11
W Commons:把重复出现的基础能力整理成库
看 HTTP、存储、通知和安全辅助组件如何作为公开 Rust 依赖组合使用。
W Commons:把重复出现的基础能力整理成库
多个服务都会遇到 HTTP 请求、重试、对象存储、通知和基础加密等需求。把这些能力整理成库,可以让每个产品继续保持独立,同时减少相同底层代码反复出现。W Commons 是这一组公开 Rust 组件。
组件覆盖哪些职责
公开仓库包含时钟和缓存等工具、哈希与 HMAC、周期任务、异步及阻塞 HTTP 客户端、模型协议与供应商适配、通知、文件系统和可选 S3 兼容存储,以及 Web 服务辅助组件。各组件通过 crate 和特性选择组合;不需要为一个 HTTP 客户端把所有可选能力都打开。
存储默认可以使用本地文件,可选特性接入 S3 兼容服务。模型供应商、邮件、网络与地理数据库等能力仍需要使用者自行准备服务或数据,公开源码不会附带生产配置和用户凭据。
通知为何需要额外边界
如果 Webhook 地址来自用户,服务不能简单地相信输入。公开文档提供可选 SSRF 防护:发送前校验公共 DNS 地址、固定连接目标,并关闭代理继承和自动重定向。这个能力需要显式启用;未启用防护的调用仍遵循其原有行为。
公开仓库从 2026 年 11 月的依赖组件发布开始,随后增加了公开依赖审计。它保留组件名称和特性接口;具体版本、许可证与更新应以 仓库文档 为准。