dumbwareio/dumbpad Docker Image Overview

dumbwareio/dumbpad

一个极其简单的记事本应用，支持自动保存、暗黑模式、Markdown格式化和可选PIN保护，采用文件存储确保数据持久化，适合快速记录和管理个人笔记。

3 收藏0 次下载

📦 一套镜像服务，解决研发 / 测试 / 生产三套环境

中文简介版本下载

📦 一套镜像服务，解决研发 / 测试 / 生产三套环境

DumbPad

一个极其简单、无需认证（除非需要！）的现代记事本应用，具备自动保存功能和暗黑模式支持。

!图片

核心功能

简洁清晰的界面
自动保存功能
暗黑模式支持
响应式设计（适配移动端）
Docker 支持
可选 PIN 保护（4-10位数字）
文件存储模式
跨更新数据持久化
Markdown 格式化
模糊搜索（按文件名和内容）
PWA 支持（渐进式Web应用）

快速开始

前提条件

Docker（推荐）
Node.js >=20.0.0（本地开发用）

方式一：Docker 快速运行（适合新手）

bash
# 拉取并运行镜像（一行命令）
docker run -p 3000:3000 \
  -v ./data:/app/data \
  dumbwareio/dumbpad:latest

访问 http://localhost:3000
开始输入内容 - 笔记会自动保存
体验极致简单的笔记记录流程

方式二：Docker Compose 自定义部署（适合喜欢定制的用户）

创建 docker-compose.yml 文件：

yaml
services:
  dumbpad:
    image: dumbwareio/dumbpad:latest
    container_name: dumbpad
    restart: unless-stopped
    ports:
      - ${DUMBPAD_PORT:-3000}:3000
    volumes:
      - ${DUMBPAD_DATA_PATH:-./data}:/app/data
    environment:
      # 网页界面显示的标题
      SITE_TITLE: ${DUMBPAD_SITE_TITLE:-DumbPad}
      # 可选 PIN 保护（留空则禁用）
      DUMBPAD_PIN: ${DUMBPAD_PIN:-}
      # 应用的基础 URL
      BASE_URL: ${DUMBPAD_BASE_URL:-http://localhost:3000} # 使用下方的 ALLOWED_ORIGINS 限制跨域请求来源
      # （可选配置）
      # 用法：逗号分隔的 URL 列表，例如：http://localhost:端口,http://内网IP:端口,https://代理域名,https://认证域名
      # ALLOWED_ORIGINS: ${DUMBPAD_ALLOWED_ORIGINS:-http://localhost:3000} # 取消注释以限制跨域来源（默认允许所有来源*）
      # LOCKOUT_TIME: ${DUMBPAD_LOCK_TIME:-15} # 自定义 PIN 锁定时间（留空默认15分钟）
      # MAX_ATTEMPTS: ${DUMBPAD_MAX_ATTEMPTS:-5} # 自定义 PIN 最大尝试次数（留空默认5次）
      # COOKIE_MAX_AGE: ${DUMBPAD_COOKIE_MAX_AGE:-24} # 自定义认证 Cookie 最大有效期（默认24小时）
      # PAGE_HISTORY_COOKIE_AGE: ${DUMBPAD_PAGE_HISTORY_COOKIE_AGE:-365} # 自定义上次打开记事本的 Cookie 有效期（默认365天，最大400天）- 过期后加载默认记事本

然后运行：

bash
docker compose up -d

访问 http://localhost:3000
开始输入内容 - 笔记会自动保存
享受简单笔记管理的便捷

方式三：本地运行（适合开发者）

安装依赖：

bash
npm install

在 .env 文件中设置环境变量（或复制 .env.example 为 .env）：

bash
PORT=3000                  # 服务器运行端口
DUMBPAD_PIN=1234          # 可选 PIN 保护
SITE_TITLE=DumbPad        # 自定义网站标题
BASE_URL=http://localhost:3000  # 应用基础 URL

启动服务器：

bash
npm start

Windows 用户注意

若使用 Windows PowerShell 运行 Docker，路径格式需调整为：

powershell
docker run -p 3000:3000 -v "${PWD}\data:/app/data" dumbwareio/dumbpad:latest

配置说明

环境变量

变量名	描述	默认值	是否必填
PORT	服务器运行端口	3000	否
BASE_URL	应用基础 URL	http://localhost:PORT	是
DUMBPAD_PIN	PIN 保护（4-10位数字，留空禁用）	无	否
SITE_TITLE	网页标题（显示在顶部）	DumbPad	否
NODE_ENV	运行环境（development 或 production）	production	否
ALLOWED_ORIGINS	允许的跨域来源（`*` 表示所有，或逗号分隔的 URL 列表）	*	否
LOCKOUT_TIME	PIN 尝试失败后的锁定时间（分钟）	15	否
MAX_ATTEMPTS	PIN 最大尝试次数（超过后锁定）	5	否
COOKIE_MAX_AGE	认证 Cookie 最大有效期（小时）	24	否
PAGE_HISTORY_COOKIE_AGE	上次打开记事本的 Cookie 有效期（天，最大400）	365	否