自托管笔记应用Flatnotes极简部署，无数据库Markdown笔记库远程访问方案

项目介绍

Flatnotes 是一款自托管、无数据库的极简笔记应用，采用扁平化的 Markdown 文件存储方案。它提供了一个简洁优雅的网页界面，让你可以轻松管理和搜索所有笔记。无论是个人知识库、日常记录还是工作备忘，Flatnotes 都能胜任。

这个项目的核心理念是'笔记自由'——你的笔记就是普通的 Markdown 文件，没有数据库锁定，没有复杂的文件夹结构，完全开放。你随时可以把文件移到其他地方继续使用，不用担心被应用绑定。同时，Flatnotes 还提供了强大的全文搜索、标签系统、WikiLink 链接、WYSIWYG 编辑器等功能，让笔记管理变得轻松高效。

项目地址：点我跳转

部署安装

如果你想在外网也能访问自己的笔记库，建议配置内网穿透服务。推荐使用 帕斯内网穿透，注册账号后可以轻松实现远程访问。详细的配置步骤可以参考 全平台上手攻略。

Flatnotes 提供了开箱即用的 Docker 部署方案，以下是最快速的上手方式。

使用 Docker 快速启动

打开你的 NAS 设备（飞牛 NAS、群晖或其他支持 Docker 的 NAS）

进入本地镜像管理，点击'添加镜像'，选择'从 URL 添加'

在镜像地址栏填入：dullage/flatnotes:latest

等待镜像下载完成，然后点击启动按钮创建容器

容器配置步骤：

1. 基础设置

勾选'开机自动启动'确保服务持久运行

点击下一步

2. 端口映射

容器内端口：8080（固定不变）

主机端口：8080（如果与其他服务冲突，可改为 8081、8082 等）

注意：只需修改主机端口，容器内端口保持 8080 不变

3. 存储挂载

创建一个文件夹用于存储笔记数据（如 /mnt/data/flatnotes）

容器路径：/data

主机路径：你创建的文件夹路径

这样你的所有笔记都会被持久化保存

4. 环境变量设置

必须设置：

FLATNOTES_AUTH_TYPE: password （启用密码认证）

FLATNOTES_USERNAME: user （登录用户名，建议改成自己的用户名）

FLATNOTES_PASSWORD: changeMe! （登录密码，务必改成强密码）

FLATNOTES_SECRET_KEY: aLongRandomSeriesOfCharacters （加密密钥，建议用随机字符串替换）

可选设置：

PUID: 1000 （容器运行用户ID，通常保持默认）

PGID: 1000 （容器运行组ID，通常保持默认）

其他环境变量保持默认即可，无需修改。

5. 启动应用

确认所有配置无误后，点击启动

验证部署

部署完成后，在浏览器中访问：http://你的NAS地址:8080

使用你设置的用户名和密码登录，即可开始使用 Flatnotes 记录笔记。

部署完成！

现在你拥有了一个完全属于自己的笔记系统。所有笔记都以 Markdown 格式存储在本地，支持随时导出和迁移。配合内网穿透服务，你可以在任何地方安全地访问自己的笔记库。

本篇教程结束