xfy
694e198331
依据代码核对修正多处不准确/缺失的注释，纯文档改动，无行为变化。
修正的不准确项：
- RATE_LIMIT_STRICT_* 实际覆盖登录/注册/评论预检/搜索，原注释只写登录注册
- STATEMENT_TIMEOUT_SECS 是 Postgres 服务端取消（非客户端断连），仅经连接池的连接生效
- COMPRESSION_ALGORITHMS 示例值（四项全开）等价于 all，消除注释默认 vs 示例值的歧义
补全的缺失细节：
- RUST_LOG 补细粒度语法示例（info,yggdrasil=debug）
- 限流项统一说明 token bucket 模型（PER_SEC 稳态 / BURST 突发容量）
- MAX_SESSIONS_PER_USER 超限按最旧优先删除（LRU）
- DB_POOL_SIZE 与 Postgres max_connections 的关系
- WEBP_QUALITY/METHOD 越界会 clamp 不报错
- TRUSTED_PROXY_COUNT 设错的双向安全后果
- IMAGE_DISK_CACHE_* 清理任务每小时跑一次
- MIGRATE_STARTUP_TIMEOUT_SECS 500ms 固定间隔轮询
- SSR_CACHE_SECS 文章更新后最长滞后 TTL 秒可见
- APP_BASE_URL 反向代理后 Host 头可被影响的 CSRF 风险
结构上用分隔线分组（Rate Limit / Security / WebP / SSR / Image Cache），
安全注意事项用 ⚠️ 标记。
Yggdrasil
基于 Dioxus 0.7 的全栈博客系统，Rust 单一代码库同时编译为 WASM 前端和原生服务端。
技术栈
- 框架: Dioxus 0.7 (fullstack)
- 数据库: PostgreSQL + tokio-postgres
- 样式: Tailwind CSS v4
- 密码: Argon2
- 会话: UUID token + cookie
功能
- 邮箱注册 / 登录（单管理员模式，首次注册后关闭）
- 会话管理与自动过期清理
- 暗色 / 亮色主题切换
- 后台文章撰写（Tiptap Markdown 编辑器）
- 文章归档与标签浏览
开发
依赖 Rust 1.95+、wasm32 目标、dx CLI、tailwindcss CLI v4 和 PostgreSQL。
# 配置数据库
DATABASE_URL=postgres://postgres:postgres@localhost:5432/yggdrasil
# 运行迁移（自动创建数据库并按顺序执行 migrations/ 下所有 SQL）
./migrate.sh
# 启动开发服务器
make dev
构建
make build