前言
在团队知识管理和协作办公场景中，Notion 与 Miro 是非常受欢迎的工具。但它们普遍存在收费高、数据依赖云端、隐私不可控等问题。
为了解决这些痛点，开源项目 AFFiNE 应运而生。它将笔记文档与白板协作融合在一起，并支持自托管与本地优先存储，成为 Notion + Miro 的开源替代方案。
1. 项目
AFFiNE 是一款新一代 开源的笔记 + 白板 + 协作工具，由 toeverything 团队开发。它融合了文档编辑、白板协作、任务管理等功能，支持个人与团队搭建自己的私有化知识管理平台。
1.1 项目特点
- 开源自托管：基于 MIT 协议，用户可自由部署，掌控数据。
- 多视图融合：同时支持文档模式、白板模式、看板模式，兼具 Notion + Miro 的优势。
- 实时协作：支持多人在线协作，采用 CRDT 技术保证编辑冲突可控。
- 本地优先存储：数据默认存放在本地，可选云同步，隐私安全。
- 可扩展性强：基于 Block 架构，未来可通过插件扩展功能。
1.2项目展示
2.相关地址
gitHub开源项目：https://github.com/toeverything/AFFiNE
3.搭建环境
- 服务器：这里为了方便搭建项目使用的是莱卡云的境外香港云服务器。(国内用户连接建议使用国内的服务器(需备案域名或者IP+端口)延迟会更低)
- 莱卡云服务器促销活动性价比会更高。查看官网购买链接：https://www.lcayun.com
- 资源配置：2核2G 30G硬盘
由于国内服务器访问海外源较慢，这边为了方便演示直接使用海外服务器搭建。 - 服务器系统：Debian-12
- 【必需】安装Docker：安装好 Docker、Docker-compose
- 【非必需】域名一枚，可用于解析到服务器上使用域名访问
4.搭建视频
哔哩哔哩：
5.搭建方式
5.1 安装docker和docker-compose
安装教程：服务器上安装docker和docker-compose教程
5.2 创建docker文件
#在opt目录下创建AFFiNE文件夹
mkdir /opt/AFFiNE#打开AFFiNE文件
cd /opt/AFFiNE所有后续文件、数据卷都放在这个目录里。
5.3 获取 Docker Compose 文件
#定义了 AFFiNE 容器、端口映射和卷挂载
wget -O docker-compose.yml https://github.com/toeverything/affine/releases/latest/download/docker-compose.yml5.4 获取.env文件
.env文件用来配置数据存储路径和数据库信息。
#自动下载示例 .env 文件
wget -O .env https://github.com/toeverything/affine/releases/latest/download/default.env.example#打开 .env 文件，修改路径和数据库信息
vi .env# 数据库文件
DB_DATA_LOCATION=./postgres
# 上传文件
UPLOAD_LOCATION=./storage
# 配置文件
CONFIG_LOCATION=./config
# 数据库信息
DB_USERNAME=affine
DB_PASSWORD=你的密码 #自行配置修改
DB_DATABASE=affine
5.5 创建对应目录
mkdir -p ./postgres ./storage ./configmkdir -p：表示不存在就创建
./postgres：存放数据库文件
./storage：存放上传文件
./config：存放 AFFiNE 配置
这样 .env 配置和数据目录就准备好了，可以接下来启动 Docker 容器。
5.6 运行AFFiNE的docker镜像
# 启动docker
docker compose up -d
# 重启docker
docker compose stop
docker compose start
# 升级docker
docker compose down
docker compose pull
docker compose up -d5.7 访问AFFiNE
几分钟后，您应该可以通过本地主机端口 3010 访问该网站。使用以下默认登录凭据访问该网站。
http://IP:3010
然后自行创建用户
设置中文
更多使用跟介绍可以看看官方文档：https://docs.affine.pro/self-host-affine/administer/indexer
6.结尾
你已经成功使用 Docker 在服务器上部署了 AFFiNE，自建了属于自己的私有知识库。无论是团队协作、项目管理，还是个人笔记整理，AFFiNE 都能让你的工作更高效、更有条理。
