dullage/flatnotes

flatnotes 镜像文档

镜像概述和主要用途

flatnotes 是一款自托管、无数据库依赖的笔记管理Web应用。它采用扁平文件夹结构存储Markdown格式文件，无需复杂的数据库配置，即可实现笔记的创建、编辑和管理。所有数据以纯文本形式存储在本地文件系统中，确保数据透明可访问，适合注重数据隐私和简化维护的用户。

核心功能和特性

• 无数据库设计：摆脱传统数据库依赖，降低系统复杂度和资源占用，减少维护成本
• Markdown原生支持：笔记以标准Markdown格式存储，兼容主流编辑器，数据可直接读写
• 扁平文件结构：所有笔记集中存储于单一文件夹，文件组织清晰，支持直接通过文件系统管理
• 自托管特性：支持本地部署，数据完全由用户掌控，保障隐私安全
• 轻量易用：部署简单，界面直观，适合个人日常笔记管理场景

使用场景和适用范围

• 个人日常笔记管理，尤其适合习惯Markdown格式的用户
• 需要本地存储数据、避免第三方服务的隐私敏感场景
• 偏好轻量级应用、希望减少系统依赖的自托管服务需求者
• 需跨设备同步（可通过文件同步工具配合使用）的笔记场景

标签信息

演示与官方资源

可访问 演示站点 体验功能（注：该站点每15分钟重置一次）。更多详细文档和更新信息请参见 官方网站。

部署与使用方法

基础 Docker 部署

通过以下命令快速启动容器，需挂载本地目录作为笔记存储路径：

bash
docker run -d \
  --name flatnotes \
  -p 8080:8080 \
  -v /本地/笔记/目录:/app/data \
  dullage/flatnotes:latest

参数说明：

• -p 8080:8080：将容器8080端口映射到主机，可根据需求修改主机端口（如 -p 80:8080）
• -v /本地/笔记/目录:/app/data：挂载本地目录至容器内数据存储路径，确保笔记文件持久化保存
• dullage/flatnotes:latest：使用最新版本镜像，也可指定具体版本标签（如 v5.5）

Docker Compose 配置

创建 docker-compose.yml 文件，实现更便捷的管理：

yaml
version: '3'
services:
  flatnotes:
    image: dullage/flatnotes:latest
    container_name: flatnotes
    ports:
      - "8080:8080"  # 主机端口:容器端口
    volumes:
      - /本地/笔记/目录:/app/data  # 替换为实际本地目录
    restart: unless-stopped  # 容器退出时自动重启（除非手动停止）

启动服务：

bash
docker-compose up -d

访问应用

部署完成后，通过浏览器访问 http://主机IP:8080 即可使用 flatnotes 管理笔记。所有笔记将保存在本地挂载的目录中，可直接通过文件系统查看或编辑。