115-python：115 网盘 Python 工具生态
开场
平时用 115 网盘时，我经常遇到几个很实际的问题：
- 想直接读取、挂载网盘里的文件，而不是每次都打开网页；
- 想把文件以直链、图片或扫码的方式分享出去；
- 想批量上传、下载，或者在本地维护一份文件列表用于查询。
这些需求分散在不同领域，各自写一遍轮子既重复又容易踩坑。于是我把常用的能力整理成了一个仓库：115-python。
项目定位
115-python 是 115 网盘的 Python 工具生态聚合仓库，仓库 fork 自 ChenyangGao/p115client，并在上游基础上持续维护和扩展。
需要说明的是：核心库与工具模块的基础能力都来自原作者 ChenyangGao 的辛勤工作，本仓库的主要价值是聚合、维护并在此基础上补充实用模块。我不把上游能力冒充为原创。
核心客户端：p115client
仓库的核心是 p115client，它是 115 网盘 Web API 的 Python 客户端，支持同步 / 异步，全面封装了 web、app 与 open 三类接口。
一个最小可用的示例如下（示例用占位符代替真实 Cookie，请勿直接填入自己的凭据）：
from p115client import P115Client
client = P115Client("UID=...; CID=...; SEID=...; KID=...")data = client.fs_files({"cid": 0, "limit": 100})工具模块全景
在核心库之外，仓库通过 modules/ 组织了一系列工具模块，按四类划分：
| 分类 | 模块 |
|---|---|
| 网盘挂载 / 访问 | p115dav、p115tinydav、p115wsgidav、p115ftp、p115sftp、p115fuse |
| 302 直链 / 图片 / 扫码 | p115image302、p115nano302、p115open302、p115tiny302、p115imghost、p115qrcode |
| 传输 / 存储 | p115browser-mcp、p115oss |
| 数据库 / 工具 | p115updatedb、p115querydb、p115servedb、p115pickcode、p115cipher、p115rsacipher |
各模块的详细说明见 modules/ 对应目录。
典型使用方式
使用路径有两条：
- 直接使用核心库：安装
p115client后在代码里按上面的示例调用即可。 - 独立使用某个模块：进入具体模块目录阅读独立说明。例如 MCP server 场景下进入
modules/p115browser-mcp/，按照该目录readme.md的pip install p115browser-mcp、启动 115 浏览器调试模式、配置.mcp.json等步骤操作。
这里不承诺未经验证的一键部署，具体以各模块 README 为准。
安装与快速开始
安装核心库：
pip install -U p115client安装核心库与各模块、使用独立模块（如 MCP server）时，请按对应模块的 readme.md 操作，也可以参考 p115client 文档。
项目当前 Python 版本约束为 ^3.12（即 Python 3.12 及以上），安装前请确认环境兼容。
项目边界与致谢
- 本项目以 MIT 协议 发布；
- 仓库 fork 自
ChenyangGao/p115client，上游的 LICENSE 版权归原作者 ChenyangGao（年份 2024）； - 本仓库在核心库之上维护与扩展工具模块，维护范围限于聚合、修复与补充说明，不替代上游的基础能力。
写在最后
对我来说，这套生态解决的核心问题是：把 115 网盘从「只能在网页里用」变成「可以在本地脚本、挂载目录、直链分享和本地文件列表里用」。
如果你也有类似需求，欢迎到 GitHub - 115-python 查看、使用或提 Issue。
文章分享
如果这篇文章对你有帮助，欢迎分享给更多人！