JustList,仅仅是目录。
没错,又一款简单的网盘文件列表与分享工具。
- 多网盘支持,包含天翼云盘、OneDrive、OneDrive 世纪互联
- 本地文件目录索引支持
- 可同时启用多个网盘的多个用户
- 可设置文件夹密码,即私密目录
- 有用的请求预处理机制,包含 Rate Limit、Referrer 验证等
- 简洁的缓存与自动刷新机制
本程序支持前后端分离,以下主要为后端部署说明。
总的来说,很简单的几步:
- 下载程序与依赖
- 修改配置项
- 启用模块
- 运行
- Python 3.7(+)
$ pip3 install -r requirements.txt
所有配置文件都放于 ./app/config/
文件夹中,如下:
- local.yml:本地目录配置项
- cloud189.yml:天翼云盘配置(设置需禁止的文件、根目录、刷新时间等)
- onedrive.yml:OneDrive 配置(同上)
- switch.yml:插件开关与预处理相关配置(开启/关闭核心、rate limit、referrer 验证等)
只需修改您想使用的网盘配置项即可,各选项详细描述可见各配置文件中的注释。
若要使用相应功能,必须修改的是账号相关的配置,如下:
# 本地目录配置项,下列字段位于 ./app/config/local.yml
accounts:
Local_A:
- "<path_a>"
Local_B:
- "<path_b>"
# 天翼云盘,下列字段位于 ./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
默认不会加载任何服务。若要开启服务,请先正确修改各配置。
编辑 ./app/config/switch.yml
,修改 OnOff-core
选项,如下。
# 开启或停用模块
# true 为开启,false 为停用
OnOff:
core:
local: false
# 本地目录模块
cloud189: false
# 天翼云盘模块
onedrive: false
# onedrive 模块
将相应模块的 false
改为 true
即可。
$ python3 main.py
若要更改程序的运行地址,请修改 ./main.py
。默认为 http://127.0.0.1:5000/
。
以下皆为可选操作,并不是必须的。
若要将特定文件夹设为私密,即设置文件夹密码,可以
- 在预加密的网盘文件夹中,创建文件/文件夹
- 将其名称设置为
<password>._.jl
格式 - 注意,
._.jl
为程序识别符,必须包含,<password>
部分可自定义
另外,程序支持在加密的文件夹下再设置其他私密文件夹。参考如下:
. 网盘目录
├── 私密文件夹 1(密码为 123)
├── ├── 123._.jl
├── ├── 1 files
├── ├── 私密文件夹 2(密码为 321)
├── ├── ├── 321._.jl
├── ├── ├── 2 files
私密文件夹下的所有文件也都是私密的,需要密码才可访问与下载。
- 编辑
./main.py
,将CORS(app, resources=r"/*")
取消注释 - 编辑
./templates/md.html
,将api_url
改为后端运行地址即可(结尾不含/
)
若要自定义前端 md
主题的默认显示用户,即默认显示的网盘文件列表,可以
- 修改
./templates/md.html
中root_user
一项
如果需要手动强制刷新目录缓存,可以
-
编辑
./app/config/switch.yml
,将sys_update.py
设置为true
-
编辑
./app/plugin/sys_update.py
,将sys/update/xxxiiixxx
改为你想要的强制刷新地址
默认为停用状态,若开启请务必修改地址!否则可能会被恶意请求。
如果遇到与 Token 验证相关的错误,请尝试修改此项。
或如果想使用自己的 OneDrive 客户端 ID 和密码,可以
- 修改
./app/lib/core/onedrive/onedrive.py
头部的变量
clientId = [
"78d4dc35-7e46-42c6-9023-2d39314433a5",
"dfe36e60-6133-48cf-869f-4d15b8354769",
]
第一行为 OneDrive 国际版的,第二行为世纪互联版的。
. JustList
├── altfe # Altfe 代码框架核心
├── app # JustList 主程序代码
├── ├── config # 配置项
├── ├── ├── local.yml
├── ├── ├── cloud189.yml
├── ├── ├── onedrive.yml
├── ├── ├── switch.yml
├── ├── lib # 全局模块,启动时加载并实例化相应模块,供其他模块调用
├── ├── ├── common # 通用类
├── ├── ├── ├── thread.py
├── ├── ├── static # 静态类
├── ├── ├── ├── arg.py
├── ├── ├── ├── file.py
├── ├── ├── ├── msg.py
├── ├── ├── ├── util.py
├── ├── ├── core # 核心类
├── ├── ├── ├── local # 本地目录模块
├── ├── ├── ├── ├── main.py
├── ├── ├── ├── 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 # 启动
此部分可自行修改插件以更改。
[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
: 文件 IDpassword
: 目录密码(可选)
[POST] api/get/text
- 文本文件内容获取
- 示例
- 如上,仅需将
api/get/list/
替换为api/get/text/
即可 - 仅支持
.txt
与.md
格式文件
- 如上,仅需将
[GET] file
- 直链跳转(下载文件)
- 示例
- 如上,仅需将
api/get/list/
替换为file/
即可
- 如上,仅需将
[GET] sys/update/xxxiiixxx/
- 强制刷新网盘目录缓存
- 本程序会一次性加载全部允许的文件并缓存,所以若文件较多此过程可能会较慢(取决于你文件的数量与网络状况),但不影响正常运行
- 仅在小规模(天翼云盘x2、OneDrive 国际版x1、世纪互联版x1)且请求、文件数量中等的情况下测试,服务可用率约为 99%
网盘操作代码修改自 Aruelius/cloud189、MoeClub/OneList,感谢
- 本程序仅供学习参考,请在达成目的后停止使用
- 使用后任何不可知事件都与原作者无关,原作者不承担任何后果
- MIT License
使用愉快。
; )