ARTICLE · 1016593
开源第三方 123 云盘客户端,下载不再只靠官方 PC 端
开源第三方 123 云盘客户端,下载不再只靠官方 PC 端用 123 云盘存东西的人，多少被官方 PC 客户端磨过性子：下载限速、任务管理不灵活、多账号来回切登录，传大文件夹更是心累。123pan 是一个开源的第三方 123 云盘桌面客户端，Python + PySide6 + Fluent Widgets 做的 Windows 风格界面。它通过模拟安卓客户端协议，改善了官方 PC 客户端的自用流量限制，文件管理、上传下载、离线下载、文件夹同步、多账号，功能一口气补齐。这篇讲清楚三件事：它比官方客户端强在哪、怎么装、用之前要知道哪些风险。 
先交代底细：GPLv3 协议开源，由 123panNextGen 团队维护，代码同步托管在 GitHub 和 Codeberg。项目与 123 云盘官方没有任何关联，客户端能力依赖 123 云盘服务端接口，官方策略一变，部分功能可能跟着变。 01 比官方客户端多了什么 上传下载，终于像个正经下载工具 这是它最核心的改善： 官方客户端下载不给力的时候，这几项组合下来体验差距很明显。 离线下载和秒传 支持 HTTP、HTTPS、Magnet 和迅雷链接，丢给 123 云盘服务器离线下载，挂机拿文件。秒传方面可以导入 123FastLink 或兼容的 JSON 数据，也能导出秒传链接，跨客户端分享文件不占传输额度。 文件夹同步 本地文件夹单向同步到云端目录，手动触发或定时同步（30 秒到 1 小时五档）都行。可选"本地删除时同步删除云端文件"——这个选项慎开，开了就是真镜像。 其他日常 02 怎么安装 普通用户安装 普通用户走 Releases：到 GitHub Releases 下载对应系统的版本，Windows、Linux、macOS 都有构建。也可以走项目下载站（Cloudflare CDN 分发，更新略延迟）。 注意一个坑：程序要解压到纯英文路径再运行。Nuitka 打包的产物在中文路径下可能启动后直接退出——解压完整、路径全英文，这两点做到基本就没事。 开发者源码安装 开发者走源码：需要 Python 3.12+ 和 uv： 判断装没装成：登录成功、文件列表能刷出来，就说明通了。启动闪退的话，先查路径是不是含中文，再查安全软件拦截记录。 03 要不要装 你上次用官方 PC 客户端传大文件，是不是盯着龟速进度条干等？ 是的话，这个第三方客户端值得一试。手里有多个 123 云盘账号的、NAS 上存了一堆链接想离线下载的、想把本地文件夹定时备份到云端的，这些场景它都比官方端顺手。 但风险要说在前面： 另外项目自己的免责声明写得很清楚：仅供个人学习与技术研究，请遵守 123 云盘用户协议及相关法律法规，勿用于商业用途。用第三方客户端不等于可以无限制薅平台流量，自用适度，别碰批量倒腾——账号被封了得不偿失。 04 常见问题 杀毒软件提示风险怎么办 发行版未签名导致的误报。只从 GitHub Releases 或项目官网下载，行为可通过公开源码核对。 程序启动后立即退出 按顺序查：架构对不对 → 是否完整解压 → 路径是否纯英文 → 安全软件拦截记录 → 源码运行确认 Python 3.12+ 并执行过 uv sync。 下载速度不理想 "设置 → 下载设置"里调线程数、并发数和限速；挂了代理的话检查代理链路。实际速度还是受网络环境、账号状态和服务端策略影响。 05 相关链接 GitHub 项目主页： https://github.com/123panNextGen/123pan 项目下载站： https://download.123panng.top/
多线程分片下载，断点续传，429 / 5xx 错误自动退避重试； 上传支持分片、断点续传和秒传，文件夹整个拖进去也行； 任务的暂停、继续、取消、优先级调整都可控； 线程数、并发任务数、限速自己配，还支持 HTTP / SOCKS5 下载代理。
文件管理：目录树 + 表格视图、搜索排序、回收站恢复、免费和付费分享链接管理； 多账号：账号密码或 App 扫码登录，多账号保存快速切换，不用来回退登； 文件预览：图片、代码文本、PDF、音频、视频都能在线看； 界面：中英双语、深浅主题、Windows 11 Mica 效果，快捷键齐全（F5 刷新、Ctrl+U 上传、Ctrl+D 下载这套标准操作都有）。
git clonehttps://github.com/123panNextGen/123pan.gitcd 123panuv syncuv run src/123pan.py
账号风险自担：它模拟安卓客户端协议，服务端策略随时可能调整，账号限制、服务中断的可能性客观存在； 杀软误报：发行版暂未代码签名，部分安全软件会报风险，只从 GitHub Releases 或官网下载，源码是公开的可以自己核对； 不保证一直能用：依赖服务端接口的第三方客户端，本质上是在跟着官方的接口走，哪天接口变了就得等更新。