dullage/flatnotes

这是什么？

核心功能

• 01笔记以普通 Markdown 文件保存在同一个扁平文件夹中，无需数据库。
• 02任何页面按 "/" 键即可全文搜索。
• 03提供原始 Markdown 和所见即所得两种编辑模式。
• 04支持笔记标签和双向链接。
• 05界面适配移动端，并提供明暗主题。
• 06认证方式可选：无认证、只读、用户名密码或双因素认证。
• 07提供 RESTful API。

适用场景

• 在自己的服务器上搭建个人 Markdown 知识库。
• 在 flatnotes 中编辑笔记，同时用其他工具直接修改同一批文件。
• 在私有网络中以只读方式向他人分享笔记。
• 日后迁移时无需导出，因为笔记本身就是普通文件。

快速上手

1. 1

   使用 Docker 以密码认证方式运行容器

   docker run -d \ -e "PUID=1000" \ -e "PGID=1000" \ -e "FLATNOTES_AUTH_TYPE=password" \ -e "FLATNOTES_USERNAME=user" \ -e 'FLATNOTES_PASSWORD=changeMe!' \ -e "FLATNOTES_SECRET_KEY=aLongRandomSeriesOfCharacters" \ -v "$(pwd)/data:/data" \ -p "8080:8080" \ dullage/flatnotes:latest
2. 2

   在浏览器中打开 http://localhost:8080 并登录

使用前须知

• !推荐使用 Docker 自托管，因此需要先安装并配置 Docker。
• !演示站每 15 分钟重置一次，仅适合试用。

收录于专题

标签

常见问题

flatnotes 是什么？

一款自托管、无需数据库的笔记网页应用，笔记以扁平文件夹中的 Markdown 文件保存。 flatnotes 是一款可自托管的网页笔记应用。每条笔记都是一个普通的 Markdown 文件，全部放在同一个扁平文件夹中，没有数据库，也没有多层目录，文件随时可以移到其他应用中继续使用。

flatnotes 可以免费使用吗？用的什么许可证？

flatnotes 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

flatnotes 还在维护吗？

半年内有更新。flatnotes 最近一次提交是在 2026年8月29日。

flatnotes 适合用来做什么？

在自己的服务器上搭建个人 Markdown 知识库。 在 flatnotes 中编辑笔记，同时用其他工具直接修改同一批文件。 在私有网络中以只读方式向他人分享笔记。 日后迁移时无需导出，因为笔记本身就是普通文件。

flatnotes 怎么安装和运行？

使用 Docker 以密码认证方式运行容器: docker run -d \ -e "PUID=1000" \ -e "PGID=1000" \ -e "FLATNOTES_AUTH_TYPE=password" \ -e "FLATNOTES_USERNAME=user" \ -e 'FLATNOTES_PASSWORD=changeMe!' \ -e "FLATNOTES_SECRET_KEY=aLongRandomSeriesOfCharacters" \ -v "$(pwd)/data:/data" \ -p "8080:8080" \ dullage/flatnotes:latest 在浏览器中打开 http://localhost:8080 并登录

在哪里获取 flatnotes？

源代码和安装说明在 GitHub 上：https://github.com/dullage/flatnotes