lou7z-encrypt-server 文件安全传输服务端
7z-encrypt 文件安全传输系统的服务端。零知识 + 零合并：只存密文卷、不持密钥、不解密、不合并。
客户端上传密文卷 → 服务端只存卷 → 客户端逐卷下载 → 本地解密
服务端手里永远只有密文: 没有密钥, 没有明文, 连文件名都是加密的
特性
- 零知识: 服务端无密钥不解密, 存储的全是密文卷, 管理员也看不到内容
- 零合并: complete 只校验卷齐 + 目录 move 入库, 秒回 (6 卷实测 1.1 秒), 服务端零 CPU 合并
- 元数据零知识: 文件名是客户端加密后的 URL-safe base64 (
enc:前缀), 服务端只见密文 - Bearer token 认证: 无/错 token 一律 401
- 卷级校验: 每卷 SHA-256 校验, 坏卷 409 拒绝
- 断点续传: GET /chunks 查已收卷, 客户端只补传缺失卷
- 空间配额: 已用/配额/剩余/百分比
- 文件管理: ls / 逐卷下载 / 删除
- 业务日志: 所有端点事件 + 客户端 IP
- 轻量: FastAPI + SQLite, PRoot 容器 (手机 ZeroTermux) 都能跑
快速部署
pip install fastapi uvicorn cryptography tqdm
SZ_TOKEN=你的token python3 main.py # 默认 0.0.0.0:8000
环境变量
| 变量 | 默认 | 说明 |
|---|---|---|
| SZ_TOKEN | sz-dev-token-change-me | 认证 token (必须设置, 与客户端一致) |
| SZ_QUOTA | 10GB | 空间配额 |
| SZ_DB_PATH | data/app.db | SQLite 路径 |
| SZ_STORAGE_ROOT | data/storage | 密文卷存储目录 |
| SZ_TMP_ROOT | data/tmp | 上传临时目录 |
| SZ_HOST / SZ_PORT | 0.0.0.0 / 8000 | 监听地址 |
API
POST /api/auth/register 注册账号 {username, token}
POST /api/auth/login 登录 {username, token}
GET /api/auth/me 当前用户 (token 验证)
POST /api/auth/logout 注销 (token 失效)
POST /api/transfer/init 建任务 {transfer_id}
PUT /api/transfer/{id}/chunk/{n} 上传单卷密文 409 = 坏卷
GET /api/transfer/{id}/chunks 已收卷列表 断点续传
POST /api/transfer/{id}/complete 卷齐入库(秒回) {file_id}
GET /api/files 文件列表(按用户隔离) 文件名是加密的
GET /api/files/{id}/chunk/{n} 下载单卷密文 X-Enc-Params 头带解密参数
DELETE /api/files/{id} 删除文件(归属校验)
GET /api/quota 空间配额(按用户)
全部端点需 Authorization: Bearer <token> (SZ_TOKEN = admin)
账号: 密码 pbkdf2-hmac-sha256 存储, 登录 token 随机 32 字节, 文件按用户名隔离。
日志与自愈
/tmp/sz-server.log 业务日志 ([业务] 动作 IP 参数) + uvicorn 访问日志
/tmp/sz-watchdog.log 看门狗日志
tail -f /tmp/sz-server.log # 实时看
- start.sh: 幂等拉起服务 + 看门狗 (已在跑则跳过), 容器重启自动恢复
- watchdog.sh: 30 秒检查一次服务进程, 挂了自动拉起 (flock 防重复)
- 容器唤醒钩子:
~/.bashrc末尾[ -f /root/server/start.sh ] && /root/server/start.sh
存储结构
data/
├─ app.db SQLite (users / transfers / files / chunks)
├─ storage/用户名/日期/任务ID/ 密文卷目录 (每用户独立目录, chunk_0001..N, 不合并)
│ admin/ SZ_TOKEN 上传的文件
│ 用户名/ 注册用户上传的文件
└─ tmp/任务ID/ 上传中的卷 (complete 后 move 入 storage)
测试
.venv/bin/pytest -q # 9 项: 认证/全链路/坏卷/幂等/清洗/配额/删除
协议
MIT License, Copyright (c) 2026 edgevoid