现代化 Web 界面的 123云盘客户端
123pan Web版是一个基于Python和Web技术的123云盘非官方Web客户端,提供现代化的Web界面来管理您的123云盘文件。该项目将原有的桌面GUI应用扩展为Web服务,支持多用户访问,无需安装客户端即可通过浏览器管理云盘文件。
响应式设计,支持桌面和移动设备访问,无需安装任何客户端软件,通过浏览器即可使用。
文件浏览、上传下载、分享链接、文件夹管理等完整云盘功能,基于原版Pan123库开发。
支持多用户登录,会话自动管理,Cookie HttpOnly标记,安全可靠。
内置Web服务器和静态文件服务,无需额外配置,一键启动即可使用。
完整的管理功能,满足您的云盘需求
本项目为非官方第三方应用,与123云盘官方无关。使用本软件时,请遵守123云盘的服务条款和相关法律法规,合理使用原则。开发者不对因使用本软件造成的任何损失负责。
几分钟内启动您的123云盘Web版
# 安装所需Python包 pip install PyQt5 requests
# 启动Web服务器(默认端口8080) python 123pan_web.py # 或者指定端口 python 123pan_web.py --port 8080
运行上述命令启动Web服务器,您将看到服务器启动信息。
打开浏览器访问:http://localhost:8080
使用您的123云盘账号和密码登录系统。
登录成功后即可开始管理您的云盘文件。
%APPDATA%\Qxyz17\123pan\config.json~/.config/Qxyz17/123pan/config.json{
"userName": "用户名",
"passWord": "密码",
"authorization": "Bearer token",
"deviceType": "设备类型",
"osVersion": "系统版本",
"settings": {
"defaultDownloadPath": "默认下载路径",
"askDownloadLocation": true
}
}
RESTful API设计,前后端分离架构
123pan Web版采用RESTful API设计,所有操作都通过标准的HTTP请求完成。以下为主要的API接口:
| 端点 | 方法 | 描述 |
|---|---|---|
/api/list |
POST | 获取当前目录文件列表 |
/api/mkdir |
POST | 创建新文件夹 |
/api/cd |
POST | 切换当前目录 |
/api/download |
POST | 获取文件下载链接 |
/api/share |
POST | 创建文件分享链接 |
/api/delete |
POST | 删除文件或文件夹 |
/login |
POST | 用户登录认证 |
/logout |
GET | 用户登出 |
Python 3 + WSGI + JSON + uuid
HTML5/CSS3 + JavaScript ES6 + Font Awesome
RESTful API + Cookie会话 + JSON数据
清晰的项目架构,便于开发和维护
# 123pan Web版项目结构 123pan-web/ ├── main/ │ ├── pan.py # 核心云盘库 (原桌面版) │ └── web/ # Web静态文件 │ ├── index.html # 主界面 │ ├── login.html # 登录页面 │ ├── style.css # 样式文件 │ └── icon.ico # 网站图标 ├── 123pan_web.py # Web服务器主文件 ├── config.json # 配置文件 (自动生成) ├── requirements.txt # Python依赖包 └── README.md # 说明文档
欢迎提交Issue和Pull Request!请遵循以下代码规范: