常见问题

安稳2023年1月1日大约 19 分钟使用指南AList入门使用教程使用AList的常见问题

本页面纪录一些AList中经常看到的一些问题..

1. 刚搭建好AList打开进去就这样是怎么回事？

这是刚搭建好还没挂载网盘，你去下面登录然后去后台添加一个账号挂载一个网盘就行

2. 怎么刷新应用？为什么我网盘上传后Alist没更新?

登录管理员账号的前提下，右下角就能刷新了.

如果在首页刷新不行，去你有变动的哪个文件夹里面刷新

3. 怎么打开 AList 提示 System error: TypeError:n.replaceAll is not a function？

现在安装的应该没了已经默认添加进去了帮你，如果你的还提示这样的那么去后台，自定义头部里面添加如下代码即可

<!--Alist V3建议添加的，已经默认添加了，如果你的没有建议加上-->
<script src="https://polyfill.io/v3/polyfill.min.js?features=String.prototype.replaceAll"></script>

这个 polyfill.min.js 如果觉的加载慢，可以试试这个点击这里查看如何更换

4. 怎么首次打开强制默认白天或者夜间模式 ❎

~~不是很好用现在，不推荐使用，可以尝尝怎么样不建议实装~~

<script>window.onload=function(){localStorage.setItem("hope-ui-color-mode","light")}</script>

<script>window.onload=function(){localStorage.setItem("hope-ui-color-mode","dark")}</script>

5. 密码忘记了怎么办？

安装后查看密码

Windows： alist.exe admin
Linux : ./alist admin
docker : docker exec -it alist ./alist admin

注：Windows，Linux，要到文件的的目录里面去执行喔~

比如下图的，AList执行程序在V3这个文件夹，我们就要进入V3这个文件夹在执行命令
Linux：一键脚本安装的在 /opt/alist
- 我们就输入 cd /opt/alist,进入AList文件夹，
- 我们再输入查看密码命令 /alist admin
- 如果是自定义就自己 cd 进入你安装的文件夹里面去就行，不多说了

6. 挂载的网盘提示(Client. Timeout exceeded while awating headers)

比如下图情况?当然了不止阿里这样，前面的域名会变化，后面的 **(Client. Timeout exceeded while awating headers) ，**不会变化出现如下情况 因为网络问题，连接超时导致的

7. 挂载不了谷歌网盘

如果你是国内的服务器，或者更直白的说，你能不借助任何代理连接谷歌吗？

国外服务器能挂，国内的不行。

8. 两个不同的上传有什么不同

1️⃣ stream直接把文件二进制内容放进body中，这样后端可以使用很少的内存，但是浏览器可能会限制大小因为要一次性把文件读进内存。

2️⃣ form是把文件包裹成formdata上传，后端使用的内存会多一些，但是不限制大小。

9. 那些网盘是强制中转(代理)的?

夸克，迅雷普通版，115，或者看文档添加存储时底部的流程图

10. 怎么没有了推送到Aria2下载按钮？

需要先打开复选框，
然后选择好文件，
选好了下面有个下载按钮，
里面有推送到 Aria2 ~
- 前提是要配置好 Aria2 喔~

11. 怎么批量复制链接?

打开右下角的复选框，
然后去左侧选择好文件，
下面有个复制链接的选项，
具体需要哪个你自己选择即可
- 三个选项分别是干嘛的看你自己的需求自己选择吧我这里就不多赘述了

12. 添加挂载保存不了提示两个情况：

一：x_storages.mount_path

因为挂载路径是唯一的，你写的挂载路径和你现在已经挂载的路径重复了。

二：'MountPath' failed on the 'required' tag

你的挂载路径没写，填写一下就行。

13. 如何设置夜间和白天不同的logo

进入后台 ——> 样式 ——> 图标，自己设置一行一个，第一行是白天的，第二行是夜间的。

14. 登录有效期那么短就失效了

现在登录状态默认登录有效期48小时，觉的短的可以自己改，具体最长多少没试过.

位置在你Alist程序同级 data文件夹 里面的 config.json 里面修改

15. 点视频下面的potplayer播放器报错

尝试更新 Potplayer 更新成最新版的试试看.

网盘下载地址：Potplayer | 云盘下载

或者自己去官网：Global Potplayer，官网64位直链下载，官网32位直链下载

16. RaiDrive 复制粘贴百度的失败

因为百度大文件(大于20MB)是需要 User-Agent 这个请求头的的，RaiDrive没有添加这个请求头的位置，所以就别想从 RaiDrive 复制粘贴文件出来了.

百度如何挂载看这里：（视频里的AList虽然是V2版本，但是不影响）

https://www.bilibili.com/video/BV1UA4y1X7J8
另一款插件方法涵盖360，Chrome，Edge：https://youtu.be/PP6b0WSzYMc
- 当然了第一个视频里面的插件也可以使用第二个视频里面的方法安装使用，推荐使用第一个视频的插件来修改

不会安装插件？看这个BV1K34y1v7Uw

17. 一大批因为因为网络问题

TLS handshake timeout?
read: connection reset by peer?
dns lookup failed?
connect: connection refused
Client.Timeout exceeded while awaiting headers?

以上网络问题自行排查解决~

18. 添加天翼189时：设备 ID 不存在，需要二次设备验证或者验证码

可能是触发了风控。更改密码后，再次添加即可

建议添加的时候选择天翼云盘客户端，能不用天翼云盘就不用天翼云盘

出现验证码怎么解决?

解决办法1：

把上图中出现的验证码点击编辑填到验证码那一栏然后点击保存

解决办法2：

点击编辑最后哪个 不使用OCR勾选（看上图最后哪个选项勾选上），然后保存即可

天翼云盘和天翼云盘客户端有什么区别？

区别就在于
- 天翼云盘：用的手机端API，可能会需要OCR验证码? 然后你可能链接不上
- 天翼云盘客户端：是用的天翼云盘PC端的API~

19. 为什么不能网页看视频

需要浏览器支持的编码
一般浏览器不支持 H.265 编码视频
一般浏览器不支持 AC3 编码的音频

特别是对于 Safari：

对于跨域媒体，content-type 必须是媒体类型，而不是通用的 application/octet-stream。所以如果直链返回的 content-type 是 application/octet-stream，那么 Safari 就无法播放了。（PS：为什么 AliyunDrive 可以在 Safari 中播放？因为官网的视频播放不是使用的下载链接，是经过 AliyunDrive 转码后的）

综上大家要啥看视频的话建议调用视频下方相对应的播放器来看吧~~

20. 怎么给直链添加过期时间

直链链接的过期时间，以小时为单位。如果为 0，则不会过期。默认值为 0。

不过只有加了密码的路径的直链才会有过期时间，否则不会过期。因为过期时间是加到sign查询参数中的，没有加密码的路径是不会检查sign的，如何加密码下面也写了。

加密的话，如果你不勾选后面的应用到子文件夹只会加密当前路径里面的文件，勾选了应用到子文件夹才会加密到这个下面的二级文件夹以及多级文件夹里面的文件.

如何加密：点击查看

21. 怎么挂载SMB？

下面这个链接可能对你有帮助~你试试看呢：https://github.com/AlistGo/alist/discussions/2215

22. AList如何让网盘显示文件夹容量?

目前我知道的只有 OneDrive 网盘支持显示文件夹文件容量...别的不知道..没办法人工干预显示

具体怎么搞不知道，建议去问相对应的网盘为什么不支持显示~

23. 如何禁止游客访问？

方法1：

直接在用户里面将 guest 启用关闭

方法2：

在元信息把不想让游客看到的隐藏了，加密码。

方法3：

去用户名里面把 guest 这个游客账户里面基本路径给他选择到一个空文件夹里面去（随便一个都行）

24. AList v3版本如何备份？

方法1-内置

使用AList后台的内置 备份/恢复选项

备份：进行AList数据进行备份（不包含索引）
恢复：恢复之前备份文件
覆盖：恢复时选择覆盖会将用户信息进行覆盖
加密：填写加密密码导出时会将信息进行加密，导入时也需要先输入加密密码再点击恢复^{3.40.0_新增}

方法2-sqlite3

直接将AList目录下的 data/data.db数据库进行备份，等到了新环境直接进行替换即可(包含索引数据)

现在高版本如果有data.db-shm和data.db-wal这两个文件也要一起进行备份，恢复时也是一起替换
建议停止运行AList再进行备份，这样data.db-shm和data.db-wal这两个文件会和data.db合并在一起

方法3-其他数据库

其他，如果你使用了 MySQL，Postgres 等非sqlite数据库，请自行解决(包含索引数据)

以上三个自己选一个

还有一个就是我在用的我把数据库换成了MySQL，每天(每周)自动备份数据库也可以.

25. 元信息里面的隐藏正则表达式怎么写?

粗略的看看吧，写的可能不是很明白，如果不太懂，自己去写一下保存去看看效果大概应纳就能懂了..

如果你想使用正则表达式，用法如下：
- ^** 匹配开始位置 $ 匹配结束位置：

^index ——> 隐藏以 index 开头的
ipa$ ——> 隐藏以 ipa 结尾的
[^\w] ——> 隐藏全部汉字开头的文件和文件夹
[^\w] ——> 隐藏全部非汉字开头的文件和文件夹，就是全部符合开头的[a-z A-Z 0-9]
[^A-Z] 表示一个区间，匹配所有大写字母，[^a-z] 表示所有小写字母。

比如你要隐藏mp4，jpg，png这几种类型
- mp4$ png$ jpg$，写进隐藏哪里，一行一个喔~

可以查看：点击查看详情

26. 如何禁止打包下载？

可以的去后台全局 ——> 打包下载关闭即可

27. 如何挂载某网盘的指定文件夹

在挂载的时候把你想挂载的根文件夹ID填到挂载信息里面就行，不同网盘的ID获取方式不一样自己看文档，文档没有的自己试验一下文件夹的名字哩.

这里举例截图的天翼云盘，不过别的云盘也是这个知道每家网盘获取文件夹ID的方式不一样，详情看上一条.

28. polyfill.min.js 加载太慢怎么办？

第一个是默认的，自带的

第二个是阿里的，加速了应该比较快试试第二个吧

<script src="https://polyfill.io/v3/polyfill.min.js?features=String.prototype.replaceAll"></script>

<script src="https://polyfill.alicdn.com/v3/polyfill.min.js?features=String.prototype.replaceAll"></script>

29. 两个 Aria2 有什么不同

图1后台管理中设置的Aria2：用于离线下载，即给定链接和路径后会使用这里的aria2进行下载，完成后上传的路径对应的存储。这里的aria2需要是安装alist的机器可以访问的。
右侧哪个离线下载是前端界面的喔_{管理员才能用}

图2发送到Aria2即发送到右侧本地设置的aria2，一般用于本地下载，即下载选中的文件到自己的电脑。这里的aria2不需要安装alist的机器可以访问。
游客用户也能用~游客自己设置自己的就行和上面的完全不冲突

30. 输入错误密码次数过多

密码输入次数太多了，等几分钟重试吧，具体多少分钟现在还不晓得...后面如果知道了会更新

密码忘记怎么办：点击查看详情

31. 本机代理、使用代理URL、302重定向、Web代理这四个有什么不同

302 重定向：重定向到真实链接
- 例如你下载的是 pan.xx.cn/d/阿里云/图片.mp4 这个文件
- 等你点击下载后就变成 https://cn-beijing-data.alipan.net/oI2jtWhu 这个链接，参考下图
使用代理 URL：重定向到代理 URL
- 就是重定向到指定的下载链接来下载，具体下看下面的链接说明吧，一般用于谷歌等这种需要代理才能访问的网盘，当然了你要是想折腾可以在阿里云等这种也加上也不是不行
- Alist 下载代理 URL 说明
本机代理：直接通过本地中转返回数据（最佳兼容性）
- 就是中转本机，用本机(搭建Alist的机器)流量来中转，这个看你本机的宽带大不大，如果本机的宽带很大，那么你看视频下载东西就会很快，反之很慢.
  - 使用本机代理的例子，夸克，迅雷普通版，115....(强制中转代理)
Web代理
- 网页预览、下载和直接链接是否通过中转。
  - 也就是第三个选项的意思差不多，这个一般是用于在网页预览的时候。
    - 详情查看Alist文档说明：https://alist.nn.ci/zh/guide/drivers/common.html#web-代理

32. 怎么给游客上传权限?

元信息 ——> 添加路径 ——> 勾选写入即可，后面的 应用到子文件夹 我就不说了自己看着办.

左侧未打开游客上传权限，右侧打开了游客上传权限

33. 为什么无法打包下载?

与 PDF 预览相同，需要 HTTPS 和 CORS 支持，并且：

AList 使用浏览器的 stream API 来支持打包下载，所以需要浏览器支持。通常这个 API 会被新的浏览器支持，例如 Chrome、Firefox、Edge 等。
CORS 好像不能人为修改...如果不支持就是不能用了吧~

34. 123网盘 json: cannot unmarshal string into Go struct field TokenResp.code of type int

这个是123的api限制，请求稍微过快就会触发这个错误。

35. System error: SyntaxError: Invalid regular expression: /?/: Nothing to repeat

出现如下报错应该是插件冲突了导致的，比如油猴的或者脚本猫中的一个答题脚本导致的，具体的可以看下面标题

解决办法把油猴答题插件关闭：https://github.com/AlistGo/alist/discussions/2399

36. 如何添加设置 ".epub" 预览

📣3.7.x 版本及更高的版本已经支持 ".epub" 阅读，

但是需要自己手动添加(因为已经创建过数据库了不好给你覆盖会出错)

如果是第一次安装启动（3.7.x版本及更高的版本）不用手动添加

📣添加方式：后台 ——>设置——>预览——>Iframe 预览，写在PDF后面，

📣开头有个逗号 "," 英文的，具体怎么写可以参考下面的图片

/*下面的这个逗号也是哦，这个注释就不要复制了，从第二行开始复制*/
,
  "epub": {
    "EPUB.js":"/static/epub.js/viewer.html?url=$e_url"
  }

参考链接：https://github.com/AlistGo/alist-web/commit/6e6012d5918589bead414cb3f479421b5e911e66

添加方式

37. 如何添加 3D 模型预览/展示功能

📣此方式在任何版本都能用，可能如果预览 OneDrive 网盘需要 3.8.x版本

📣结尾的 $durl，是需要 V3.8.x 版本及更高版本才能用，

其他的版本是 $url (使用OneDrive会有问题，本地倒是可以,因为$url 预览不了OnedRIVE, 3.8.X才修复了)

📣添加方式：后台 ——>设置——>预览——>Iframe 预览，写在 epub 后面

/*下面的这个逗号也是哦，这个注释就不要复制了，从第二行开始复制*/
,
  "glb": {
    "3dviewer":"https://3dviewer.net/#model=$durl"
  }

参考连接¹：https://github.com/AlistGo/alist/issues/2788

参考链接²：https://github.com/AlistGo/alist/issues/2805

样式预览

38. Docker 更新 / 升级最新版

docker ps -a #查看容器(找Alist容器的ID)
docker stop ID #停止Alist运行,不然无法删除(这次Alist容器的ID是d429749a6e69，每一次安装都不一样自己看)
docker rm ID #删除Alist容器(数据还在只要你不手动删除)

输入安装命令

docker run -d --restart=always -v /etc/alist:/opt/alist/data -p 5244:5244 -e PUID=0 -e PGID=0 -e UMASK=022 --name="alist" xhofe/alist:latest

更新好了去看看吧..就这么简单

39. RaiDrive挂载百度网盘，可以下载文件，不能上传文件。往挂载目录丢文件提示“提示“你需要权限来执行此操作”。这个怎么解决？

Raidrive 是因为上传文件会预先创建一个空文件而百度网盘不允许创建空文件

AListv2可以成功是因为v2会忽略空文件上传

40. 为什么 Terabox 挂载成功了但是不显示内容？

因为 Terabox 限制IP，如果你是本机非海外IP访问，是无法访问的，自然不会显示内容。

（可以用海外的机器，如果非得用本机(或者国内的机器)搭建，哪你自己想办法让Alist吃到proxy就可以）

比如我用的是v2rayN，启动AList的客户端是 Git Bash

export https_proxy=http://127.0.0.1:10809 http_proxy=http://127.0.0.1:10809 all_proxy=socks5://127.0.0.1:10808

如果是 Clash

export https_proxy=http://127.0.0.1:7890 http_proxy=http://127.0.0.1:7890 all_proxy=socks5://127.0.0.1:7890

示例

41. AList如何使用/吃到代理/proxy

以下配置方式均为 Windows方式，其他的自行解决

Linux Docker 或者服务器，以及其他(树莓派,Openwrt,Termux,NAS等)自行解决（我不会）

CMD

点击查看全部代码配置

根据：https://github.com/AlistGo/alist/discussions/4363

先新建一个不用CMD黑窗口就能运行的脚本，ALL.vbs，代码如下

Dim ws
Set ws = Wscript.CreateObject("Wscript.Shell")
ws.run "AList-proxy.bat",vbhide
Wscript.quit

然后新建配置proxy的脚本，并且在脚本里面写一个可以启动AList的脚本 AList-proxy.bat , 代码如下

set http_proxy=http://127.0.0.1:10809
set https_proxy=http://127.0.0.1:10809
set no_proxy=localhost,127.0.0.1,example.com
start Alist-Start.vbs

然后配置正常启动AList程序的脚本 Alist-Start.vbs , 代码如下

Dim ws
Set ws = Wscript.CreateObject("Wscript.Shell")
ws.run "alist.exe server",vbhide
Wscript.quit

最后一个是停止运行AList的脚本 AList-Stop.vbs , 代码如下

Dim ws
Set ws = Wscript.CreateObject("Wscript.Shell")
ws.run "taskkill /f /im alist.exe",0
Wscript.quit

四个脚本都创建^(下载)好后，我们如果需要让AList使用代理，那么我们就双击 ALL.vbs 直接启用就行

提示

如果你不需要让AList用到代理可以直接启动 Alist-Start.vbs 脚本即可正常启动，停止方法依然是使用 AList-Stop.vbs

成品脚本打包下载

Git Bash

使用 Git Bash 和 Windows 配置（下图就是方法）

比如我用的是v2rayN，启动AList的客户端是 Git Bash

export https_proxy=http://127.0.0.1:10809 http_proxy=http://127.0.0.1:10809 all_proxy=socks5://127.0.0.1:10808

如果是 Clash

export https_proxy=http://127.0.0.1:7890 http_proxy=http://127.0.0.1:7890 all_proxy=socks5://127.0.0.1:7890

42. 打开PDF文档以及打包下载长时间转动无反应

可能是没有打开Https，还有一种情况，耽搁了一些人大量的时间，就是你的电脑装有IDM，或者IDM类似的浏览器下载托管软件，因为fetch会被IDM软件拦截，所以PDF文件将无法加载，你可能会收到如下报错：

PDF.js v2.12.305 (build: d3e1d7090)
信息：Failed to fetch

解决方案其实很简单，你可以在IDM等软件中设置取消在本站点自动下载，~~也可以直接删除IDM等软件。。。bushi~~ IDM里面自己试试看吧~

43. 现在文件后面多了个 sign 的参数是干嘛的？

加密了为了账号安全一些，查看详情可以AList 全局设置

44. lib64/libc.so.6: version `GLIBC_2.28' not found (required by ./alist)或者 accept: function not implemented

考虑使用 musl 版本作为替代，因为在您的平台上的 glibc 版本太低

45. 登陆时要求输入OTP代码，请问是什么原因?

你是不是在登录别人的账号？如果是自己的请输入2FA(两步验证)验证码

什么？不知道验证码？AList 去换取消2FA

46. 使用 sqlite3 发现 data 文件夹里面出现 data.db-shm、data.db-wal 两个多的文件

具体的你可以查看这里：https://stackoverflow.com/questions/7778723/what-are-the-db-shm-and-db-wal-extensions-in-sqlite-databases

47. 添加文件上传时，有一个“添加为任务“的选项，是做什么的?

勾选后上传到服务器(搭建AList的机器)，再由服务器上传时到网盘时后台似乎能看到（好像是这样的）
未勾选不会看到，具体的大家可以看下图应该能看出什么问题.

连续登录输入6次密码错误就会锁定，重启Alist即可重置。

49. 添加阿里云盘(分享)时提示提示Post "https://auth.aliyundrive.com/v2/account/token": net/http: TLS handshake timeout

原因：VPS在中国大陆境外，且启用了IPv6 解决方法：

方法一：在vps的hosts中添加以下三条并重启网络或者重启vps

47.94.245.197 api.aliyundrive.com
47.94.245.197 auth.aliyundrive.com
121.89.3.30 cn-beijing-data.aliyundrive.net

方法二：关闭并且禁用vps的IPv6

常见问题

49. 添加阿里云盘(分享)时提示 提示Post "https://auth.aliyundrive.com/v2/account/token": net/http: TLS handshake timeout

49. 添加阿里云盘(分享)时提示提示Post "https://auth.aliyundrive.com/v2/account/token": net/http: TLS handshake timeout