JustList

JustList，仅仅是目录。

没错，又一款简单的网盘文件列表与分享工具。

• Demo for JustList

功能

• 多网盘支持，包含天翼云盘、OneDrive、OneDrive 世纪互联
• 可同时启用多个网盘的多个用户
• 可设置文件夹密码，即私密目录
• 有用的请求预处理机制，包含 Rate Limit、Referrer 验证等
• 简洁的缓存与自动刷新机制

部署

本程序支持前后端分离，以下主要为后端部署说明。

总的来说，很简单的几步：

1. 下载程序与依赖
2. 修改配置项
3. 启用模块
4. 运行

1. 安装依赖

• Python 3.7(+)

$ pip3 install -r requirements.txt

2. 修改配置

所有配置文件都放于 ./app/config/ 文件夹中，如下：

• cloud189.yml：天翼云盘配置（需禁止的文件、根目录、刷新时间等）
• onedrive.yml：OneDrive 配置（同上）
• switch.yml：插件开关与预处理相关配置（开关、rate limit、referrer 验证等）

只需修改您想使用的网盘配置项即可，各选项详细描述可见各配置文件中的注释。

若要使用，必须修改的是账号相关的配置，如下：

# 天翼云盘，下列字段位于 ./app/config/cloud189.yml
accounts:
  Cloud189_User1:
    - "<your_username>"
    - "<your_password>"
  Cloud189_User2:
    - "<your_username>"
    - "<your_password>"

# OneDrive，下列字段位于 ./app/config/onedrive.yml
# 0 为国际版，1 为世纪互联版，填写后程序启动时会引导您手动获取 Refresh Token
accounts:
  OneDrive_INTL:
    - 0
  OneDrive_CN:
    - 1

3. 启用模块

默认不会加载任何服务。若要开启服务，请先正确修改各配置。

编辑 ./app/config/switch.yml，修改 OnOff-core 选项，如下。

# 开启或停用模块
# true 为开启，false 为停用
OnOff:
  core:
    cloud189: true
    # 天翼云盘模块
    onedrive: true
    # onedrive 模块

将相应模块的 false 改为 true 即可。

4. 启动程序

$ python3 main.py

若要更改程序的运行地址，请修改 ./main.py。默认为 http://127.0.0.1:5000/。

5. 额外

以下皆为可选操作，并不是必须的。

5.1. 文件夹密码

若要将特定文件夹设为私密，即设置文件夹密码，可以

1. 在预加密的网盘文件夹中，创建文件/文件夹
2. 将其名称设置为 <password>._.jl 格式
3. 注意，._.jl 为程序识别符，必须包含，<password> 部分可自定义

另外，程序支持在加密的文件夹下再设置其他私密文件夹。参考如下：

. 网盘目录
├── 私密文件夹 1（密码为 123）
├── ├── 123._.jl
├── ├── 1 files
├── ├── 私密文件夹 2（密码为 321）
├── ├── ├── 321._.jl
├── ├── ├── 2 files

私密文件夹下的所有文件也都是私密的，需要密码才可访问与下载。

5.2. 前后端分离

1. 编辑 ./main.py ，将 CORS(app, resources=r"/*") 取消注释
2. 编辑 ./templates/md.html ，将 api_url 改为后端运行地址即可（结尾不含 / ）

5.2. md 主题的默认显示用户

若要自定义前端 md 主题的默认显示用户，即默认显示的网盘文件列表，可以

1. 修改 ./templates/md.html 中 root_user 一项

5.3. 强制刷新目录缓存

如果需要手动强制刷新目录缓存，可以

1. 编辑 ./app/config/switch.yml ，将 sys_update.py 设置为 true

2. 编辑 ./app/plugin/sys_update.py ，将 sys/update/xxxiiixxx 改为你想要的强制刷新地址

默认为停用状态，若开启请务必修改地址！否则可能会被恶意请求。

5.4. OneDrive Client ID

如果遇到与 Token 验证相关的错误，请尝试修改此项。

或如果想使用自己的 OneDrive 客户端 ID 和密码，可以

1. 修改 ./app/lib/core/onedrive/onedrive.py 头部的变量

clientId = [
    "78d4dc35-7e46-42c6-9023-2d39314433a5",
    "dfe36e60-6133-48cf-869f-4d15b8354769",
]

第一行为 OneDrive 国际版的，第二行为世纪互联版的。

开发

目录

. JustList
├── altfe                             # Altfe 代码框架核心
├── app                               # JustList 主程序代码
├── ├── config                        # 配置项
├── ├── ├── cloud189.yml
├── ├── ├── onedrive.yml
├── ├── ├── switch.yml
├── ├── lib                           # 全局模块，启动时加载并实例化相应模块，供其他模块调用
├── ├── ├── common
├── ├── ├── static                    # 静态类
├── ├── ├── ├── arg.py
├── ├── ├── ├── file.py
├── ├── ├── ├── msg.py
├── ├── ├── ├── util.py
├── ├── ├── core                      # 核心类
├── ├── ├── ├── cloud189              # 天翼云盘模块
├── ├── ├── ├── ├── cloud189.py
├── ├── ├── ├── ├── main.py
├── ├── ├── ├── onedrive              # OneDrive 模块
├── ├── ├── ├── ├── onedrive.py
├── ├── ├── ├── ├── main.py
├── ├── ├── ├── cache.py
├── ├── pre                           # 预处理模块，当插件被实例化前执行
├── ├── ├── rate_limit.py             # rate limit 代码
├── ├── ├── verify_referrer.py        # referrer 验证代码
├── ├── plugin                        # 插件模块，当收到请求后会被实例化
├── ├── ├── do_file.py                # 直链跳转
├── ├── ├── get_list.py               # 目录获取
├── ├── ├── get_text.py               # 文本文件内容获取
├── ├── ├── sys_update.py             # 强制刷新缓存
├── templates
├── ├── md.html                       # 前端代码
├── main.py                           # 启动

API

此部分可自行修改插件以更改。

1. [POST] api/get/list/

• 目录获取
• 示例
  • api/get/list/ : 返回全部目录
  • api/get/list/user1/ : 返回 user 1 的全部目录
  • api/get/list/user2/a/b/ : 返回 user2 的 a 目录下的 b 目录/文件（如果存在）
    • application/json; charset=utf-8
    • password : 目录密码（可选）
  • api/get/list/user3/ : 返回 user3 的 id 为 xxx 的目录/文件
    • application/json; charset=utf-8
    • id : 文件 ID
    • password : 目录密码（可选）

2. [POST] api/get/text

• 文本文件内容获取
• 示例
  • 如上，仅需将 api/get/list/ 替换为 api/get/text/ 即可
  • 仅支持 .txt 与 .md 格式文件

3. [GET] file

• 直链跳转（下载文件）
• 示例
  • 如上，仅需将 api/get/list/ 替换为 file/ 即可

4. [GET] sys/update/xxxiiixxx/

• 强制刷新网盘目录缓存

说明

• 本程序会一次性加载全部允许的文件并缓存，所以若文件较多此过程可能会较慢（取决于你文件的数量与网络状况），但不影响正常运行
• 仅在小规模（天翼云盘x2、OneDrive 国际版x1、世纪互联版x1）且请求、文件数量中等的情况下测试，服务可用率约为 99%
• 网盘操作代码修改自 Aruelius/cloud189、MoeClub/OneList，感谢

声明

• 本程序仅供学习参考，请在达成目的后停止使用
• 使用后任何不可知事件都与原作者无关，原作者不承担任何后果
• MIT License

使用愉快。

; )