NAS 部署 LeafWiki 轻量 Wiki，再也不用担心格式兼容问题

LeafWiki：

一款轻量化自托管 Wiki 工具，页面以原生 Markdown 文件存储，自带树形文档、全文检索与完善 Markdown 编辑器，适合个人与小型团队自建知识库。

核心特点：

• 单 Go 二进制文件运行，无需 Node.js、Redis、Postgres 等外部依赖

• Markdown 存储在磁盘上，可直接阅读、备份

• SQLite 作为内置数据库

• 树状导航结构，不是 Obsidian 那种扁平笔记流

• 显式排序，页面顺序由你手动控制

• 全文搜索 + 标签过滤

• 内置编辑器：支持表格、任务列表、脚注、Mermaid、KaTeX 等

• 反向链接、断链检测

• 三种访问模式：内部、公开阅读、完全开放编辑

在线 Demo：

https://demo.leafwiki.com/home

安装

Docker Compose

services: leafwiki: image: ghcr.io/perber/leafwiki:latest container_name: leafwiki ports: - 8080:8080 environment: - LEAFWIKI_JWT_SECRET=SVzqGuuEum1O2X56wgKKSA0krcNoiQA2TJ - LEAFWIKI_ADMIN_PASSWORD=123456 - LEAFWIKI_ALLOW_INSECURE=true volumes: - ./data:/app/data restart: always

参数说明（更多参数建议去看文档）

LEAFWIKI_JWT_SECRET（环境变量）：用于会话加密签名，自行生成 32 位以上随机字符

LEAFWIKI_ADMIN_PASSWORD（环境变量）：初始管理员密码，自行修改

LEAFWIKI_ALLOW_INSECURE（环境变量）：HTTP 访问需要设置

/app/data（路径）：存储数据

使用

浏览器中输入 http://NAS的IP:8080 就能看到界面

输入用户名和密码进行登录（默认用户名为：admin，密码则是上面配置的）

界面样式比较简洁，不过目前应用还没有中文（但问题不大，功能都挺简单）

支持切换深色主题，晚上也不会刺眼了

目前是预览状态，点击可以进行编辑

支持 Markdown 语法，右侧可以实时查看效果

点击最左边，可以创建文档或者文件夹

输入标题，选择创建并编辑

复制了一篇之前的 Markdown 格式的文章，效果还是不错的

TIP：目前不支持显示外链图片，只能通过本地复制粘贴上传图片。如果你的导入或者复制的 Markdown 文档中包含大量外链图片，需要注意这一点。

说一下 LeafWiki 最无敌的一点，那就直接保存为 md 文件，后期导入导出都不需要担心格式兼容转换问题

非常干净的文件内容，这点是最吸引人的——理论上可以从 Obsidian 无缝迁移，毕竟都是原生 Markdown 文件，直接放入 data 目录即可识别，不过需要注意图片存放位置

回到页面，点击右上角头像，跳转到用户管理功能

支持手动创建用户账号，以及简单的权限管理

跳转到品牌设置

支持设置网站名称和 Logo 图标

总结

LeafWiki 是一款轻量自托管 Wiki 工具，最大的卖点是 Markdown 文件直接存磁盘——不锁格式、不怕工具停服、备份就是复制文件夹，这对被笔记工具绑架过的人来说太重要了。树形导航+全文检索+标签过滤，日常写文档够用；反向链接和断链检测也是加分项。

不过目前不支持外链图片显示，没有中文界面，功能上相比成熟 Wiki（如 Outline、BookStack）还偏简单，适合追求轻量和数据自主的个人用户。

综合推荐：⭐⭐⭐⭐（轻量 Wiki ，数据保存干净）

使用体验：⭐⭐⭐⭐（界面简约，功能实用）

部署难易：⭐⭐（简单）︎

作者声明本文无利益相关，欢迎值友理性交流，和谐讨论～