WikiDocs
SHA-256WikiDocs 是一个无需数据库、纯 Markdown 扁平文件的知识库 Wiki,既能作为独立桌面应用运行,也能用 Docker 自托管。内容以可移植的 MD 文件保存,不含数据库或云锁定,注重隐私和自主可控。
用纯 Markdown 文件就能自己搭建的 Wiki 知识库,支持桌面和服务器。
核心功能
- 无需数据库,内容存成纯 Markdown 文件,可移植性强
- 所见即所得(WYSIWYG)编辑器,支持 KaTeX 数学公式和 Mermaid 图表
- 支持桌面应用与自托管服务器之间的远程同步
- 提供 REST API,方便与外部工具和自动化流程集成
- 支持页面版本历史、附件上传、命名空间分类、公开/私密浏览、深色模式和多语言
避坑指南
- •桌面端与自托管实例之间的同步需要先配置远端地址并输入凭据,而不是自动发现。迁移版本 1.x(旧版)数据后,需把首页文档手动移到根目录(新版不再使用旧首页 slug)。Docker 版默认只提供 HTTP,如需 HTTPS 需要额外反向代理。自托管时注意保管 SECRET 环境变量,确保强度足够。
适用场景
- 个人知识库或笔记系统:在桌面端本地写作,数据保留在自己的 Markdown 文件中
- 团队/项目内部 Wiki:通过 Docker 自托管,支持成员共同编辑浏览,也可设置公开或私密访问
WikiDocs 是一个注重隐私、无需数据库的 Markdown 扁平文件 Wiki,旨在让用户完全掌控自己的知识库。所有内容以纯 Markdown 文件存储(支持 YAML frontmatter),不依赖数据库或云服务厂商。它既可以作为独立桌面应用(Electron)在本地使用,也可以通过 Docker 自托管,实现远程访问和桌面端与服务器之间的同步。核心功能包括:所见即所得(WYSIWYG)的 Markdown 编辑器、KaTeX 数学公式、Mermaid 图表、无限页面历史、附件与图片上传(支持剪贴板)、命名空间分类、公开/私密浏览、代码高亮、多语言界面、深色模式,以及带 Swagger 文档的 REST API,方便与其他工具集成。WikiDocs 2.x 是使用 TypeScript 的完全重写(NestJS 后端 + Angular 前端 + Electron 桌面端),支持桌面与自托管实例间的同步。原 PHP 版在 legacy 分支中继续可用。相比 Notion 或 Confluence,WikiDocs 更轻量、更简单、完全可移植,省去数据库管理之忧,真正告别供应商锁定;比一般静态站点生成器又多了所见即所得编辑和全功能管理界面。
标签
快速上手
安装软件
打开下载的 dmg 文件,将应用拖入 Applications 文件夹
桌面版:从 GitHub Releases 页下载对应系统的安装包(如 Windows .exe),双击安装并启动
Docker 自托管:执行 docker run -p 3210:3210 zavy86/wikidocs:2 启动容器
启动后,浏览器访问 http://localhost:3210,创建管理员账户即开始使用
- 桌面版:从 GitHub Releases 页下载对应系统的安装包(如 Windows .exe),双击安装并启动
- Docker 自托管:执行 docker run -p 3210:3210 zavy86/wikidocs:2 启动容器
- 启动后,浏览器访问 http://localhost:3210,创建管理员账户即开始使用
已提供 SHA-256 校验码,下载后可自行核对文件完整性
该校验码提取自 GitHub 官方 Release 页面
SHA256 校验码
2e33389e786e6e9f56537fab592d3e81622e808c628b50455a024c4467172168该校验码提取自 GitHub Release 页面,下载后请自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件,未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
桌面版:在操作系统自带的应用管理中卸载(Windows 设置 > 应用;macOS 将应用拖入废纸篓)。卸载前请确认已备份重要数据。Docker 版:执行 docker stop 和 docker rm 删除容器;若数据卷未挂载到宿主机,删除容器可能同时删除数据,做迁移前记得备份。
无额外依赖
下载后即可直接使用,无需安装其他运行环境
遇到问题?查看下方 FAQ
5 FAQs