123pan
突破限制 · 高效下载 · 简单易用
介绍
123pan是一款第三方123云盘客户端，解决了123云盘官方客户端的若干问题，并使用多种方式解除流量限制，使用Python3和PyQt6等由123pan Next Gen团队制作。本项目永久开源并托管在Github.
使用
[!WARNING] 免责声明
本项目为个人学习与技术研究目的开发，与 123 云盘官方无任何关联。使用本软件即表示您已知晓并同意以下内容：
- 本软件按「现状」提供，不提供任何明示或暗示的保证
- 开发者不对因使用本软件导致的任何直接或间接损失承担责任，包括但不限于数据丢失、账号封禁、服务中断等
- 使用者应自行承担使用本软件的全部风险，包括但不限于数据丢失、账号封禁、服务中断等，并遵守 123 云盘用户协议及相关法律法规
- 请勿将本软件用于商业用途
使用打包后的文件运行
如果你的电脑是Windows系统或者Linux发行版，可以直接下载并解压，然后运行其中的123pan.exe或123pan。
下载地址：
- Github: https://github.com/123panNextGen/123pan/releases/
- Website(CloudFlare CDN, 更新可能不及时): https://download.123panng.top/
[!TIP] Windows下如果无法运行，可以尝试打开兼容模式。杀毒软件有可能报毒，请放行。
[!IMPORTANT] 请不要从未知渠道下载！
其他系统以及开发者请参考下方的源码运行。
使用源码运行
git clone https://github.com/123panNextGen/123pan.git
cd 123pan/
准备Python虚拟环境。
uv sync
uv sync --group build --group lint # 构建环境
然后运行src下的123pan.py即可。
uv run src/123pan.py
[!TIP] 键盘快捷键
F5: 刷新文件列表
Ctrl+N: 新建文件夹
Ctrl+U: 上传文件
Ctrl+D: 下载选中文件
Delete: 删除选中文件
F2: 重命名文件
Backspace: 返回上级目录
Ctrl+F: 聚焦搜索框
Ctrl+A: 全选文件
Enter: 进入文件夹/预览文件
技术说明
默认会在系统C:\Users\%USERNAME%\AppData\Roaming\123pan或~/.config/123pan创建配置文件和日志。
密码使用 AES-256-GCM 加密存储，密钥基于机器标识派生，存储于 ~/.config/123pan/.keyfile（权限 600）。
{
"currentAccount": "账号",
"accounts": {
"账号": {
"userName": "账号",
"passWord": "密码",
"authorization": "令牌",
"deviceType": "模拟设备类型",
"osVersion": "模拟设备系统",
"loginuuid": "登陆id"
}
},
"settings": {
"defaultDownloadPath": "默认下载位置",
"askDownloadLocation": true,
"multiThreadDownload": true,
"downloadSpeedLimit": 0,
"uploadSpeedLimit": 0,
"proxyEnabled": false,
"proxyType": "http",
"proxyHost": "",
"proxyPort": 0,
"proxyUsername": "",
"proxyPassword": ""
}
}
设置项说明
| 设置项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
defaultDownloadPath |
string | ~/Downloads |
默认下载目录 |
askDownloadLocation |
bool | true |
每次下载前是否询问保存位置 |
multiThreadDownload |
bool | true |
是否启用多线程分片下载 |
downloadSpeedLimit |
int | 0 |
下载速度限制（KB/s），0 表示不限制 |
uploadSpeedLimit |
int | 0 |
上传速度限制（KB/s），0 表示不限制 |
proxyEnabled |
bool | false |
是否启用网络代理 |
proxyType |
string | "http" |
代理类型："http" 或 "socks5" |
proxyHost |
string | "" |
代理服务器地址 |
proxyPort |
int | 0 |
代理服务器端口 |
proxyUsername |
string | "" |
代理认证用户名（可选） |
proxyPassword |
string | "" |
代理认证密码（可选） |
测试
项目包含 61 个测试用例，覆盖核心逻辑层。
运行测试
# 运行全部测试
uv run pytest
# 运行特定文件
uv run pytest tests/unit/test_speed_limiter.py
# 带覆盖率报告
uv run pytest --cov
# 详细输出
uv run pytest -v
测试结构
tests/
unit/ # 纯逻辑测试，无外部依赖
test_speed_limiter.py # 令牌桶限速算法（mock time.monotonic）
test_credential.py # AES-256-GCM 加解密（临时 keyfile 隔离）
test_model.py # 数据模型解析/序列化
test_api_utils.py # format_file_size 等工具函数
test_config.py # 配置读写、旧格式迁移（临时目录隔离）
integration/ # 依赖 mock 外部服务
test_session.py # NetSession HTTP 方法（responses mock）
测试策略
| 层级 | 方式 | 说明 |
|---|---|---|
| 纯函数 | 直接断言返回值 | SpeedLimiter、format_file_size |
| 文件系统 | tmp_path fixture |
不碰 ~/.config/123pan |
| 加密 | 模块级 _KEY_FILE 覆盖 |
测试用临时 .keyfile |
| HTTP | responses 拦截 requests |
不发起真实网络请求 |
问题反馈&社区讨论
你可以通过多种途径反馈&讨论问题。
- Github Issues: https://github.com/123panNextGen/123pan/issues
- Github Discussions：https://github.com/123panNextGen/123pan/discussions
- QQ群: 996241397
我们将在第一时间解决问题。
使用协议
本程序使用GPLv3协议。
其他版本推荐
[!WARNING] 以下项目与123panNextGen团队没有任何关系，为社区的技术爱好者基于我们的项目进一步创作的。
- https://github.com/crmmc/123pan-open
本程序由123panNextGen开发团队用♥️制作～
我们由衷感谢为本程序贡献代码的人们。 贡献人员名单