Skip to content
Steve0723Public

About

瞬传 QuickDrop · 自托管临时分享服务:登录建分享、隐藏文本 4 位密码、提取码、到期自动销毁(Go + Docker Compose)

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

瞬传 QuickDrop

一个自托管的临时分享服务:登录后才能创建分享,支持文本、隐藏文本(4 位数字密码解锁)、文件;链接可加提取码、可设有效期(默认 24 小时),到期即自动删除记录与磁盘文件。

后端 Go(标准库,零第三方依赖),前端原生 HTML/CSS/JS 并通过 go:embed 打进同一个二进制。

# 在空目录里执行,文件直接解压到当前目录(只下载解压,不执行任何安装或启动命令)
curl -fsSL https://github.com/Steve0723/quickdrop/archive/refs/heads/main.tar.gz | tar -xz --strip-components=1
docker compose up -d --build

功能

能力 说明
登录鉴权 只有管理员创建的账号能登录,不开放注册
文本分享 支持公开文本 + 隐藏文本
隐藏文本 创建时系统随机生成 4 位数字密码,访客输入密码才能查看;连续输错 8 次锁定 30 分钟
文件分享 多文件上传(默认最多 10 个,单文件 200MB),支持图片预览
提取码 可选,字母数字;校验通过后下发签名 Cookie,下载文件同样校验
有效期 默认 24 小时,可选 30 分钟 / 1 / 6 / 12 / 24 小时 / 3 天 / 7 天 / 自定义
过期清理 每分钟扫描一次,过期分享连记录带文件一起删除,不保留
账号管理 管理员可建号、改密、禁用、删除;删除账号会连带删除其分享与文件
分享面板 查看自己分享的状态、剩余时间、浏览/下载次数,可复制链接、查看详情、手动删除

部署

整个过程只有三步:下载 → (可选)改配置 → 自己执行 docker 命令。下载命令只做解压,不会执行任何安装或启动操作。

1. 下载到当前目录

先 cd 到一个空目录,然后:

curl -fsSL https://github.com/Steve0723/quickdrop/archive/refs/heads/main.tar.gz | tar -xz --strip-components=1

--strip-components=1 会去掉压缩包里的顶层目录,文件直接落在当前目录。或者用 git:

git clone https://github.com/Steve0723/quickdrop.git .

Windows 也可以直接到仓库页面点 Code → Download ZIP,把 quickdrop-main 里的内容解压到目标目录。

2. 配置(可选)

cp .env.example .env

不改也能跑:端口默认 6026,数据默认存在 ./data。需要改端口、存储路径、管理员密码时编辑 .env。

3. 启动

docker compose up -d --build

打开 http://localhost:6026,会跳到登录页。

常用命令:

docker compose logs -f            # 看日志
docker compose restart            # 重启
docker compose down               # 停止
docker compose up -d --build      # 改了配置或更新代码后重建

首次登录

首次启动会自动创建管理员账号,密码随机生成,两种取法任选:

# 1. 看启动日志
docker compose logs quickdrop | grep -A2 初始管理员

# 2. 读凭据文件(数据目录里的 admin-credentials.txt)
cat data/admin-credentials.txt

也可以在 .env 里提前指定,避免随机密码:

QD_ADMIN_PASSWORD=你的密码

登录后进入「账号管理」创建其他账号,并建议先改掉管理员密码、删除 admin-credentials.txt。

存储路径

默认存到 docker-compose.yml 同级的 ./data:

data/
├── db.json                  # 账号、会话、分享元数据
├── files/                   # 上传的文件(随机文件名)
└── admin-credentials.txt    # 首次启动生成的初始密码

改位置只需在 .env 里设 QD_DATA_DIR,相对路径相对 compose 文件,也可以写绝对路径:

QD_DATA_DIR=/mnt/disk/quickdrop-data
mkdir -p /mnt/disk/quickdrop-data
docker compose up -d --build

权限:容器以 root 启动,入口脚本会把 QD_DATA_DIR 的属主修正为 10001:10001,然后降权到该用户运行主程序。所以绑定挂载不需要手动 chown,换盘、换目录都能直接用。

只有在 compose 里显式写了 user: 覆盖运行用户时,才需要自己保证目录可写。

配置

复制 .env.example 为 .env(compose 会自动读取),或直接改 docker-compose.yml。

变量 默认值 说明
QD_PORT 6026 宿主机端口
QD_DATA_DIR ./data 存储路径(db.json 与上传文件)
QD_ADMIN_USER admin 初始管理员用户名(仅首次启动生效)
QD_ADMIN_PASSWORD 随机 初始管理员密码(仅首次启动生效)
QD_SECRET 随机 访问令牌签名密钥,留空则生成后存入 db.json
QD_DEFAULT_TTL_HOURS 24 默认有效期(小时)
QD_MAX_TTL_HOURS 720 最长有效期(小时)
QD_MAX_FILE_MB 200 单文件大小上限
QD_MAX_SHARE_MB 500 单次分享总大小上限
QD_MAX_FILES 10 单次分享文件数上限
QD_SESSION_DAYS 7 登录状态保留天数

数据与备份

数据全部落在 QD_DATA_DIR 指向的目录(默认 ./data),容器内挂载到 /app/data:

data/
├── db.json                  # 账号、会话、分享元数据
├── files/                   # 上传的文件(随机文件名)
└── admin-credentials.txt    # 首次启动生成的初始密码

备份就是打包这个目录:

tar czf quickdrop-backup-$(date +%F).tar.gz -C data .

恢复时解压回 QD_DATA_DIR,再 docker compose up -d 即可。

常见问题

启动报 mkdir /app/data/files: permission denied

旧版本镜像以非 root 用户直接运行,绑定挂载的宿主机目录属主是 root,写不进去。升级镜像后入口脚本会自动修正:

docker compose up -d --build

不想升级的话,临时应急:

sudo chown -R 10001:10001 ./data
docker compose restart

端口被占用

改 .env 里的 QD_PORT,再 docker compose up -d。

改了 QD_DATA_DIR 后数据「消失」

数据在新目录里,旧目录不会自动迁移。要保留历史数据就把旧 data/ 里的内容复制过去再启动。

反向代理 / HTTPS

放在 Nginx、Caddy 后面时,记得透传这两个头,否则会话 Cookie 不会带 Secure,提取码校验也拿不到真实 IP:

location / {
    proxy_pass http://127.0.0.1:6026;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    client_max_body_size 200m;   # 与 QD_MAX_FILE_MB 保持一致
}

本地开发

需要 Go 1.22+:

go run .                       # 默认 http://localhost:6026,数据写入 ./data
QD_DATA_DIR=.dev PORT=3100 go run .

前端改了不用重新编译:设置 QD_PUBLIC_DIR=public 后服务会从磁盘读静态文件,而不是用二进制里内嵌的版本。

QD_PUBLIC_DIR=public go run .

构建:

go build -trimpath -ldflags="-s -w" -o quickdrop .

目录结构

quickdrop/
├── main.go          # 启动、路由、静态资源、优雅关闭
├── config.go        # 环境变量与默认值
├── store.go         # JSON 持久化(读写锁 + 原子落盘)
├── security.go      # PBKDF2 口令哈希、短 ID、限流
├── handlers.go      # 认证、上传、分享、访客访问、下载
├── admin.go         # 账号管理
├── public/          # 前端(编译时 embed)
│   ├── login.html   index.html   share.html   admin.html   404.html
│   └── assets/      style.css  common.js
├── Dockerfile
├── docker-entrypoint.sh   # 修正数据目录属主后降权运行
├── docker-compose.yml
├── .env.example     # 配置模板
└── data/            # 运行时生成(可用 QD_DATA_DIR 改位置)

接口

POST   /api/login                            登录
POST   /api/logout                           退出
GET    /api/me                               当前用户
PATCH  /api/me                               修改自己的密码

POST   /api/uploads                          原始二进制流上传,返回临时 ID
GET    /api/shares                           我的分享列表
POST   /api/shares                           创建分享
GET    /api/shares/{id}                      分享详情(所有者/管理员)
DELETE /api/shares/{id}                      删除分享

GET    /api/public/shares/{id}               访客读取(提取码未过则 401 need_code)
POST   /api/public/shares/{id}/unlock        校验提取码
POST   /api/public/shares/{id}/reveal        校验隐藏文本密码
GET    /api/public/shares/{id}/files/{fileId} 下载(?mode=inline 可预览图片)

GET    /api/admin/users                      账号列表
POST   /api/admin/users                      创建账号
PATCH  /api/admin/users/{id}                 改密 / 改角色 / 启用禁用
DELETE /api/admin/users/{id}                 删除账号(连带分享与文件)

安全说明

  • 口令用 PBKDF2-HMAC-SHA256(12 万轮 + 随机盐) 存储,比对走常量时间
  • 会话令牌随机 32 字节,存服务端,Cookie 为 HttpOnly + SameSite=Lax
  • 所有写接口校验 Origin 与 Host 一致(CSRF 防护)
  • 登录、提取码、隐藏密码三处独立限流;隐藏密码另有按分享计的失败锁定
  • 上传文件名不参与磁盘路径,磁盘文件名为随机串,杜绝路径穿越
  • 下载强制 Content-Disposition,X-Content-Type-Options: nosniff
  • 隐藏文本密码与提取码均只在服务端保存,不会随公开接口下发

已知取舍:4 位数字密码只有 1 万种组合,安全边界依赖限流与锁定。若分享内容非常敏感,建议同时开启提取码。

About

瞬传 QuickDrop · 自托管临时分享服务:登录建分享、隐藏文本 4 位密码、提取码、到期自动销毁(Go + Docker Compose)

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages