字节笔记本
2026年8月29日
法国和德国一起做的开源 Notion 平替 Docs
想自己托管一套团队文档、又不想把笔记交给 Notion 或 Google Docs 时,可以看 La Suite Docs。这是法国 DINUM 和德国 ZenDiS 一起推的开源协作编辑器:实时写、子文档分层、数据落在你自己的服务器上。仓库 MIT,GitHub 上大约 1.6 万星,已被 Digital Public Goods Alliance 列为数字公共品。荷兰也在对接。
官网在 docs.la-suite.eu。不想装的话,直接打开 live demo,或者看社区维护的 公共实例列表。
它实际能干什么
界面是块编辑器,斜杠命令、表格、分栏、折叠区块都能用。多人同时打开一份文档时有光标和在线状态,评论和分享权限可以拆开:只读、可评论、可编辑,也能给外部访客或公开链接。
文档能嵌套成子文档,适合当知识库,不是只能平铺一堆页。保存是自动的,停手大约一分钟会落一版,历史可以回滚。已经打开的文档断网也能继续改,标签页别关,连上之后会同步。
导入支持 .docx 和 Markdown,导出支持 .docx、.odt、.pdf。文档里用 --- 当分隔符还能切成幻灯片:全屏、键盘翻页、从某个块开始演示。
技术栈是 Django + Next.js,编辑器走 BlockNote / ProseMirror,协同是 Yjs 和 HocusPocus。官方赞助了 BlockNote 和 Yjs。
有两件事要先知道。文档目前没有端到端加密,机密或涉密材料别往里塞。PDF 导出等部分能力依赖 BlockNote 的 XL 包,那些包是 GPL,跟 MIT 不兼容。生产镜像如果必须纯 MIT,构建时设 PUBLISH_AS_MIT=true,对应功能会拿掉。环境变量说明见仓库 env.md。
本机先跑起来
开发环境只用来试用和改代码,官方写得很清楚:不要当生产。需要 Docker、Docker Compose、GNU Make。
git clone https://github.com/suitenumerique/docs.git
cd docs
make bootstrap FLUSH_ARGS='--no-input'
make run浏览器打开 http://localhost:3000。开发默认账号:
username: impress
password: impressmake bootstrap 会建 app-dev / frontend-dev 容器、装依赖、跑迁移、编译翻译。拉完新代码建议再跑一遍。对象存储在开发里用 MinIO,换成别的 S3 兼容服务也可以。
常用命令:
make help
make demo # 造一份演示站点
make superuser # 建 Django 超管
make run-backend # 只起后端超管后台在本地的 /admin。前端想在容器外热更新时:
make frontend-development-install
make run-frontend-development生产怎么部署
维护者自己用的是 Kubernetes,能给到的支持也主要在这条路径。Compose 有官方示例,但他们没拿它跑生产。社区还有 Nix、YunoHost、Podman、Coop-Cloud,以及法国 Clever Cloud 的一键部署。入口都在 Installation。
Compose 这条线需要你自己准备:
- 一个域名,证书走 HTTPS
- 支持 OpenID Connect 的身份源(仓库带 Keycloak 示例)
- 兼容 S3 API 的对象存储(带 MinIO 示例)
- PostgreSQL 和 Redis(compose 文件里有示例服务)
配好 env.d/ 里的密钥之后:
docker compose up -d
docker compose run --rm backend python manage.py migrate
docker compose run --rm backend python manage.py createsuperuser --email you@example.com --password '换成强密码'镜像标签建议钉死版本,不要长期挂 latest。升级前先看仓库的 UPGRADE.md 和 CHANGELOG.md,再 docker compose pull、重启、跑迁移。
YunoHost 用户可以从 应用商店 装。装之前要先有 Dex(把 LDAP 接到 OIDC)和一套 S3(MinIO 或 Garage),内存预算大约 3 GB。
可选的 AI
AI 默认关。打开之后可以总结、改写、纠错、翻译,V2 还能用 BlockNote 那套工具栏和「AI 光标」(当前 beta)。模型随便接,配置只要 API 地址和 Key。
AI_FEATURE_ENABLED=true
AI_FEATURE_BLOCKNOTE_ENABLED=true
AI_BASE_URL=https://your-openai-compatible-endpoint
AI_API_KEY=<API key>
AI_MODEL=llama官方演示站走的是 Mistral,经法国 Albert API,放在 SecNumCloud 上。这只是一种配法,自托管时换成你自己的网关即可。质量观察可以用开源的 Langfuse。
Docs 还暴露了 resource server API 和 server-to-server API。同一套 La Suite 里的 Meet 可以把会议转写推到 Docs,给发起人一份纪要。
什么时候值得上
适合:团队文档必须落在自己机器上;已经有 OIDC 和 S3;想要实时协作和子文档,而不是再买一份 Notion。
不太适合:没有身份源、也没有对象存储,只想五分钟装完;材料需要端到端加密;生产环境只能接受维护者承诺支持的方案(那就走 k8s,别拿 Compose 硬顶)。
相关链接
- 官网:docs.la-suite.eu
- 仓库:suitenumerique/docs(MIT)
- 安装说明:documentation/installation
- 公共路线图:Docs roadmap
- Matrix:docs-official