介绍

123pan是一款第三方123云盘客户端，解决了123云盘官方客户端的若干问题，使用Python3和PySide6等由123pan Next Gen团队制作。本项目永久开源并托管在Github和Codeberg。

特色功能：

• 🚀 破解部分流量限制（模拟安卓协议，突破官方 PC 端每日 1GB 自用流量限制，下载限流（429/5xx）指数退避重试）
• 🔄 文件夹同步（本地 ↔ 云端）+ 系统托盘后台运行
• ⚡ 多线程分片下载 + 断点续传
• 📤 分片上传 + 断点续传（支持秒传），支持文件夹上传与上传前校验
• 📥 离线下载（HTTP / HTTPS / Magnet / 迅雷链接，服务器后台下载）
• ⚡ 秒传导入 / 导出（兼容 123FastLink、夸克 / 天翼等网盘秒传数据）
• 🎛️ 上传/下载限速、暂停、取消，线程数可自定义
• 📊 实时速度 & 进度显示
• 🔐 密码登录 + 123 云盘 App 扫码登录
• 👁️ 文件预览（图片/文本/PDF/音频/视频）
• 🔗 分享链接管理（免费/付费）
• 🗑️ 回收站管理
• 👤 多账号切换 + 设备伪装
• 🌐 中英文多语言支持
• 🌗 深浅色主题（跟随系统 / 浅色 / 深色，可手动切换）

功能特性

文件管理

• 文件浏览：目录树 + 表格视图，支持搜索、排序与面包屑导航，列表列宽可手动调整
• 文件操作：新建文件夹、重命名、移动、复制（支持多目标文件夹 / 复制到单个文件）、删除
• 回收站：恢复 / 永久删除
• 分享：创建分享链接（可设置密码），管理免费 / 付费分享

传输

• 多线程分片下载，支持断点续传，下载限流（429/5xx）指数退避重试
• 分片上传 + 断点续传，支持秒传；支持文件夹上传，上传前显示校验进度
• 上传 / 下载限速、暂停、取消
• 分片线程数与并发任务数可自定义
• 实时速度 & 进度显示

离线下载 & 秒传

• 离线下载：粘贴 HTTP / HTTPS / Magnet / 迅雷链接，解析后选择文件提交，由 123 云盘服务器后台下载
• 秒传导入：粘贴 123FastLink 或秒传 JSON 生成器（夸克 / 天翼等）导出的秒传数据，通过 etag 秒传到云端
• 秒传导出：选中文件一键生成秒传链接 / JSON，分享给他人可直接导入

同步

• 本地 ↔ 云端文件夹同步
• 定时同步（30s / 1m / 5m / 30m / 1h）或手动触发
• 系统托盘后台运行（支持关闭窗口最小化 / 启动时最小化）

登录与账号

• 密码登录 + 123 云盘 App 扫码登录
• 多账号保存与快速切换
• 设备伪装（模拟安卓机型，保证账号兼容）

预览

• 图片 / 文本 / PDF / 音频 / 视频在线预览

个性化

• 主题模式：跟随系统 / 浅色 / 深色，可随时手动切换
• 中英文多语言，可随时切换
• Mica 半透明效果（Windows 11）、窗口透明度可调

其他

• 下载代理（HTTP / SOCKS5）配置
• 日志系统（7 天轮转，可调整等级）

使用

使用打包后的文件运行

如果你的电脑是Windows系统或者Linux发行版，可以直接下载并解压，然后运行其中的123pan.exe或123pan。
下载地址：

• Github: https://github.com/123panNextGen/123pan/releases/
• Website(CloudFlare CDN, 更新可能不及时): https://download.123panng.top/

其他系统以及开发者请参考下方的源码运行。

使用源码运行

首先准备好 Python3 与 uv 环境，并克隆存储库。

git clone https://github.com/123panNextGen/123pan.git
cd 123pan/

准备Python虚拟环境。

uv sync                          # 安装运行时依赖
uv sync --group test --group build --group lint  # 测试 / 构建 / 代码检查环境

然后运行src下的123pan.py即可。

uv run src/123pan.py

常见问题（FAQ）

Q：为什么会被杀毒软件报毒？ A：本项目为开源项目，未进行代码签名，部分杀毒软件可能误报。请务必从官方渠道（GitHub Releases / 官网）下载，并在杀毒软件中放行。

Q：程序无法启动 / 闪退怎么办？ A：请依次检查：

1. 程序是否放在中文路径下（请移动到纯英文路径）；
2. Windows 下尝试开启兼容模式运行；
3. 系统是否满足要求（Windows 10+ / 常见 Linux 发行版；Python 3.12+ 仅在源码运行时需要）。

Q：下载速度不理想？ A：可在「设置 → 下载设置」中调高下载线程数与最大并发下载数；若配置了网络代理，也可检查代理是否影响下载速度。

Q：如何提交 Bug 或建议？ A：见下方「问题反馈&社区讨论」，或直接在 GitHub Issues / Discussions 中留言。

项目开发

开发者请移步贡献指南Wiki以及TODO

问题反馈&社区讨论

你可以通过多种途径反馈&讨论问题。

• Github Issues: https://github.com/123panNextGen/123pan/issues
• Github Discussions：https://github.com/123panNextGen/123pan/discussions
• QQ群: 996241397

我们将在第一时间解决问题。

使用协议

本程序使用GPLv3协议。

---

本程序由123panNextGen开发团队用♥️制作～
我们由衷感谢为本程序贡献代码的人们。 贡献人员名单