Skip to main content

基本配置

所有账号的通用项

虚拟路径

必填，唯一标识符，即你要挂载到的位置，如果你要挂载到根目录，即为/

index（索引）

当有多个账号时，用于排序，越小越靠前

proxy（代理相关）

一个有三个相关选项：

  • proxy：网页端和直链走不走中转
  • webdav_proxy：webdav文件下载走不走中转
  • webdav_direct：webdav是否直接由本机中转

如果没有proxy和webdav_proxy选项，则说明只能走中转

存储分可以直接请求（有proxy开关）和不可以直接请求的（无proxy开关） 不可以直接请求的会直接走程序所在服务器（如果你没有填down_proxy_url） 可以直接请求的：

  • proxy关、webdav_proxy关：文件下载请求完全不走服务器
  • proxy开、webdav_proxy关：网页上的预览、直链下载都走服务器，但webdav下载不走服务器
  • proxy关、webdav_proxy开：网页上的预览、直链下载不走服务器，但webdav下载走服务器
  • proxy开、webdav_proxy开：网页预览、直链下载和webdav下载都走服务器。
  • webdav_direct: 如果打开此开关，则webdav文件直接由本机中转，且不经过302跳转。如果此项关闭且打开webdav_proxy，webdav客户端在get文件时可能会经过多次302跳转。因为部分客户端可能不支持302跳转get文件，所以打开此开关可能会提示部分客户端的兼容性。

down_proxy_url（下载代理地址）

不填此字段开启代理时，默认使用本机进行中转。提供两种代理方法：

cloudflare workers

可以使用cloudflare workers进行代理，此处填写cloudflare workers地址即可。 workers代码可以在https://github.com/alist-org/alist-proxy/blob/main/alist-proxy.js 找到。其中：

  • HOST: 你的Alist地址，必须添加协议头，且后面不能添加/。如https://alist.nn.ci；
  • TOKEN：参见Alist部分的Token。

通用二进制

你也可以使用另外一台机器进行代理，在https://github.com/alist-org/alist-proxy/releases 下载程序

./alist-proxy -help查看使用方法。

你也可以自己开发代理程序，一般的步骤为：

  • 下载时会请求PROXY_URL/path?sign=sign_value
  • 在代理程序中验证sign，sign的计算方式为:
const name = path.split('/').pop();
const sign = md5(`alist-${TOKEN}-${name}`).slice(8, 24)
  • 验证sign无误后，请求HOST/api/admin/link，可以得到文件的URL与需要携带的请求头
  • 使用得到的信息请求并返回

api_proxy_url（API代理地址）

同down_proxy_url，请求API使用的代理，专门为GoogleDrive和PikPak等国内无法直接访问的存储准备。

extract_folder

  • front: 排序时将文件夹全部放到最前面
  • back: 排序时将文件夹全部放到最后面