收起左侧

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

0
回复
50
查看
[ 复制链接 ]

191

主题

18

回帖

0

牛值

江湖新锐

社区上线纪念勋章fnOS1.0上线纪念勋章EVO2产品纪念

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 ,数据保存干净)

使用体验:⭐⭐⭐⭐(界面简约,功能实用)

部署难易:⭐⭐(简单)︎

收藏
送赞
分享
不定时分享 NAS 教程
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则