dumbwareio/dumbdrop

DumbDrop

一个极其简单的文件上传应用，提供简洁现代的拖放界面。基于Node.js和原生JavaScript构建。

!https://github.com/user-attachments/assets/1b909d26-9ead-4dc7-85bc-8bfda0d366c1

无认证（除非你现在想要！），无存储限制，什么都没有。只是一个简单的文件上传器，可以将文件拖放到一个简单的文件夹中。

目录

• 快速开始
• 使用Docker进行生产部署
• 本地开发（推荐的快速开始）
• 功能特性
• 配置
• 安全性
• 技术细节
• 演示模式
• 贡献
• 许可证

快速开始

选项1：Docker（傻瓜式）

bash
# 一条命令拉取并运行
docker run -p 3000:3000 -v ./uploads:/app/uploads dumbwareio/dumbdrop:latest

1. 访问 http://localhost:3000
2. 上传文件 - 文件将显示在 ./uploads 目录中
3. 为这个简单至极的应用欢呼吧

选项2：Docker Compose（适合喜欢自定义的傻瓜）

创建 docker-compose.yml 文件：

yaml
services:
    dumbdrop:
        image: dumbwareio/dumbdrop:latest
        ports:
            - 3000:3000
        volumes:
            # 上传的文件将存放在这里
            - ./uploads:/app/uploads
        environment:
            # 显式设置容器内的上传目录
            UPLOAD_DIR: /app/uploads
            # 网页界面中显示的标题
            DUMBDROP_TITLE: DumbDrop
            # 最大文件大小（MB）
            MAX_FILE_SIZE: 1024
            # 可选的PIN码保护（留空则禁用）
            DUMBDROP_PIN: 123456
            # 无需点击按钮自动上传
            AUTO_UPLOAD: false
            # 应用的基础URL
            # 你必须将此更新为访问网站时使用的URL
            BASE_URL: http://localhost:3000

然后运行：

bash
docker compose up -d

1. 访问 http://localhost:3000
2. 上传文件 - 文件将显示在 ./uploads 目录中
3. 为你的简单上传功能感到高兴吧

注意： 环境变量 UPLOAD_DIR 现在显式设置为容器内的 /app/uploads。Dockerfile 只创建 uploads 目录，不创建 local_uploads。主机目录 ./uploads 挂载到 /app/uploads 以实现持久化存储。

选项3：本地运行（适合开发者）

有关本地开发设置、故障排除和高级用法，请参阅专门的指南：

👉 本地开发指南

功能特性

• 🚀 拖放文件上传
• 📁 多文件选择
• 🎨 简洁、响应式UI，支持深色模式
• 📦 Docker支持，配置简单
• 📂 目录上传支持（保持结构）
• 🔒 可选的PIN码保护
• 📱 移动友好界面
• 🔔 通过Apprise配置通知
• ⚡ 客户端零依赖
• 🛡️ 内置安全功能
• 💾 可配置的文件大小限制
• 🎯 文件扩展名过滤

配置

环境变量

• UPLOAD_DIR 用于Docker/生产环境。如果未设置，本地开发将使用LOCAL_UPLOAD_DIR。如果两者都未设置，默认值为 ./local_uploads。
• Docker注意： Dockerfile现在只在容器内创建 uploads 目录。主机的 ./local_uploads 挂载到 /app/uploads，应由主机系统管理。
• BASE_URL：如果你在子路径下部署DumbDrop（例如 https://example.com/watchfolder/），你必须将 BASE_URL 设置为包含尾部斜杠的完整路径（例如 https://example.com/watchfolder/）。所有API和资源请求都将以此值为前缀。如果部署在根目录，使用 https://example.com/。
• BASE_URL 必须以尾部斜杠结束。如果不是这种情况，应用将无法启动。

参见 .env.example 获取模板和更多详细信息。

env
ALLOWED_IFRAME_ORIGINS=https://organizr.example.com,https://myportal.com

env
ALLOWED_EXTENSIONS=.jpg,.jpeg,.png,.pdf,.doc,.docx,.txt

env
APPRISE_MESSAGE: 新文件上传 {filename} ({size}), 已使用存储 {storage}

安全性

特性

• 可变长度PIN码支持（4-10位）
• 恒定时间PIN码比较
• 输入 sanitization
• 速率限制
• 文件扩展名过滤
• 客户端不存储PIN码
• 安全的文件处理

技术细节

技术栈

• 后端：Node.js (>=20.0.0) 与 Express
• 前端：原生JavaScript (ES6+)
• 容器：Docker 多阶段构建
• 安全：Express安全中间件
• 上传：通过Multer处理分块文件
• 通知：Apprise集成

依赖项

• express: Web框架
• multer: 文件上传处理
• apprise: 通知系统
• cors: 跨域资源共享
• dotenv: 环境配置
• express-rate-limit: 速率限制

贡献

1. Fork 仓库
2. 创建你的特性分支 (git checkout -b feature/amazing-feature)
3. 使用规范提交信息提交更改
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开Pull Request

有关本地设置和指南，请参见本地开发（推荐的快速开始）。

由 DumbWare.io 用心制作 ❤️

未来特性

• 移动端相机上传

有想法？https://github.com/dumbwareio/dumbdrop/issues 或 https://github.com/dumbwareio/dumbdrop/pulls