一个自托管的临时分享服务:登录后才能创建分享,支持文本、隐藏文本(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 命令。下载命令只做解压,不会执行任何安装或启动操作。
先 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 里的内容解压到目标目录。
cp .env.example .env不改也能跑:端口默认 6026,数据默认存在 ./data。需要改端口、存储路径、管理员密码时编辑 .env。
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-datamkdir -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/ 里的内容复制过去再启动。
放在 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 万种组合,安全边界依赖限流与锁定。若分享内容非常敏感,建议同时开启提取码。