50K Star引爆GitHub的开源知识库神器! 堪称下一代知识操作系统！一站式搞定笔记、白板和协作，一文带你玩转

AFFiNE 以其创新的融合编辑体验、对用户隐私的尊重（本地优先）以及开放的特性，为知识管理和协同创作领域带来了令人耳目一新的选择。它不仅是一个强大的工具，更代表了一种对未来工作方式的探索。无论你是希望整理个人笔记，还是寻求更高效的团队协作平台，都不妨亲自尝试一下 AFFiNE，体验下一代知识库的魅力。

尘烬海

1467人浏览 · 2025-07-01 13:44:23

尘烬海 · 2025-07-01 13:44:23 发布

在信息爆炸的时代，我们依赖各种工具来捕捉灵感、组织知识、管理项目和协同工作。然而，在 Notion 类的文档工具、Miro 类的可视化白板以及 Trello 类的任务板之间不断切换，常常导致信息碎片化和工作流中断。如果你正在寻找一个能够整合这些功能，同时又注重数据隐私和开放性的解决方案，那么开源项目 AFFiNE ([ə‘fain]) 值得你深入了解。

本文将带你全面认识这款被称为“下一代知识库”或“知识操作系统（KnowledgeOS）”的工具，并提供详尽的安装与上手指南，无论你是普通用户还是技术爱好者，都能快速入门。

AFFiNE 是什么？—— 打破边界的统一工作空间

AFFiNE 的核心目标是创建一个统一的数字工作空间，将传统知识管理中的计划（Plan）、整理（Sort） 和 创建（Create） 功能无缝融合。你可以将其理解为：

• Notion 的强大文档编辑能力 + Miro 的自由可视化白板能力 = AFFiNE

它致力于解决现有工具的痛点，特别是针对 Notion 和 Miro 在隐私保护和数据所有权方面的潜在顾虑，提供一个隐私优先、本地优先、完全开源的替代方案。无论是个人知识管理、团队项目协作、会议记录、头脑风暴还是客户反馈整理，AFFiNE 都旨在提供一站式的解决方案。

AFFiNE 的核心特性与优势

1. 革命性的双模态编辑（Paper & Edgeless）

• Paper 模式： 提供结构化的文档编辑体验，采用先进的块编辑器，支持 Markdown 快捷方式，适合撰写笔记、文章和报告。
• Edgeless 模式： 提供一个无限延伸的画布，你可以在上面自由绘制、放置文本块、图片、任务卡片、连接线等，进行头脑风暴、流程图设计、视觉规划等。
• 关键亮点： 这两种模式并非孤立。你可以在白板上添加的文本块，无缝拖拽到文档模式中继续编辑，反之亦然。这种内容块的互通性是 AFFiNE 的核心创新，极大地提升了信息流转的效率。

2. 数据主权在我：本地优先（Local-First）与隐私安全

• 与许多云服务不同，AFFiNE 优先将你的数据存储在本地设备上。这意味着你对自己的知识拥有绝对控制权，无需担心服务商政策变动或数据泄露风险，同时也支持离线使用。
• 对于协作需求，AFFiNE 采用先进的 CRDTs 技术，即使在云端同步（可选功能），也旨在确保数据的最终所有权和安全性。

3. 开放透明：完全开源（Open Source）

• AFFiNE 遵循 MIT 许可证，代码完全公开。这意味着更高的透明度、安全性（社区可审查代码）、自由度（可自托管、定制）和永无供应商锁定之忧。整个项目由全球社区共同驱动发展。

4. 为协作而生：实时同步

• 基于 CRDTs 技术，支持多用户实时、无冲突地在同一文档或白板上进行编辑，确保团队协作的流畅性。

5. 结构化与灵活性并存：块与数据库

• 所有内容都以“块”（Block）为基本单元（文本、图片、待办事项等）。这些块不仅可以自由组合，还能进行结构化管理，未来支持类似数据库的功能（如“集合”），实现内容的智能组织。

6. 智能化助力：多模态 AI Copilot（规划中/早期）

• 集成了 AI 助手能力，可辅助进行文本生成、幻灯片制作、思维导图构建甚至代码和原型设计，提升创作效率。

7. 可扩展性：插件系统（规划中/早期）

• 计划提供插件系统，允许用户和开发者扩展 AFFiNE 的功能，满足更个性化的需求。

快速上手：安装 AFFiNE 指南

AFFiNE 提供了多种安装方式，以满足不同用户的需求：

方式一：面向所有用户（推荐）- 下载官方桌面应用

这是最简单、最推荐的方式，尤其适合非程序员的普通用户。

1. 访问官网下载页面： 打开你的浏览器，访问 AFFiNE 官方网站 (https://affine.pro/)。通常在首页或专门的“Download”区域可以找到下载链接。
2. 选择对应系统版本： 根据你的操作系统（Windows, macOS, Linux），下载对应的安装包（通常是 .exe, .dmg 或 .AppImage/.deb 文件）。
3. 安装应用：
- • Windows: 双击 .exe 文件，按照安装向导提示完成安装。
- • macOS: 双击 .dmg 文件，将 AFFiNE 图标拖拽到“应用程序”文件夹中。
- • Linux: 根据下载的文件类型进行安装（例如，AppImage 可能需要赋予执行权限后直接运行，.deb 文件可通过包管理器安装）。
4. 启动使用： 安装完成后，在你的应用程序列表或桌面上找到 AFFiNE 图标，双击启动即可开始使用。

方式二：面向技术爱好者/开发者 - 使用 Docker 快速体验/部署

如果你熟悉 Docker，这是一种快速在本地运行 AFFiNE 服务的方式。

1. 确保 Docker 已安装： 在你的系统中安装并运行 Docker Desktop 或 Docker Engine。
2. 拉取 AFFiNE 镜像： 打开终端（Terminal）或命令提示符（Command Prompt），运行以下命令：
```
docker pull ghcr.io/toeverything/affine-self-hosted:pre-alpha
```
(注意：:pre-alpha 表示这是预发布版本，可能存在不稳定因素。请关注官方文档获取最新稳定版镜像信息)
3. 运行容器： 继续在终端中运行以下命令，启动 AFFiNE 容器：
```
docker run -d -p 3000:3000 --name affine ghcr.io/toeverything/affine-self-hosted:pre-alpha
```
- • -d 表示在后台运行。
- • -p 3000:3000 将容器的 3000 端口映射到你本地的 3000 端口。
- • --name affine 为容器命名为 "affine"。
4. 访问 AFFiNE： 打开浏览器，访问 http://localhost:3000，即可开始使用 Docker 部署的 AFFiNE。

方式三：面向开发者 - 从源代码构建和运行

如果你是开发者，希望深入了解代码或进行定制开发，可以选择从源码启动。

1. 准备环境：
- • 安装 Git。
- • 安装 Node.js (推荐使用 LTS 版本)。
- • 安装 pnpm (一个快速、节省磁盘空间的包管理工具): npm install -g pnpm。

2. 克隆代码库： 打开终端，运行：

git clone https://github.com/toeverything/AFFiNE.git

3. 进入项目目录：
```
cd AFFiNE
```
4. 安装依赖：
```
pnpm install
```
5. 启动开发服务器：
```
pnpm start
```
6. 访问 AFFiNE： 启动成功后，终端会显示访问地址，通常是 http://localhost:8080 (注意：端口可能与 Docker 方式不同，请留意终端输出)。在浏览器中打开该地址即可。

进阶选项（可选）

• 公网访问： 对于 Docker 或源码部署的本地服务，若需团队异地访问，可使用内网穿透工具（如 frp, ngrok）将其映射到公网。
• 私有化部署： 对于有更高数据安全和定制需求的企业或团队，AFFiNE 支持基于 PostgreSQL 和 Redis 的更复杂的私有化部署方案，可参考官方文档或社区指南。

初次使用：AFFiNE 基础操作入门

启动 AFFiNE 后，你可以开始探索：

1. 创建工作空间/页面： 通常会有一个引导或明显的“+”按钮来创建你的第一个工作空间（Workspace）或页面（Page）。
2. 切换视图模式： 留意界面上切换“Paper”（文档）模式和“Edgeless”（白板）模式的按钮，尝试在两种模式下创建内容。
3. 使用块编辑器： 在 Paper 模式下，尝试输入 / 命令唤起块菜单，插入不同类型的内容（标题、列表、图片、代码块等）。熟悉 Markdown 快捷键会更高效。
4. 探索白板功能： 在 Edgeless 模式下，尝试添加文本卡片、绘制图形、使用连接线组织想法。
5. 内容组织： 使用侧边栏创建文件夹、收藏页面，保持知识库的整洁有序。
6. 导入导出： 查找导入（支持 Markdown, HTML, Notion 等）和导出（支持 Markdown, HTML 等）功能，方便内容迁移。
7. （可选）云同步与协作： 如果你需要跨设备同步或与他人协作，可以注册并登录 AFFiNE 账户（如有提供），开启云同步功能。邀请成员加入工作空间进行实时编辑。