CDNPanTool

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

★ 12 Open GitHub ↗

Flet cloud drive with stego chunked upload

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# CDNPanTool

> 把任意文件伪装成图片，借助第三方图床直链，实现「云盘」式的上传、分享与找回。

CDNPanTool 是一个基于 [Flet](https://flet.dev) 的桌面工具：它把任意文件（可选口令加密）藏进一张封面图片里生成「伪装图片」，上传到图床后得到一个普通的图片直链；大文件会自动切片、并发上传并支持断点续传，最终生成一段很短的分享文本（`xfb1.` 开头），对方用本工具即可一键还原出原文件。

---

## ✨ 功能特性

- **文件伪装上传**：任意文件封装进封面图片，得到看起来就是图片的直链。
- **口令加密（可选）**：AES-256-GCM 逐块加密 + scrypt 派生密钥，口令仅存于内存、绝不落盘。
- **大文件分片**：自动切片、多线程并发上传，单片失败自动重试。
- **断点续传**：按「源文件指纹 + 口令指纹」隔离记录已传分片，中断后续传不重复上传。
- **随时取消**：上传过程中可取消，已提交但未开始的分片会被及时撤销。
- **短分享文本**：`xfb1.` 前缀的压缩短文本，携带直链/文件名/大小，粘贴即自动解析。
- **图床模式**：直接上传原图，一键复制 直链 / Markdown / HTML / BBCode。
- **上传历史**：本地保存历史记录，随时查看与复制。
- **自适应界面**：面板/表格随窗口自适应，兼容高 DPI 缩放。

---

## 🧱 技术栈

- **语言**：Python 3.9+
- **界面**：Flet（异步桌面 GUI）
- **加密**：`cryptography`（AES-256-GCM，可选依赖）
- **其余**：Python 标准库（`hashlib` / `zlib` / `concurrent.futures` / `urllib` 等）

---

## 📂 目录结构

```
flet_app.py          # GUI 入口（上传/解析/图床/历史/设置 五个视图）
cloud_service.py     # 业务编排（单文件/分片上传、续传、图床），与界面解耦、可独立测试
stego_container.py   # 伪装容器格式 + AES-256-GCM 加解密
chunk_manager.py     # 文件切片、合并、SHA-256 校验
chunk_uploader.py    # 分片并发上传（重试 / 续传 / 取消）
oss_client.py        # 图床上传/下载：流式 multipart、重试、5xx 判定
share_codec.py       # 短分享文本（zlib + base64）编解码
manifest_codec.py    # 分片索引清单编解码
settings_store.py    # 设置与上传历史的持久化（原子写、线程安全）
common.py            # 通用工具（大小格式化、磁盘预检、链接格式化等）
assets/              # 程序图标、默认伪装封面、界面 logo
tests/               # 单元测试（100+ 项，脱离界面即可运行）
build_windows.bat    # Windows 一键打包脚本
打包与分享说明.md     # 打包成 exe、分享给无 Python 环境用户的完整说明
```

---

## 🚀 快速开始（开发运行）

```bash
# 1. 安装依赖
pip install -r requirements.txt

# 2. 运行
python flet_app.py
```

> 口令加密功能需要 `cryptography`，已在 `requirements.txt` 中。若不使用加密，缺少该库不影响其它功能。

---

## 📦 打包为 exe（分享给没有 Python 的朋友）

在 **Windows** 上双击 `build_windows.bat` 即可，产物在 `dist\CDNPanTool.exe`，把这一个文件发给对方双击即用、无需安装 Python。

- 程序图标与默认伪装封面均来自 `assets/`，脚本会把整个 `assets` 一起打进 exe。
- 加密所需的 `cryptography` 也会一并打包。
- 更多细节、常见问题（杀毒误报、缺 VC++ 运行库、Mac 版怎么办等）见 **[打包与分享说明.md](打包与分享说明.md)**。

> ⚠️ 可执行文件与操作系统绑定：Windows 上打的 `.exe` 只能在 Windows 运行；Mac 需在 Mac 上另行打包。

---

## 🧭 使用说明

1. **上传分享**：选文件 → （可选填加密口令）→ 开始上传 → 复制生成的短分享文本或直链发给对方。
2. **解析文件**：粘贴对方发来的 `xfb1.` 短文本（或直链）→ 自动解析 → 下载还原原文件（加密的需输入口令）。
3. **图床**：选图片直接上传 → 复制 直链 / Markdown / HTML / BBCode。
4. **历史 / 设置**：查看历史记录；设置默认封面、分片大小、并发数等。

---

## 🔒 格式与安全说明

- **伪装容器**：在封面图片字节之后追加「元数据 + 载荷 + 尾部索引」，文件头仍是合法图片，可正常预览；尾部记录偏移与长度用于精确还原。
- **加密**：口令经 scrypt 派生密钥，载荷按块 AES-256-GCM 加密，每块独立随机 nonce；口令**只在内存中使用，不写入任何文件**，一旦遗忘无法找回。
- **完整性**：还原时以原始明文 SHA-256 校验，任何损坏/篡改都会被发现。
- **短文本**：仅包含直链、文件名与大小，经 zlib 压缩 + base64 编码；解码时限制解压上限，防止解压炸弹。

---

## 🧪 测试

```bash
# 在项目根目录运行（tests 内均为脱离界面的纯逻辑测试）
python -m unittest discover -s tests -p "test_*.py"
```

---

## ⚠️ 免责声明

本项目为个人学习与自用工具，依赖第三方图床服务存取数据。请遵守相关服务的使用条款与当地法律法规，合理使用、勿滥用；因使用本工具产生的任何后果由使用者自行承担。第三方服务的可用性、稳定性与数据留存不受本项目控制。

CDNPanTool

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README