用途:面向需要把静态前端部署到 Walrus Sites 的场景,使用 site-builder CLI 完成站点创建、更新与管理。
前置条件:需安装并配置 Sui CLI(client.yaml 中的环境要与 sites-config.yaml 的 wallet_env 一致),通过 suiup install site-builder 安装 site-builder,通过 suiup install walrus 安装 walrus,并准备目标网络的 SUI 作为 gas、WAL 作为 blob 存储费用。测试网可用 walrus get-wal 将 SUI 兑换为 WAL。站点需先构建出 dist/ 目录,且应存在 ~/.config/walrus/sites-config.yaml。
主要能力:site-builder deploy --epochs max dist/ 可创建新站点或更新已有站点;输出站点对象 ID 与 base36 子域名,并在源目录生成 ws-resources.json。--epochs 最大 53(测试网约 53 天,主网约 2 年),也可用 --earliest-expiry-time 或 --end-epoch 控制过期;--permanent 仅使 blob 不可删除,不延长时长。可用 site-builder update-resources 更新指定资源。SPA 可在 ws-resources.json 配置 routes 的 /* 指向 /index.html;可配置 headers。site-builder sitemap 查看资源、blob ID 与过期时间;site-builder destroy 移除站点对象。
使用方式:先构建前端,再执行 site-builder deploy --epochs max dist/,更新时重新构建并再次执行 deploy。需将 ws-resources.json 纳入版本控制,否则每次部署都会新建站点。
限制:公共门户 wal.app 仅服务主网;测试网需自托管本地门户。过期 blob 会返回特定 404 且绕过重定向与 404 回退,需提高 --epochs 重新部署。具体配置细节以官方文档为准。