以本地 mastodon-main 源码快照为对象,按照“是什么 → 怎么做 → 为什么这样做 → 从哪里继续读”的方式,系统拆解 Mastodon 的 Rails Web、ActivityPub 联邦、Sidekiq 异步、Redis 实时流和 React 前端。
npm install
npm run dev
npm run build- 总体架构与进程拓扑
- 领域模型与数据边界
- Web 请求、REST API 与前端入口
- 发帖、分发与 Feed Fan-out
- ActivityPub 联邦协议
- Redis、Streaming 与实时同步
- React 前端与状态管理
- Sidekiq、媒体、搜索与通知
- 安全、权限与内容治理
- 部署、测试与扩展路线
文档站使用 Nextra 4 + Next.js 静态导出,GitHub Actions 构建到 GitHub Pages。