Skip to content
wutzPublic

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Storplan

存储容量和性能规划工具。支持多种存储方案的容量、性能计算和方案对比。

技术栈

  • TanStack Start — 全栈 React 框架
  • TanStack Router — 类型安全的文件路由
  • Tailwind CSS — 样式
  • TypeScript — 类型安全

支持的存储方案

  • XSKY XEOS 混闪对象存储 — 大量 HDD + 少量 NVMe SSD
  • VastData 全闪统一存储 — 文件 / 对象 / 块(NFS、SMB、S3、iSCSI、NVMe-oF)
  • GPFS ECE 全闪文件系统 — 高性能并行文件系统,支持 RoCE/IB 与以太网卡(以太网下性能按 IB 的 30% 预估)
  • GPFS ECE 混闪文件系统 — 大容量并行文件系统(NVMe 元数据层 + HDD 数据层,分别给出开启 / 关闭分层的性能)
  • Weka 全闪文件系统 — 高性能并行文件系统
  • Ceph 全闪统一存储 — 开源,块 / 对象 / 文件
  • Ceph 混闪对象存储 — 开源,HDD 数据层 + NVMe 索引层(RGW)

主题与语言

  • 白天 / 夜间主题:默认跟随系统明暗并随系统实时切换,也可在顶栏右侧按钮固定为白天或夜间。
  • 中文 / English:顶栏右侧一键切换;首次访问按浏览器语言选择。AI 助手也会用当前界面语言回答。
  • 两项偏好都记在 cookie 里,服务端首屏即按偏好渲染,不会闪烁。

AI 规划助手

当前已关闭:src/lib/ai-chat.ts 中的 AI_ASSISTANT_ENABLED 为 false,首页入口与 /api/chat 均已停用(返回 410)。要重新开启,改为 true 后重新部署。

右下角的「AI 规划助手」支持多轮对话:用自然语言描述业务需求(数据量、协议、GPU 规模、预算约束), 模型问清关键条件后选出方案、定出容量与带宽,参数自动填进页面顶部的规划表单,由本站既有的计算逻辑出结果 —— 模型只负责选型与定参,集群规模和性能数字仍由本地算法计算。

先问清,再规划。 规划结果是能拿去询价的配置,用错的前提算出来的配置比不算更糟,所以助手默认先澄清需求:

  • 按需求清单核对四项必要条件(业务与数据形态、容量与增长、协议与接入方式、性能诉求),缺哪项问哪项, 一轮最多问 3 个,开头先复述「已知:…」让你能当场纠错。
  • 每轮提问都带可点选的候选答案,不用打字;其中总有一个「按经验来,先给大概方案」的兜底选项。
  • 提问不超过 3 轮,问不清的项用行业常见值补齐并标注为假设。你说「按经验来 / 你定 / 别问了」会立刻停止提问。
  • 出方案时正文分「已知条件」与「假设」两块,假设逐条列在参数卡上,点一下候选答案(如「余量改成 20% 重算」) 就能让它按新前提重算。

其它:话题限定在存储、Kubernetes、网络、GPU、AI 基础设施,其它问题会被拒答;需要厂商参数等站外信息时会联网检索; 填进表单的参数随时可以手改。

对话框操作:拖卡头可移动、拖左上角手柄可缩放(右下角固定,双击卡头恢复默认位置),位置与尺寸记在 localStorage 里。点面板外或按 Esc 收起。开合是 macOS「缩放特效」那种观感:窗口从右下角那颗按钮里长出来、收起时缩回按钮 (transform-origin 锚在按钮中心,面板被拖到哪儿都朝它飞),prefers-reduced-motion 下直接切换。 收起时面板不卸载,所以再打开时消息与滚动位置都停在离开前。 每张方案卡记着自己那一组参数:表单后来被改过时按钮变成「恢复这组参数并查看」,点一下还原再看结果。

配置(密钥只留在服务端)

浏览器只访问同源的 /api/chat,上游地址、API Key、模型名都留在服务端,不进客户端产物、不进仓库。

本地开发 —— 复制模板后填入自己的密钥(.dev.vars 已被 .gitignore 忽略):

cp .dev.vars.example .dev.vars

生产环境(Cloudflare Workers)—— 用 Secret 下发,不要写进 wrangler.toml:

npx wrangler versions secret put LLM_API_KEY
npx wrangler versions secret put LLM_API_URL   # 可选,默认 https://api.blsc.dev
npx wrangler versions secret put LLM_MODEL     # 可选,默认 claude-haiku-5-5

本项目走版本化上传(wrangler versions upload),有两点要注意:

  1. 用 wrangler versions secret put,不是 wrangler secret put —— 后者在有未部署版本时会被拒绝。
  2. 每个版本在上传那一刻就固定了自己的绑定。先上传的预览版本不会自动获得之后添加的 Secret, 加完 Secret 要重新 npx wrangler versions upload 才能生效,否则预览会一直报「服务端缺少 LLM_API_KEY」。

未配置 LLM_API_KEY 时助手会直接返回「未配置」提示,页面其余功能不受影响。

绑定类型(限流器)不走 process.env,需要生成 Workers 类型后再 tsc:

npm run cf-typegen   # 生成 worker-configuration.d.ts(已 gitignore)

限流

/api/chat 是公开端点,每次提问都消耗上游额度,所以做了两层限流:自有域上的 WAF 规则是主闸门, Worker 内的限流绑定兜住预览域。

先说绑定层 —— wrangler.toml 里两道,命中后返回 429(页面上显示为一条提示,不影响继续改参数):

绑定 计数键 限额
CHAT_IP_LIMITER 调用方 IP(CF-Connecting-IP) 8 次 / 分钟
CHAT_GLOBAL_LIMITER 全站共用 60 次 / 分钟

限流在解析请求体之前执行;绑定缺失或限流服务异常时放行,不影响正常提问。

绑定这层的强度边界(实测):限流绑定的计数缓存在处理请求的那台机器上、异步同步,官方定性为 「宽松、最终一致」。实测:复用同一条 TCP 连接连发时第 8 次被拦;而每次新建连接连发 20 次全部放行 —— 请求落到不同机器,各自从零计数。所以它挡得住浏览器和保持连接的脚本,挡不住每次重连的脚本。

因此自有域上再加一层 WAF 限流,作为真正的闸门。

自有域 WAF 限流(主闸门)

WAF 限流在边缘按 colo 计数,且在请求进入 Worker 之前就拦下来,不消耗上游额度。 用脚本创建,幂等(已存在同名规则则更新):

CLOUDFLARE_API_TOKEN=xxx node scripts/setup-waf-ratelimit.mjs --dry-run  # 先看将要提交的规则
CLOUDFLARE_API_TOKEN=xxx node scripts/setup-waf-ratelimit.mjs            # 应用

Token 需要 Zone → Zone → Read 与 Zone → WAF → Edit,范围限定到该 zone 即可。 默认作用于 storplan.wutz.dev 的 /api/chat,可用 ZONE_NAME / HOSTNAME / TARGET_PATH 覆盖。

脚本会按 zone 的实际套餐挑合法参数,因为各套餐能力差别很大:

套餐 规则数 窗口 计数维度 表达式字段 脚本采用
Free 1 固定 10s 仅 IP 仅 Path(不能匹配主机名) 2 次 / 10s,封禁 10s
Pro 2 ≤ 1min 仅 IP 加 Host / URI / Query 8 次 / 60s,封禁 60s
Business+ 5+ ≤ 10min IP(含 NAT) 加 Method / 源 IP / UA 8 次 / 60s,封禁 300s

Free 套餐下规则只能按路径匹配,会对该 zone 所有主机名的 /api/chat 生效 —— 本项目只有这一个站 用这个路径,实际无影响。

仍然存在的两个缺口,别把 WAF 当成花费上限:

  1. 不覆盖预览域:WAF 只对自有域生效,*.workers.dev 绕过它,只剩绑定那层兜底。预览域是给 PR 验证用的、不对外公布;要彻底堵死就在生产切到自有域后关掉 workers_dev。
  2. 限的是速率,不是总量:wutz.dev 是 Free 套餐,窗口固定 10 秒,最紧也只能压到 1–2 次/10s, 换算下来单 IP 每天仍可发起上万次请求,而每次都是一次 Haiku 调用。WAF 大幅拉高了刷量成本, 但真要给花费设硬顶,得再上其中一条:上游 API Key 侧的额度限制、Durable Object 做每日配额、 或给助手加访问控制(Turnstile / 登录)。

快速开始

# 安装依赖
npm install

# 启动开发服务器
npm run dev

# 构建生产版本
npm run build

# 预览生产构建
npm run preview

访问 http://localhost:3000

项目结构

storplan/
├── src/
│   ├── components/
│   │   ├── ai-assistant.tsx      # AI 规划助手:浮动按钮 + 多轮对话面板
│   │   └── prefs-switcher.tsx    # 顶栏的主题 / 语言切换按钮
│   ├── lib/                      # 容量与性能计算逻辑
│   │   ├── utils.ts              # 容量 / 带宽的单位解析与格式化
│   │   ├── i18n.tsx              # 语言与主题偏好(cookie + 首帧主题脚本)
│   │   ├── storage-catalog.ts    # 方案知识库,页面与 AI 提示词共用
│   │   ├── storage-catalog-en.ts # 方案知识库英文版
│   │   ├── xeos.ts               # XSKY XEOS 对象存储规划
│   │   ├── vastdata.ts           # VastData 统一存储规划
│   │   ├── vastdata-data.ts      # VastData 容量 / 性能参考数据(自动生成)
│   │   ├── gpfs-ece.ts           # GPFS ECE 全闪文件系统规划
│   │   ├── gpfs-hybrid.ts        # GPFS ECE 混闪文件系统规划
│   │   ├── ceph.ts               # Ceph 全闪统一存储规划
│   │   ├── ceph-hybrid.ts        # Ceph 混闪对象存储规划
│   │   ├── weka.ts               # Weka 全闪文件系统规划
│   │   ├── ai-chat.ts            # 对话契约与规划指令解析
│   │   └── ai-system-prompt.ts   # AI 系统提示词,仅服务端引用
│   ├── routes/                   # 路由页面
│   │   ├── __root.tsx            # 根布局与全局 meta
│   │   ├── index.tsx             # 首页:选型、参数表单与结果卡片
│   │   └── api.chat.ts           # POST /api/chat,LLM 流式代理
│   ├── router.tsx                # 路由实例
│   └── styles.css                # 全局样式
├── scripts/
│   └── setup-waf-ratelimit.mjs   # 创建 / 更新 WAF 限流规则
├── dist/                # 构建输出
├── DESIGN.md            # 设计规范(颜色、排版、组件样式)
├── package.json
├── tsconfig.json
└── vite.config.ts

部署

Cloudflare Workers

通过 wrangler CLI 手动部署:

npm run deploy

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages