轻量化笔记推荐：Docker安装部署FlatNotes

FlatNotes是什么？

FlatNotes 是一款开源免费的自托管 Web 笔记应用，以 “无数据库、轻量高效” 为核心优势，所有笔记均以 Markdown 文件形式存储在文件夹中，无需复杂数据库配置，支持原生编辑与所见即所得两种模式，搭配标签分类、全文搜索和 Wiki 链接功能，让知识管理更直观。它具备密码验证、双因素认证等多重安全保障，自托管特性让你完全掌控数据隐私，同时支持跨设备同步和离线访问，移动响应式界面适配各类终端，无论是个人整理学习心得、学术创作，还是小型团队共享项目文档，都能提供简洁无干扰的使用体验，且可通过 Docker 快速部署，维护成本极低。

功能特点：

1. 移动响应式的Web界面，适应不同设备

2. 提供原始模式和所见即所得（WYSIWYG）两种Markdown编辑器选择

3. 高级搜索功能，满足复杂查询需求

4. 笔记标签功能，轻松分类和管理内容

5. 支持Wikilink，便捷链接到其他笔记

6. 浅色和深色两种主题可选，满足个人偏好

FlatNotes安装部署

1、创建本地文件目录映射

 mkdir -p /opt/flatnotes/data
 chmod -R 777 /data/flatnotes/

2、使用Docker命令安装

 docker run -d \
   -e "PUID=1000" \
   -e "PGID=1000" \
   -e "FLATNOTES_AUTH_TYPE=password" \
   -e "FLATNOTES_USERNAME=admin" \
   -e "FLATNOTES_PASSWORD=admin" \
   -e "FLATNOTES_SECRET_KEY=aLongRandomSeriesOfCharacters" \
   -v "/opt/flatnotes/data:/data" \
   -p "8080:8080" \
   dullage/flatnotes:latest

参数解释：

   FLATNOTES_AUTH_TYPE:
     说明: 认证类型
     可选值:
       - none: 无认证
       - read_only: 无认证，但禁止创建、修改、删除注释
       - password: 需用户名和密码
       - totp: 需用户名、密码和 TOTP 一次性密码
 ​
   FLATNOTES_USERNAME:
     说明: 登录用户名
     适用条件: 当 FLATNOTES_AUTH_TYPE 为 password 或 totp 时必须设置
 ​
   FLATNOTES_PASSWORD:
     说明: 登录密码
     适用条件: 当 FLATNOTES_AUTH_TYPE 为 password 或 totp 时必须设置
 ​
   FLATNOTES_TOTP_KEY:
     说明: TOTP 密钥，用于生成一次性密码，修改后原有 TOTP 失效
     适用条件: 仅当 FLATNOTES_AUTH_TYPE 为 totp 时必须设置
     建议: 使用密码生成器生成 32 位随机字符串
 ​
   FLATNOTES_SECRET_KEY:
     说明: 生成访问令牌的密钥，修改后所有现有令牌失效
     适用条件: 当 FLATNOTES_AUTH_TYPE 为 password 或 totp 时必须设置
     不适用: FLATNOTES_AUTH_TYPE 为 none 或 read_only 时
     建议: 使用密码生成器生成 32 位随机字符串
 ​
   PUID:
     说明: Docker 容器内运行用户的 ID
     默认值: 1000
     用途: 避免挂载主机目录时出现权限问题
 ​
   PGID:
     说明: Docker 容器内运行用户组的 ID
     默认值: 1000
     用途: 避免挂载主机目录时出现权限问题
     
   -v:
      本地存储路径映射：容器
      
   -p：
     主机/容器端口映射

3、Docker Compose.yml文件

 version: "3"
 services:
   flatnotes:
     container_name: flatnotes
     image: dullage/flatnotes:latest
     environment:
       PUID: 1000
       PGID: 1000
       FLATNOTES_AUTH_TYPE: "password"
       FLATNOTES_USERNAME: "admin"
       FLATNOTES_PASSWORD: "admin"
       FLATNOTES_SECRET_KEY: "aLongRandomSeriesOfCharacters"
     volumes:
       - "./data:/data"
       # Optional. Allows you to save the search index in a different location: 
       # - "./index:/data/.flatnotes"
     ports:
       - "8080:8080"
     restart: unless-stopped

使用docker compose快速部署flatnotes

 docker compose up -d

FlatNotes使用教程

1、登录页面

访问地址：http://192.168.3.166:8080

将IP地址替换为自己服务器的IP地址

输入刚才设置好的用户名以及密码（比如admin/admin），就可以看到登陆后界面。界面很干净，虽然没有中文，但并不影响我们使用。

2、新建文章

点击新建按钮，使用的Markdown编辑器，提供了所见即所得的切换按钮

3、使用标签

编辑器使用#标签，打标签分类