123pan Web版

现代化 Web 界面的 123云盘客户端

响应式设计 安全会话 完整功能 RESTful API

123pan Web版是一个基于Python和Web技术的123云盘非官方Web客户端,提供现代化的Web界面来管理您的123云盘文件。该项目将原有的桌面GUI应用扩展为Web服务,支持多用户访问,无需安装客户端即可通过浏览器管理云盘文件。

🌟 核心优势

Web 界面

响应式设计,支持桌面和移动设备访问,无需安装任何客户端软件,通过浏览器即可使用。

完整功能

文件浏览、上传下载、分享链接、文件夹管理等完整云盘功能,基于原版Pan123库开发。

会话管理

支持多用户登录,会话自动管理,Cookie HttpOnly标记,安全可靠。

内置服务

内置Web服务器和静态文件服务,无需额外配置,一键启动即可使用。

📁 核心功能

完整的管理功能,满足您的云盘需求

文件管理

浏览文件和文件夹 文件上传 (支持多文件) 文件下载 (直接下载或生成链接) 新建文件夹 删除文件

分享功能

生成分享链接 可设置提取码 长期有效链接 (至2099年)

其他特性

实时刷新文件列表 路径导航面包屑 安全的会话管理 响应式设计

免责声明

本项目为非官方第三方应用,与123云盘官方无关。使用本软件时,请遵守123云盘的服务条款和相关法律法规,合理使用原则。开发者不对因使用本软件造成的任何损失负责。

🚀 快速开始

几分钟内启动您的123云盘Web版

安装依赖

# 安装所需Python包
pip install PyQt5 requests

运行服务

# 启动Web服务器(默认端口8080)
python 123pan_web.py

# 或者指定端口
python 123pan_web.py --port 8080

使用步骤

1

启动服务

运行上述命令启动Web服务器,您将看到服务器启动信息。

2

访问应用

打开浏览器访问:http://localhost:8080

3

登录账号

使用您的123云盘账号和密码登录系统。

4

开始使用

登录成功后即可开始管理您的云盘文件。

配置说明

配置文件位置

  • Windows: %APPDATA%\Qxyz17\123pan\config.json
  • Linux/macOS: ~/.config/Qxyz17/123pan/config.json

配置内容示例

{
  "userName": "用户名",
  "passWord": "密码",
  "authorization": "Bearer token",
  "deviceType": "设备类型",
  "osVersion": "系统版本",
  "settings": {
    "defaultDownloadPath": "默认下载路径",
    "askDownloadLocation": true
  }
}

📊 API 接口

RESTful API设计,前后端分离架构

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 用户登出

安全特性

  • 会话超时: 自动销毁 (30分钟无活动)
  • Cookie安全: HttpOnly标记,防止XSS攻击
  • 密码保护: 不直接存储在Cookie中
  • 配置加密: 敏感信息加密存储

技术栈

后端

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               # 说明文档

扩展功能计划

文件搜索功能 批量操作支持 文件预览 (图片/文档) 回收站管理 上传进度实时显示 断点续传功能

集成可能性

Docker 容器化 Nginx 反向代理 HTTPS 支持 OAuth2 认证

贡献指南

欢迎提交Issue和Pull Request!请遵循以下代码规范:

  • 遵循Python PEP8规范
  • 使用有意义的变量名
  • 添加必要的注释
  • 保持向后兼容性

相关链接