运行与部署

原生 Rust / SQLite

cargo run -- init --data ./var
cargo run -- serve --data ./var

默认监听 127.0.0.1:8787。管理凭据在 var/admin-secret，Unix 创建权限为 0600；WAYPOST_ADMIN_SECRET 可覆盖。原生 CLI 默认为内容生成独立的 encryption-keys。网页使用 HttpOnly/SameSite 管理会话，Actor 连接使用单独的限权 bearer。WAYPOST_PUBLIC_ORIGIN 设置页面 Origin 和工具返回的上传/下载地址。跨站浏览器调用不提供 CORS；支持 HTTP bearer 的助手后端可以连接 MCP。

加密根密钥必须单独安全备份。备份需同时保存 metadata.sqlite 与整个 objects/ 目录（含其 objects.sqlite 索引）。停止服务后复制可获得一致的原生备份。仅恢复 metadata 或仅导出摘要不构成完整恢复。var/、本地凭据与运行资料均被 Git 忽略。

Docker

docker compose up --build -d
docker compose exec waypost cat /data/admin-secret

打开 http://127.0.0.1:8787/dashboard。命名 volume 持久化状态与资料；容器运行用户为 UID 10001，Compose 仅发布本机端口。远程入口应设置实际 WAYPOST_PUBLIC_ORIGIN，由部署方提供 HTTPS。容器配置与原生服务使用同一套迁移。

Cloudflare 本机 D1/R2

需要 Rust/Wasm target、worker-build 0.8.7 和 Wrangler。

rustup target add wasm32-unknown-unknown
cargo install worker-build --version 0.8.7 --locked
cp .dev.vars.example .dev.vars
# 为 .dev.vars 设置自己的至少 32 字节管理凭据
wrangler d1 migrations apply waypost --local
wrangler dev --local --port 8791

使用 http://127.0.0.1:8791，与配置的 Origin 保持一致。此模式只创建本机资源，不需要远程数据库或 bucket。已用本机 Workerd、D1/R2 和官方 MCP SDK 跑通完整例子。

Cloudflare 远程部署

生产部署使用独立的 wrangler.production.toml，模板为 wrangler.production.example.toml。账户、D1/R2、真实 HTTPS Origin、管理密钥和限速绑定须同时配置；真实配置与凭据被 Git 忽略。

发布、线上验收、观察与恢复流程见 Cloudflare 生产运行。当前部署入口和首次版本记录也在该文档中。

Cloudflare 容量与费用

D1 batch 中每条语句仍受独立限制，Free invocation 最多 50 个 D1 查询、每条最多 100 个绑定参数。这里使用较保守的请求/集合上限，describe 返回实际配置。D1 限制；CPU 和实际用量仍受账户计划限制。Workers 限制

加密 Worker 在 256 KiB 上限内缓冲、验证和加解密对象；R2 保存认证密文并使用 create-only 条件。未配置加密的本机开发模式仍可使用 FixedLengthStream。获取和封存必须核对实际对象 metadata。R2 有免费额度，超额收费及适用存储类别以账户配置和官方定价为准。R2 定价

当前协议边界

服务提供持久信箱、独立 Consumer 回执、Blob、来源记忆和操作检查。它不执行模型、私人聊天抓取、语义合并或后台任务。oauth、webhook_events、server_export 为 false；客户端导出完整 SQLite/文件包可用。

v0.1 不自动裁剪已发布历史。Tombstone 是逻辑删除，不代表历史字节或其他客户端副本已被物理清除。可通过 WAYPOST_CURSOR_SECRET 独立设置游标签名密钥。内容使用单独的 WAYPOST_ENCRYPTION_KEYS，旧数据迁移与用户隔离见 安全说明；Actor 凭据按同权限轮换保持游标与 Actor 幂等有效。