当前位置：首页 > news >正文

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

news 2025/11/13 6:53:56

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

FlatNotes是什么？

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

功能特点：

移动响应式的Web界面，适应不同设备
提供原始模式和所见即所得（WYSIWYG）两种Markdown编辑器选择
高级搜索功能，满足复杂查询需求
笔记标签功能，轻松分类和管理内容
支持Wikilink，便捷链接到其他笔记
浅色和深色两种主题可选，满足个人偏好

FlatNotes安装部署

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

 mkdir -p /opt/flatnotes/datachmod -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: flatnotesimage: dullage/flatnotes:latestenvironment:PUID: 1000PGID: 1000FLATNOTES_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