mirror of
https://github.com/Bao-qing/123pan.git
synced 2026-08-17 23:37:02 +08:00
合并协议
This commit is contained in:
保清
@@ -1,232 +1,162 @@
|
||||
# 123云盘 下载工具
|
||||
# 123Pan 下载工具
|
||||
|
||||
***<del>不要把123变成下一个baidu。</del>***
|
||||
## 项目介绍
|
||||
#### 1.下载工具
|
||||
123云盘下载工具是一个使用 Python 编写的脚本，通过模拟安卓客户端协议来绕过 123云盘的自用下载流量限制。该工具可以帮助用户在电脑上方便地下载 123云盘上的文件，并提供了多种操作功能，如列出文件、下载文件、上传文件、分享文件等。
|
||||
#### 2.油猴脚本（解除网页端限流）
|
||||
123download.js是一个油猴（篡改猴）脚本，使用油猴扩展安装该脚本后，用户可以直接在123云盘官网不限流量下载文件（文件夹打包仍有流量限制，请尽量单文件下载）
|
||||
# 一、123云盘下载工具
|
||||
## 功能特点
|
||||
123 网盘命令行工具，支持列出文件、下载、上传、分享、删除、创建目录及回收站管理。Android 客户端或 Web 协议，便于在本地批量管理与下载文件。
|
||||
|
||||
- **登录**：使用用户名和密码登录 123Pan 账号。
|
||||
- **列出文件**：显示当前目录下的所有文件和文件夹。
|
||||
- **下载文件**：通过模拟安卓客户端协议下载文件，绕过流量限制。
|
||||
|
||||
文件均下载到同目录下的download文件夹，下载时使用.123pan后缀，完成后重命名为文件原始名称。
|
||||
- **上传文件**：将本地文件上传到 123Pan。
|
||||
- **分享文件**：生成文件分享链接。
|
||||
- **删除文件**：删除指定的文件或文件夹。
|
||||
- **创建文件夹**：在当前目录下创建新文件夹。
|
||||
安卓客户端协议不受下载流量限制（推荐使用）。
|
||||
|
||||
## 使用方法
|
||||
123download.js 是网页端下载油猴脚本最初版本，仍然可以使用，仅保留最基本的解锁下载功能，不再更新。
|
||||
可以参考其他项目：[123云盘解锁 (@QingJ)](https://greasyfork.org/zh-CN/scripts/519353-123%E4%BA%91%E7%9B%98%E8%A7%A3%E9%94%81)
|
||||
[123 云盘会员青春版 (@hmjz100)](https://greasyfork.org/zh-CN/scripts/513528-123-%E4%BA%91%E7%9B%98%E4%BC%9A%E5%91%98%E9%9D%92%E6%98%A5%E7%89%88)
|
||||
|
||||
**可以直接下载release的可执行文件运行或运行python脚本。**
|
||||
## 特性
|
||||
- 登录 / 登出
|
||||
- 列出当前目录文件（ls）
|
||||
- 切换目录（cd）与刷新（refresh / re）
|
||||
- 下载单文件或递归下载文件夹（download / d）
|
||||
- 上传文件（upload）
|
||||
- 创建文件夹（mkdir）
|
||||
- 删除文件（rm）
|
||||
- 创建分享链接（share）
|
||||
- 获取文件直链（link）
|
||||
- 回收站管理（recycle / restore）
|
||||
- 协议切换（protocol android|web）
|
||||
- 支持保存配置到 JSON 文件（authorization、device/os、protocol 等）
|
||||
|
||||
### 直接运行
|
||||
|
||||
Windows用户下载123pan_win_x86_64.zip，解压后直接运行android.exe。
|
||||
## 脚本环境要求
|
||||
- Python 3.7+
|
||||
- 依赖库：requests
|
||||
安装：
|
||||
```bash
|
||||
pip install requests
|
||||
```
|
||||
|
||||
## 安装与运行
|
||||
### 脚本运行
|
||||
#### 环境准备
|
||||
|
||||
1. 确保已正确安装并配置 Python 3.x。
|
||||
|
||||
2. 克隆或下载本项目代码到本地，在项目目录打开终端
|
||||
|
||||
3. 安装所需的 Python 库：
|
||||
|
||||
1. 克隆或下载本仓库到本地。
|
||||
2. 进入项目目录。
|
||||
3. 运行脚本：
|
||||
```bash
|
||||
pip install -r requirements.txt
|
||||
python 123pan.py
|
||||
```
|
||||
启动后会提示输入用户名 / 密码，或自动读取配置文件（默认 `123pan_config.json` 或 `123pan.txt`，脚本内部根据传入参数使用该文件）。
|
||||
### 下载release版
|
||||
根据系统下载对应的 release 版本，解压后运行 `123pan.exe`（Windows）或 `123pan`（Linux）。
|
||||
## 配置文件（JSON）
|
||||
脚本会读取并保存一个配置文件（示例 `123pan_config.json`），保存登录状态与偏好，格式示例：
|
||||
```json
|
||||
{
|
||||
"userName": "your_username",
|
||||
"passWord": "your_password",
|
||||
"authorization": "Bearer xxxxx",
|
||||
"deviceType": "M2007J20CI",
|
||||
"osVersion": "Android_10",
|
||||
"protocol": "android"
|
||||
}
|
||||
```
|
||||
注意：保存密码或 token 到本地会有安全风险，请在可信环境下使用并妥善保护该文件。
|
||||
|
||||
#### 运行脚本
|
||||
## 常用命令（交互式）
|
||||
在脚本交互提示符中输入命令，部分带参数：
|
||||
|
||||
|
||||
1. 打开终端或命令提示符，进入项目目录。
|
||||
|
||||
2. 运行脚本：
|
||||
|
||||
使用安卓客户端协议
|
||||
|
||||
```bash
|
||||
python android.py
|
||||
```
|
||||
|
||||
使用web协议（不建议，已停止更新）
|
||||
|
||||
```bash
|
||||
python web.py
|
||||
```
|
||||
|
||||
### 命令
|
||||
|
||||
- **登录**：`log`
|
||||
|
||||
- **列出文件**：`ls`
|
||||
|
||||
- **刷新目录**：`re`
|
||||
|
||||
- **下载文件**：直接输入文件编号或者
|
||||
|
||||
`download <文件编号>`
|
||||
- 直接输入编号
|
||||
- 若编号对应文件夹 → 进入该文件夹
|
||||
- 若编号对应文件 → 直接下载该文件
|
||||
|
||||
Android协议下使用download命令可以直接下载文件夹
|
||||
- ls
|
||||
- 显示当前目录的文件与文件夹列表。
|
||||
|
||||
- **获取下载链接** `link <文件编号>`
|
||||
- cd [编号|..|/]
|
||||
- 切换目录：
|
||||
- cd 3 —— 进入当前列表第3项（如果是文件夹）。
|
||||
- cd .. —— 返回上级。
|
||||
- cd / —— 返回根目录。
|
||||
|
||||
- **分享文件**：`share`
|
||||
- mkdir [名称]
|
||||
- 在当前目录创建文件夹。例如：mkdir test
|
||||
|
||||
- **删除文件**：`delete <文件编号>`
|
||||
- upload [路径]
|
||||
- 上传文件到当前目录。例如：upload C:\Users\you\Desktop\file.txt
|
||||
- 仅支持文件，暂不支持目录批量上传。
|
||||
|
||||
- **创建文件夹**：`mkdir <文件夹名称>`
|
||||
- rm [编号]
|
||||
- 删除当前列表中的文件/文件夹（会移动到回收站）。例如：rm 2
|
||||
|
||||
- **切换目录**：直接输入文件夹编号，或
|
||||
- share [编号 ...]
|
||||
- 为一个或多个文件创建分享链接，例如：share 2 4
|
||||
- 程序会提示输入提取码（可留空）。
|
||||
|
||||
`cd <目录编号>`
|
||||
|
||||
使用`cd ..` 返回上一级目录<br>
|
||||
|
||||
- **上传文件**：`upload`，然后输入文件路径
|
||||
- link [编号]
|
||||
- 获取文件直链。例如：link 3
|
||||
|
||||
- **直接输入数字**：进入文件夹，或是下载文件
|
||||
- download / d [编号]
|
||||
- 下载指定编号的文件或文件夹（如果是文件夹，会递归下载）。
|
||||
- 例如：download 5
|
||||
|
||||
- **退出**：`exit`
|
||||
- recycle
|
||||
- 显示回收站内容，并可恢复或清空。
|
||||
- 可输入编号恢复，或输入 clear 清空回收站。
|
||||
|
||||
### 示例
|
||||
- refresh / re
|
||||
- 刷新当前目录列表。
|
||||
|
||||
1. 登录：
|
||||
|
||||
```bash
|
||||
> log
|
||||
```
|
||||
- reload
|
||||
- 重新加载配置文件并刷新目录。
|
||||
|
||||
2. 列出文件：
|
||||
|
||||
```bash
|
||||
> ls↵
|
||||
```
|
||||
- login / logout
|
||||
- login：手动登录（使用当前配置或提示输入）。
|
||||
- logout：登出并清除授权信息（保存配置时会写入空 token）。
|
||||
|
||||
3. 下载文件：
|
||||
|
||||
```bash
|
||||
> download 1↵
|
||||
```
|
||||
|
||||
或直接输入文件编号：
|
||||
|
||||
```bash
|
||||
>54↵
|
||||
1.20.0.01_v8a.apk 193.53M
|
||||
press 1 to download now: 1↵
|
||||
1.20.0.01_v8a.apk 193.53M
|
||||
[██████████████████████████████████████████████████] 100%
|
||||
ok
|
||||
```
|
||||
|
||||
下载文件夹（android）：
|
||||
|
||||
打包下载依旧会受到流量限制，递归下载无限制，请尽量使用递归下载。
|
||||
|
||||
```bash
|
||||
>download 13
|
||||
test
|
||||
输入1遍历下载，输入2打包下载:1
|
||||
文件 FLUID.dat 已存在，是否要覆盖？
|
||||
输入1覆盖，2跳过，3全部覆盖，4全部跳过：4
|
||||
已跳过
|
||||
文件 FLUID.cas已跳过
|
||||
文件 profili2.3.zip已跳过
|
||||
...
|
||||
```
|
||||
- more
|
||||
- 如果当前目录分页未加载完，输入 more 继续加载更多文件。
|
||||
|
||||
4. 获取下载链接
|
||||
|
||||
```bash
|
||||
>link 32
|
||||
https://1-180-24-9.pd1.cjjd19.com:30443/(A Long Link)
|
||||
```
|
||||
|
||||
获取下载链接后可以使用IDM下载
|
||||
- protocol [android|web]
|
||||
- 切换协议。例：protocol web
|
||||
- 切换后会重新初始化请求头，并可选择保存到配置文件。
|
||||
|
||||
5. 分享文件：
|
||||
|
||||
```bash
|
||||
>share↵
|
||||
分享文件的编号：58↵
|
||||
['Something.jpg']
|
||||
输入1添加文件，0发起分享，其他取消0↵
|
||||
提取码，不设留空：↵
|
||||
ok
|
||||
分享链接：
|
||||
https://www.123pan.com/s/(someting)提取码：(something)
|
||||
```
|
||||
- exit
|
||||
- 退出程序。
|
||||
|
||||
6. 删除文件：
|
||||
|
||||
```bash
|
||||
> delete 1
|
||||
```
|
||||
---
|
||||
|
||||
7. 创建文件夹：
|
||||
|
||||
```bash
|
||||
> mkdir 新建文件夹
|
||||
```
|
||||
交互示例：
|
||||
```
|
||||
/> cd demo
|
||||
无效命令，使用 '..' 返回上级，'/' 返回根目录，或输入文件夹编号
|
||||
/> cd 1
|
||||
当前目录为空
|
||||
/demo1> ls
|
||||
当前目录为空
|
||||
/demo1> mkdir test
|
||||
目录 'test' 创建成功
|
||||
|
||||
8. 上传文件：
|
||||
|
||||
```bash
|
||||
>upload
|
||||
请输入文件路径：C:\(some path)\config
|
||||
文件名: config
|
||||
检测到1个同名文件,输入1覆盖，2保留两者，0取消：2
|
||||
上传文件的fileId: (someThing)
|
||||
已上传：100.0%
|
||||
处理中
|
||||
上传成功
|
||||
```
|
||||
### 配置文件说明
|
||||
/demo1> 1
|
||||
当前目录为空
|
||||
/demo1/test> upload 123pan.py
|
||||
上传进度: 100.0%
|
||||
上传完成，正在验证...
|
||||
文件上传成功
|
||||
------------------------------------------------------------
|
||||
编号 类型 大小 名称
|
||||
------------------------------------------------------------
|
||||
1 文件 38.66 KB 123pan.py
|
||||
============================================================
|
||||
|
||||
在首次运行脚本时，会自动生成一个 `123pan.txt` 文件，用于保存用户的登录信息。请确保该文件与脚本在同一目录下。
|
||||
# 二、123云盘辅助下载脚本
|
||||
## 功能
|
||||
不影响网页端的操作下，绕开流量限制，可以直接点击下载
|
||||
（文件夹打包仍无法不限流量下载,文件夹请使用下载工具下载）
|
||||
/demo1/test> 1
|
||||
开始下载: 123pan.py
|
||||
进度: 100.0% | 38.66 KB/38.66 KB | 10.29 MB/s
|
||||
下载完成: 123pan.py
|
||||
/demo1/test>
|
||||
```
|
||||
|
||||
## 安装方法
|
||||
## 1.通过油叉安装（推荐）
|
||||
### 下载油猴扩展
|
||||
## 下载说明
|
||||
- 下载到脚本所在目录的 `download` 文件夹，下载过程中使用临时后缀 `.123pan`，下载完成后会重命名为原文件名。
|
||||
- 如果文件已存在，会提示覆盖 / 跳过 / 全部覆盖 / 全部跳过等选项。
|
||||
|
||||
进入谷歌浏览器或edge浏览器扩展商店，搜索“篡改猴”，安装：<br>
|
||||
|
||||
## 注意事项
|
||||
- 本工具用于学习与自用场景，请勿用于违法用途。对任何滥用造成的后果，本人概不负责。
|
||||
- 模拟客户端协议可能存在账号或服务端策略风险，请谨慎使用。
|
||||
- 建议不要在公用或不受信任的机器上保存明文密码或授权信息。
|
||||
|
||||
### 安装脚本<br>
|
||||
打开篡改猴，点击获取新脚本：<br>
|
||||
## 免责声明
|
||||
|
||||
|
||||
|
||||
### 进入油叉： 或直接进入脚本地址：```https://greasyfork.org/zh-CN/scripts/510621-123%E4%BA%91%E7%9B%98%E4%B8%8B%E8%BD%BD%E8%BE%85%E5%8A%A9```<br>
|
||||
|
||||
|
||||
|
||||
### 搜索```123云盘下载辅助```:<br>
|
||||
<br>
|
||||
### 安装：<br>
|
||||
<br>
|
||||
<br>
|
||||
<br>
|
||||
|
||||
|
||||
|
||||
### 安装完成后即可进入123云盘官网不限速下载：
|
||||
|
||||
|
||||
## 2.直接安装
|
||||
下载本仓库的123download.js，安装进油猴即可，具体方法不再详述，请自行搜索。
|
||||
|
||||
# 注意事项
|
||||
|
||||
- 请确保在使用过程中网络连接正常。
|
||||
- 由于使用了模拟安卓客户端协议，可能会有一定的风险，请谨慎使用。
|
||||
- 本工具仅供学习和研究使用，请勿用于非法用途，任何滥用行为造成的后果由使用者承担
|
||||
本工具用于学习场景，请勿用于违法用途。对任何滥用造成的后果，作者概不负责。
|
||||
Reference in New Issue
Block a user