alias别名

Andy Hsu2023年3月15日GuideStorageGuide大约 8 分钟

alias别名

我们先看一张示意图

我们看到两个不同的文件夹合并在一个文件夹里面了，名字一样的文件文件夹也都合并在一起了，独有的单独显示了

例1 riluo.jpg 是本地1 独有的，在上面显示了
例2 两个文件夹都有video文件夹，但是里面的内容也会进行合并，子文件夹也同样适用于同名合并的展示规则
- 两个文件夹分别有两个视频，但是有一个是同名的，最后根据 同名合并 的展示规则合并后变成了3个文件进行展示

别名-alias是什么？ 别名-alias是路径合并的功能

除了 下载预览(只读) 操作之外 ^{(复制,删除,重命名,离线下载,上传)} 均不可以

举个例子：云盘账号1、云盘账号2 里面均有电影这个文件夹，但内容未必(全部)重合

以前(虚拟路径)：只能分别挂载到两个不同的路径上（云盘1/电影，云盘2/电影）或者（电影\云盘1，电影\云盘2）
现在(alias)：提供一个聚合的文件夹（电影）里面可以同时包含云盘1和云盘2的内容

展示时文件夹内容规则如下

同名合并：文件(夹)一样的自动合并成一个
同名优先：访问资源时，每次固定访问填写路径时顶部(靠前)的那个路径文件(夹)
- 若同名文件合并后，点击 播放，下载 时优先调用填写 Paths 时最靠前使用302模式路径的文件

下面解释一下 同名优先² 访问规则，强烈建议查看个举例都查看

填写方式

填写方式有两种

第一种是只可以填写子文件夹路径并且最后结尾时必须同名文件夹才可以，不推荐使用 ❌
- 路径填写示例：
```
/目录1/目录a
/目录2/目录b
```

第二种是可以直接挂载根文件夹ID，利用重命名的方式，强烈推荐使用 ✔️

路径填写示例：

#示例1 直接写根文件夹
合并显示:/目录1
合并显示:/目录2

#示例2 挂载不同路径文件夹进行合并
合并显示:/目录1/本地测试233
合并显示:/目录2/视频/电视剧
合并显示:/目录2/电视/国产电视剧/某某台

根据第二种这样我们可以将不同的文件夹进行合并显示，方便快捷

例1

例1、根据下面路径填写访问(302模式有优先权)

本地:/本地测试/本地1
本地:/本地测试/本地2
本地:/本地测试/本地3
本地:/本地测试/本地4

1，一个视频 1 2 3 4 都有的话每次访问的是 1
- 如果1 3 4 使用的本地代理，2 使用的302，优先调用 2
2，一个视频 3 4 有那么每次访问的都是3
- 如果 3 使用的本地代理，4 使用的302，优先调用 4

例2

例2、根据下面的路径填写访问(302模式有优先权)

本地:/本地测试/本地4
本地:/本地测试/本地3
本地:/本地测试/本地2
本地:/本地测试/本地1

1，一个视频 1 2 3 4 都有的话每次访问的是 4
- 如果1 3 4 使用的本地代理，2 使用的302，优先调用 2
2，一个视频 2 4 有那么每次访问的都是4
- 如果 4 使用的本地代理，2 使用的302，优先调用 2

例3

例3、根据下面的路径填写访问(302模式有优先权)

当然了不限于只有2个文件夹，根据个人需求来写即可

本地测试:/本地1/video
本地测试:/本地2/video
测试其他:/测试3/images
测试其他:/测试4/video/电视

本地1 本地2 合并在一起了
- 如果2 使用的本地代理，1 使用的302，优先调用 1
测试3 测试4 合并在一起了
- 如果3 使用的本地代理，4 使用的302，优先调用 4
以上两种情况会出现两个不同的文件夹来展示，会如下展示，不会互相干扰

alias

使用的下载方式

添加 别名-alias 时 Web代理 和 Webdav策略 默认不修改的情况下 Paths路径填写的存储路径可以 302，本地代理，下载代理URL，三种模式混合播放可以进行混合播放

如果你勾选了Web代理 ，Paths路径填写的存储如果有302模式播放的到时候都会进行中转(本地代理模式)播放，变成代理模式，Webdav策略如果也进行了改动也会进行变化

当然，是否选择更换模式您自己进选择

如果你不知道你添加的云盘是什么方式怎么办?

可以前往文档的相对应的文档最底部查看，有一份流程图说明
- 如果有302的就是默认使用302方式，如果只有本地代理和下载代理URL默认的就是使用本地代理，前提是你没有进行手动选择
可以前往添加存储时进行查看，选择对应的存储进行查看，例如我们查看一下阿里云和115分别是什么方式
- 从下图中看到，阿里云盘有 web代理选择，webdav策略默认是302，可以判断出阿里云盘默认使用的是302方式
- 从下图中看到，115网盘没有 web代理选择，webdav策略默认是本地代理，可以判断出115网盘默认使用的是本地代理方式

其他说明

如果你是使用的Windows，会出现如下情况，有大小写不同的文件夹也会进行二次生成
例如本地1，本地2 分别有 video 小写的v ，文件夹 OneDrive 有一个大写的 V Video 文件夹
然后会生成一个小写的 video文件夹里面只有 本地1，本地2 两个的文件夹所合并的文件
同时大写的 Video 里面会集合三个文件夹的文件

这是因为Windows 大小写不敏感，video和Video会被认为是同一个文件夹,你换成Linux或者Mac就不会有这个问题了

暂时不支持别名进行负载均衡（后期若支持了这里会进行文档修改，如果没有修改就是还不支持）

代理range

需要先启用 Web代理 或者 Webdav本地代理 才会生效

目前仅适用于：别名、中国移动云盘、AList V3
- 具体功能说明：https://github.com/alist-org/alist/pull/6496#issue-2309839607

同名保护

^>v3.34.0现在别名支持 删除、重命名两个操作，默认开启

别名中可能会出现文件名一样的文件，对于文件夹名一致的文件夹，在同名保护开启状态下无法删除或者重命名

同名保护使用举例子

我们分别将 a和b两个文件夹填写到别名选项中

a/          b/                  alias
a/1.png     b/1.png             alias/1.png
a/2.mp3     b/2.mp3             alias/2.mp3
a/3.mp4     b/3.mp4     ---->   alias/3.mp4
a/4.mkv     b/4.mkv     ---->   alias/4.mkv
a/5.bin     b/6.css             alias/5.bin ---> 根据规则别名目录靠前的，不同文件夹中不同名的文件靠前
                                alias/6.css

如果我们在 同名保护 开启状态下把同名文件 1.png 进行重名名或者删除会提示如下信息在右上角

same-name files cannot be Rename / 同名文件无法重命名

same-name files cannot be Delete / 同名文件无法删除

如果我们把 同名保护 选项关闭，将 a/1.png改成 a/11.png 会变成如下展示

因为a/b两个文件夹都有一样的文件，重命名和下载一样优先下载填写时候靠前的文件夹，同理重名修改也是先修改靠前文件夹中的文件

a/          b/                  alias
a/1.png     b/1.png             alias/11.png
a/2.mp3     b/2.mp3             alias/2.mp3
a/3.mp4     b/3.mp4     ---->   alias/3.mp4
a/4.mkv     b/4.mkv     ---->   alias/4.mkv
a/5.bin     b/6.css             alias/5.bin
                                alias/1.png  ---> 因为b文件夹靠后，所以文件列表展示页靠后
                                alias/6.css

实在不懂可以自行本地测试一下再进行生产环境实装

下载并发、下载分片大小

需要开启代理才会生效，详情查看：https://github.com/AlistGo/alist/pull/7829