Wiki.js 免费知识库:1 核 1GB 内存起,Markdown 为主

AGPL 的 Node wiki,1 核 1GB 内存起

更新时间:2026-11-22 19:10:54

访问次数:6

详细介绍
一句话结论:Wiki.js 是 Node 栈里最省资源的自建 wiki:官方写明 1 核、1GB 内存、1GB 盘就够,进程平时只占约 70MB;代价是升级 3.x 之前最好把数据库统一到 PostgreSQL。

这是什么

Wiki.js 是 Node.js 写的开源 wiki,GitHub 29.4k star,授权 AGPL-3.0。官网现在挂着「Wiki.js 3.x 已可用」,同时 2.x 仍在维护。

官方要求写得很具体:CPU 1 核能跑、建议 2 核给后台任务;Linux 至少 1GB 内存,进程本身约 70MB,渲染和索引时会短时冲高;磁盘建议至少 1GB 专供程序,内容另算;必须给独立域名或子域名,不能挂在子目录下。Node.js 支持 22 和 24(2.5.302 起),数据库首选 PostgreSQL 9.5+,要用它自带的搜索模块还得装 pg_trgm 扩展。

它也支持 MySQL 8.0、MariaDB 10.2.7、SQL Server 2012、SQLite 3.9,但官方明确写了:这些数据库在下一个大版本不再支持,SQLite 也不建议用于生产。编辑器除了 Markdown(VS Code 同源),还有 Visual、AsciiDoc、Excalidraw,另有博客和反馈板块。

我怎么用它

我把 Wiki.js 当成「技术团队的文档站」,部署顺序固定:

  • Docker 起一个容器,数据库单独用 PostgreSQL,不把 SQLite 带上生产;
  • 先装 pg_trgm,再在后台开 PostgreSQL 搜索,否则中文搜索体验很差;
  • 按路径建页面,比如 /ops/mysql/upgrade,不手工建文件夹,面包屑会自动生成;
  • 把编辑权限收到组,默认只读,避免谁都能改首页;
  • 升级前先备份数据库和上传目录,3.x 迁移前把非 Postgres 数据库转过来。

我的判断是:内容以 Markdown 为主、写的人有技术背景,Wiki.js 最舒服;如果写的人不碰 Markdown,它的 Visual 编辑器也能用,但体验不如 Docmost 那种块编辑器。

上手截图

Wiki.js 免费知识库:1 核 1GB 内存起,Markdown 为主

图:Wiki.js 官方安装要求页:1 核可跑、建议 2 核,Linux 至少 1GB 内存,进程约 70MB

优点

  • 资源占用低,1 核 1GB 的机器就能跑起来;
  • Markdown 编辑体验接近 VS Code,支持 180+ 语言高亮;
  • 数据库选择多,迁移和备份路径清楚;
  • AGPL 授权,自建自用没有成本,Docker 部署一条命令起步。

缺点

  • 没有实时协作,多人同时编辑同一页会冲突;
  • 中文搜索依赖 pg_trgm,配置不到位就等于没有搜索;
  • 官方明确说非 PostgreSQL 数据库在 3.x 不再支持,迁移是迟早的事;
  • 插件和主题生态比 Outline、Docmost 单薄,界面偏工具感。

什么时候别用它

团队里没人愿意维护服务器和数据库、又需要实时协作,就别选 Wiki.js;内容以表格、看板、数据库视图为主,也用不上它。它适合的是有运维能力、以文字文档为主的技术团队。

网友评论