e
pointed to any OpenAI-compatible endpoint, including local models via Ollama or LiteLLM:````
bas
h
# 在 AFFiNE 管理面板 > 设置 > AI 中
 # 提供商 URL：http://your-ollama:11434/v1
 # API 密钥：sk-ollama（或您的密钥）
 # 型号：llama3.2 或您喜欢的型号# 或者直接使用OpenAI
 # 提供者网址：https://api.openai.com/v1
 # 型号：gpt-4o-mini
 ````**3. 用于外部自动化的 REST API**````
bas
h
# 通过API导出工作区数据
 curl -H“授权：持有者$AFFINE_TOKEN”\
 http://localhost:3010/api/workspaces# 以编程方式导入文档
 卷曲 -X POST http://localhost:3010/api/docs \
 -H“授权：持有者$AFFINE_TOKEN”\
 -H“内容类型：application/json”\
 -d '{"title":"Sprint 回顾","content":"<blocks>...</blocks>"}'
 ````**4. 适用于开发人员工作流程的 Git 同步**将 AFFiNE 的导出功能与“git”结合使用以获取版本控制的文档：````
bas
h
#!/bin/bash
 # daily-backup.sh - 每晚执行此计划
 docker exec affine-postgres pg_dump -U affine affine > backup-$(date +%Y%m%d).sql
 git add backup-*.sql && git commit -m "docs: 每日 AFFiNE 备份 $(date +%Y-%m-%d)"
 ````## 基准/实际用例AFFiNE 的性能特征对于生产部署很重要：| 公制| AFFiNE 自托管 | 概念云 | 米罗云|
 |--------|--------------------|```
bas
h
# 测试 CalDAV 连接性
 卷曲 -X PROPFIND https://your-nextcloud.com/remote.php/dav/calendars/admin/personal/ \
 -u 管理员:密码\
 -H“内容类型：文本/xml”\
 -d '<?xml version="1.0"?><d:propfind xmlns:d="DAV:"><d:prop><d:displayname/></d:prop></d:propfind>'
 ````|
 | 并发用户（4-CPU）| **25+** | 无限（云）| 无限（云）|
 | 内存（空闲）| 280MB（个人）| 不适用 | 不适用 |
 | 每 1000 个文档的存储空间 | **~450MB** | 不适用（专有）| 不适用（专有）|**真实部署故事：** 一个 12 人 SaaS 团队于 2026 年 3 月从 Notion+Miro 迁移到自托管 AFFiNE。迁移包括 340 个文档、18 个白板和 2,800 个任务。 新加坡和 Be```
bas
h
之间的同步延迟
 # 在 AFFiNE 管理面板 > 设置 > AI 中
 # 提供商 URL：http://your-ollama:11434/v1
 # API 密钥：sk-ollama（或您的密钥）
 # 型号：llama3.2 或您喜欢的型号

 # 或者直接使用OpenAI
 # 提供者网址：https://api.openai.com/v1
 # 型号：gpt-4o-mini
 ``当前编辑场景，每个文档有 500 个块。 同步延迟是使用 Chrome DevTools 通过 WebSocket 帧检查来测量的。 第一个 Contentful Paint 是用 Lighthouse 测量的。 通过断开网络、执行 50 次编辑、重新连接并确认``bash 来验证离线能力
 # 通过API导出工作区数据
 curl -H“授权：持有者$AFFINE_TOKEN”\
 http://localhost:3010/api/workspaces

 # 以编程方式导入文档
 卷曲 -X POST http://localhost:3010/api/docs \
 -H“授权：持有者$AFFINE_TOKEN”\
 -H“内容类型：application/json”\
 -d '{"title":"Sprint 回顾","content":"<blocks>...</blocks>"}'
 ````唷
}
 EOF
 ````**备份策略：**````
bas
h
# 自动每日备份
 猫 > backup-affine.sh << 'EOF'
 #!/bin/bash
 设置-euo管道故障
 BACKUP_DIR="/backups/affine-$(日期 +%Y%m%d)"
 mkdir -p“$BACKUP_DIR”
 # PostgreSQL 转储
 docker exec affine-postgres pg_dump -U affine -Fc affine >“$BACKUP_DIR/db.dump”
 # 文件存储
 tar czf "$BACKUP_DIR/storage.tar.gz" -C ./storage .
 # 配置
 cp -r ./config "$BACKUP_DIR/"
 # 保留：保留14天
 查找/备份-maxdepth 1 -name 'affine-*' -mtime +14 -exec rm ```
bas
h
#!/bin/bash
 # daily-backup.sh - 每晚执行此计划
 docker exec affine-postgres pg_dump -U affine affine > backup-$(date +%Y%m%d).sql
 git add backup-*.sql && git commit -m "docs: 每日 AFFiNE 备份 $(date +%Y-%m-%d)"
 ``rid.net',
 “端口”：587，
 “安全”：假，
 “授权”：{
 “用户”：“apikey”，
 "pass": "SG.your-api-key"
 },
 “来自”：“AFFiNE <affine@yourdomain.com>”
 }
 }
 ````**OAuth 身份验证（谷歌）：**````
bas
h
# 在 config/affine.js 中
 {
 “授权”：{
 “oauth”：{
 “提供商”：[{
 “名称”：“谷歌”，
 "clientId": "YOUR_GOOGLE_CLIENT_ID",
 "clientSecret": "YOUR_GOOGLE_SECRET",
 “callbackUrl”：“https://affine.yourdomain.com/api/auth/google/callback”
 }]
 }
 }
 }
 ````**数据库连接池调整：**````
yam
l
# 添加 docker-compose.yml 用于高负载场景
 环境：
 - DATABASE_URL=postgresql://affine:${DB_PASSWORD}@postgres:5432/affine
 - 数据库池大小=20
 - DATABASE_POOL_MAX=50
 - DATABASE_TIMEOUT=30000
 ````## 与替代方案的比较| Feature | AFFiNE v0.26 | Notion | Miro | Obsidian |
|---------|-------------|--------|------|----------|
| Open Source | **Yes (MPL-2.0)** | No | No | No |
| Self-Hostable | **Yes** | No | No | No (sync is cloud) |
| Local-First / Offline | **Yes (CRDT)** | Partial (cache) | No | **Yes** |
| Edgeless Whiteboard | **Yes (native)** | No | Yes (native) | No |
| AI Writing Assistant | **Yes (open API)** | Yes (closed) | No | Yes (plugins) |
| Real-Time Collaboration | **Yes** | Yes | Yes | No (conflict risk) |
| Bi-Directional Linking | **Yes** | Limited | No | **Excellent** |
| Block-Based Editor | **Yes (BlockSuite)** | Yes | No | No |
| Database / Kanban Views | **Yes** | **Excellent** | Basic | Via plugins |
| Price (Team 10 users) | **$0 (self-hosted)** | $96/mo | $160/mo | $80/mo (sync) |**何时选择 AFFiNE 而不是每个竞争对手：**- **对比。 概念：** 您需要一个连接到文档的白板，想要数据所有权，或者需要离线优先访问。 Notion的数据库公式还是更强大。 
- **对比。 Miro：** 你希望头脑风暴成为可操作的任务并链接到文档````
bas
h
# 使用 Caddy 作为反向代理
 猫 > Caddyfile << 'EOF'
 affine.yourdomain.com {
 反向代理本地主机:3010
 tls admin@yourdomain.com
 }
 EOF
 ``g 图对于单独研究人员来说是无与伦比的。## 局限性：诚实评估AFFiNE 并不完美。 以下是提交之前需要了解的内容：1. **数据库公式有限```
bas
h
# 自动每日备份
 猫 > backup-affine.sh << 'EOF'
 #!/bin/bash
 设置-euo管道故障
 BACKUP_DIR="/backups/affine-$(日期 +%Y%m%d)"
 mkdir -p“$BACKUP_DIR”
 # PostgreSQL 转储
 docker exec affine-postgres pg_dump -U affine -Fc affine >“$BACKUP_DIR/db.dump”
 # 文件存储
 tar czf "$BACKUP_DIR/storage.tar.gz" -C ./storage .
 # 配置
 cp -r ./config "$BACKUP_DIR/"
 # 保留：保留14天
 查找/备份-maxdepth 1 -name 'affine-*' -mtime +14 -exec rm -rf {} +
 EOF
 chmod +x backup-affine.sh
 # 每天凌晨 2 点跑步
 回声“0 2 * * * /root/backup-affine.sh”| crontab -
 `` 一般适合公司内部使用。5. **管理仪表板很小。** 用户管理、审核日志和高级 RBAC 正在改进，但不如 Notion Enterprise 或 Confluence 成熟。## 常见问题**问：当两个用户同时编辑同一个块时，AFFiNE 如何处理冲突？**答：AFFiNE 使用 CRDT（基于 Yjs）来解决冲突。 当两个用户编辑同一块时，更改会根据混合逻辑时钟自动合并。 在实践中，并发文本编辑干净地交错，并且结构更改（例如移动块）使用最后写入获胜机智```
bas
h
# config/affine.js 或通过管理 UI
 {
 “邮寄者”：{
 “主机”：“smtp.sendgrid.net”，
 “端口”：587，
 “安全”：假，
 “授权”：{
 “用户”：“apikey”，
 "pass": "SG.your-api-key"
 },
 “来自”：“AFFiNE <affine@yourdomain.com>”
 }
 }
 ``内容和图像传输正确。 数据库视图转换为 AFFiNE 数据库表，但复杂的 Notion 公式可能需要手动调整。**问：20 人团队的自托管 AFFiNE 有哪些硬件要求？**答：最低要求：2 个 CPU 核心、4GB RAM、20GB SSD。 推荐```
bas
h
# 在 config/affine.js 中
 {
 “授权”：{
 “oauth”：{
 “提供商”：[{
 “名称”：“谷歌”，
 "clientId": "YOUR_GOOGLE_CLIENT_ID",
 "clientSecret": "YOUR_GOOGLE_SECRET",
 “callbackUrl”：“https://affine.yourdomain.com/api/auth/google/callback”
 }]
 }
 }
 }
 ```如果您配置了外部
API 密钥。 默认情况下，自托管实例中AI助手处于禁用状态。 您可以将其指向完全在您的硬件上运行的本地 Ollama 实例，确保零数据离开您的网络。 与 Notion AI 相比，这是一个主要的隐私优势，Notion AI 将内容发送到 OpenAI 的服务器。**问：我可以运行 ``yaml
 # 添加 docker-compose.yml 用于高负载场景
 环境：
 - DATABASE_URL=postgresql://affine:${DB_PASSWORD}@postgres:5432/affine
 - 数据库池大小=20
 - DATABASE_POOL_MAX=50
 - DATABASE_TIMEOUT=30000
 ```` 生产路径。 从源代码构建主要针对为项目做出贡献的开发人员。## 结论：拥有你的知识AFFiNE 代表了知识管理的转变：从依赖云的订阅到本地优先、自托管的所有权。 通过将文档、白板和数据库统一在一个开源平台中，您可以消除工具碎片，同时保持对数据的完全控制。立即使用 Docker 在 5 分钟内进行部署，连接您选择的 AI 模型，并加入 69,309 多名为该项目加注星标的开发人员。 自托管路径已做好生产准备，CRDT 同步稳定，并且团队正在快速交付。对于目前每个用户每月为 Notion 或 Miro 支付 15-20 美元的团队来说，经济理由是引人注目的：对于 20 人的团队来说，每月 24 美元的 VPS 可以取代这两种工具，并具有更好的隐私性、更低的延迟和完整的数据所有权。 迁移路径很简单 - Notion 直接导出到 AFFiNE，白板内容可以重新创建或导入为图像，然后转换为实时块。**开始使用：** 克隆 [toeverything/AFFiNE](https://github.com/toeverything/AFFiNE) 存储库，按照上面的 Docker 设置进行操作，并加入 [Telegram 社区](https://t.me/affineworkspace) 以获得支持。 通过 DigitalOcean
 在 VPS 上自行托管您的知识库，再也不用担心供应商锁定。## 资料来源和进一步阅读- [AFFiNE 官方文档](https://docs.affine.pro/)
 - [AFFiNE GitHub 存储库](https://github.com/toeverything/AFFiNE) — 69,309 颗星，MPL-2.0
 - [BlockSuite 编辑器框架](https://github.com/toeverything/blocksuite)
 - [自托管 AFFiNE 指南](https://docs.affine.pro/self-host-affine)
 - [CRDT 和本地优先软件 (Ink & Switch)](https://inkandswitch.com/local-first/)
 - [Docker Compose 生产最佳实践](https://docs.docker.com/compose/product/)







 ## 推荐的托管和基础设施在将上述任何工具部署到生产环境之前，您需要坚实的基础设施。 dibi8实际使用和推荐的两个选项：- **{< aff "digitalocean" "footer-cta-legacy" "DigitalOcean" >}}** — 200 美元免费赠金，为期 60 天，覆盖全球 14 个以上区域。 运行开源人工智能工具的独立开发者的默认选项。 
- **{< aff "htstack" "footer-cta-legacy" "HTStack" >}}** — 从中国大陆低延迟访问的香港 VPS。 这与托管 dibi8.com 的 IDC 是同一个 IDC——在生产中经过了实际考验。*附属链接 - 它们不会花费您额外的费用，并且有助于保持 dibi8.com 的运行。*## 附属机构披露本文包含 DigitalOcean 的附属链接。 如果您通过我们的链接注册，我们将收到佣金，您无需支付额外费用。 所有建议均基于实际测试，不受联盟计划的影响。 AFFiNE 完全开源，可免费自行托管，无需任何付费要求。
featureImage: /images/articles/affine-2026miro.png