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: 排序时将文件夹全部放到最后面