自建 Outline 清单:Postgres、Redis、S3 与 OIDC

更新时间:2026-11-22 19:11:07

访问次数:8

详细介绍
结论:Outline 的 BSL 1.1 不是开源许可:内部自用 0 美元没问题,对外卖文档服务不行。Community 0 元;Business 年付 480 美元起(10 人起);Enterprise 一年 6,000 美元起(100 人起)。

一、先看授权,再看功能

Outline 的 LICENSE 是 Business Source License 1.1,授权方 General Outline, Inc.,覆盖版本 1.13.0。关键条款有两条:Additional Use Grant 允许你使用,但不得用于 Document Service——也就是不能让第三方(非你的员工和承包商)创建团队和文档、并以此提供商业服务;Change Date 是 2030-11-15,到期后转为 Apache License 2.0。

所以自建之前先问一句:这套 wiki 是给自己人用,还是要卖给客户?自己用,Community 版 0 美元合规;要对外提供文档托管,得单独谈商业授权。

自建档价格限制
Community0 美元功能受限、无官方支持
Business4 美元/用户/月(年付),10 人起一年 480 美元起
Enterprise5 美元/用户/月(年付),100 人起一年 6,000 美元起

自建 Outline 清单:Postgres、Redis、S3 与 OIDC

图:Outline 的 GitHub 仓库:41.3k star、v1.13.0,About 区可点进 License 查看 BSL 1.1 全文

二、四个依赖,一个都不能少

看官方 .env.sample 就知道它要什么:Postgres(DATABASE_URL)、Redis(REDIS_URL)、S3 兼容存储(AWS_S3_UPLOAD_BUCKET_URL 等一组变量),再加两个密钥 SECRET_KEY 和 UTILS_SECRET。缺一个都起不来,或者起来后附件、会话出问题。

  • PostgreSQL:主库,备份靠 pg_dump;
  • Redis:会话和缓存,给 256MB 上限就够小团队;
  • S3 兼容存储:MinIO 或云对象存储,别用容器本地盘;
  • SECRET_KEY / UTILS_SECRET:用随机长字符串,换了会导致登录态失效。

三、上线顺序

  • 用 compose 起 Postgres、Redis、MinIO 三个基础服务,先确认互通;
  • 填 DATABASE_URL、REDIS_URL、S3 四件套和两个密钥,启动 outline 容器;
  • 配 OIDC:把 OIDC_CLIENT_ID、SECRET、AUTH_URI、TOKEN_URI、USERINFO_URI 对上现有账号体系;
  • 反向代理加 TLS,强制 https,关掉不必要的公网端口;
  • 配 SMTP,否则邀请和通知发不出去;
  • 最后做一次恢复演练:删库、从 pg_dump 和附件桶恢复,计时。

四、搜索和备份

Outline 的搜索主要靠 Postgres,文档量大以后要给数据库足够内存;备份是两件事:数据库和附件桶,缺一不可。我的节奏是每天 pg_dump、每小时增量同步附件,保留 7 天;每季度做一次完整恢复演练,记录耗时。

五、我的判断

10 人内部知识库,Community 够用,成本就是一台 2 核 4GB 机器加对象存储;公司要求强制 SSO、审计日志,就买 Business;想拿它对外做 wiki 托管,先解决 BSL 授权,否则不如选 AGPL 的 Docmost 或 Wiki.js。

网友评论