ByteNoteByteNote

字节笔记本

2026年8月29日

法国和德国一起做的开源 Notion 平替 Docs

API中转
¥120

想自己托管一套团队文档、又不想把笔记交给 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。

bash
git clone https://github.com/suitenumerique/docs.git
cd docs
make bootstrap FLUSH_ARGS='--no-input'
make run

浏览器打开 http://localhost:3000。开发默认账号:

text
username: impress
password: impress

make bootstrap 会建 app-dev / frontend-dev 容器、装依赖、跑迁移、编译翻译。拉完新代码建议再跑一遍。对象存储在开发里用 MinIO,换成别的 S3 兼容服务也可以。

常用命令:

bash
make help
make demo          # 造一份演示站点
make superuser     # 建 Django 超管
make run-backend   # 只起后端

超管后台在本地的 /admin。前端想在容器外热更新时:

bash
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/ 里的密钥之后:

bash
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.mdCHANGELOG.md,再 docker compose pull、重启、跑迁移。

YunoHost 用户可以从 应用商店 装。装之前要先有 Dex(把 LDAP 接到 OIDC)和一套 S3(MinIO 或 Garage),内存预算大约 3 GB。

可选的 AI

AI 默认关。打开之后可以总结、改写、纠错、翻译,V2 还能用 BlockNote 那套工具栏和「AI 光标」(当前 beta)。模型随便接,配置只要 API 地址和 Key。

env
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 硬顶)。

相关链接

分享: