AList网盘零基础教程

AList网盘是一个免费的由爱好者自发搭建和维护的云存储网站，不仅提供免费的账户注册和上传下载服务，同时也支持跨平台多种文件格式的在线阅读和预览，是一个非常方便和实用的云存储平台。本篇教程将会介绍AList网盘的基本配置、应用场景、快速上手、常用特性等信息。

介绍

AList网盘是一个由爱好者自发搭建和维护的云存储网站，提供免费的账户注册和上传下载服务，并且支持多种文件格式的在线阅读和预览，比如PDF、Office、视频、音乐等格式。AList网盘的特点是支持多种设备的访问和管理，非常方便和实用。

应用场景

AList网盘的应用场景很广，主要有以下几个方面：

• 移动办公：在使用移动设备时，我们可以通过AList网盘来访问和管理常用文档和资料等，使得工作更加便捷和高效。
• 个人存储：AList网盘提供了免费账户注册和上传下载服务，用户可以方便地存储和管理自己的数据，比如图片、音乐等文件。
• 社区共享：AList网盘支持用户进行文件分享和社交交流，用户可以上传分享自己的学习资料、音乐、电影等资源。

快速上手

AList网盘是一个强大的个人云存储解决方案，可以帮助你轻松管理和共享文件。使用Dk8s平台来部署AList网盘非常方便，就像是给你的云存储空间装上了一把“魔法钥匙”，让你的文件管理变得简单又高效。

下面是使用Dk8s快速搭建AList网盘服务器的步骤：

步骤1：安装Dk8s

首先，你需要在你的机器上安装Dk8s。具体的安装方法可以进入【首页】-【探索】-【快速上手】查阅官方文档。

步骤2：安装AList网盘

进入【首页】-【商店】搜索‘AList网盘’程序，点击安装。

步骤3：运行AList网盘

安装后，点击【我的】-【‘AList网盘’程序】-【更多】-【设置】，检查各项参数是否需要修改，

其中，‘本地目录’指示的值为共享文件夹的二级目录路径，一级目录需进入【首页】-【设置】-【存储】-‘存储位置’进行修改，所有程序仅支持存储于同一个一级目录中，二级目录默认隶属于一级目录。

设置参数检查后，如无需修改，即可点击运行，程序会自动拉取镜像并完成安装。

步骤4：访问AList网盘

现在，你可以进入【我的】-【‘AList网盘’程序】，点击打开程序，可在【设置】中修改默认密码。

挂载百度网盘

刷新令牌

点击 获取Token 来获取刷新Token。

根文件夹路径

要挂载的根文件夹，默认为/，与本地存储相同。

Download API

official: 官方接口，很稳定，但是文件比较大，需要修改UA，速度慢 (SVIP速度快) crack: 非官方接口，现在也需要修改UA且部分文件可能不限速，但是会不稳定（不保证100%可用性）需要使用大于3.19.0的版本

• 需要将UA改成netdisk，修改方法参考下方添加-user-agent-使用示例
• 或者开启Web代理（需要大宽带才能带的动）
• WebDav播放不需要修改UA，可以直接302播放
• 仅限于播放/下载 视频(只测试了mp4格式其他格式未测试)，其他类型文件的会出现下方提示
• 如果出现下面的提示请勿担心，这不是错误不是Bug，这只是限制，请勿填写issue上报.

{ error_code: 31119, error_msg: “hit black userlist , hit illeage dlna”, request_id: 541111111111111140 }

上传和下载文件

登录后，我们可以通过页面打开文件夹，点击”上传”按钮上传需要上传的文件，或者选择需要下载的文件后，点击“下载”按钮进行下载。

挂载阿里云盘 Open

阿里云盘 open，使用的是官方授权 API 开发。

注意事项

此工具的刷新令牌仅适用于阿里云盘开放平台的存储挂载方式。在AList挂载时，需要使用该工具提供的令牌，之前获取的方式不可用。目前仅限于Alist使用，并且同一IP在60分钟内最多请求10次，以避免滥用。请注意，保存/编辑操作会计算为一次请求，而查看文件、观看视频和下载不计入请求次数。请求次数和时间限制是动态变化的。

新增优化：仅在发现令牌过期时才会刷新令牌，更新、重启和编辑操作如果令牌仍然有效，则不会刷新。

对于在线播放视频，如果出现ExceedCapacityForbidden错误，表示容量超限制，需要扩容或删除不必要的文件来释放空间。请勿将阿里云盘进行公开分享，禁止帐号被多个IP访问。如果分享后帐号被冻结，后果自负。添加存储后，请及时设置元信息等措施，以防止被其他人或爬虫恶意访问或分享导致帐号被冻结。同样的注意事项也适用于其他云盘，以防止被冻结或封号。

关于阿里云open的OAuth验证API无法连接

由于原api https://api.nn.ci被sni阻断，导致国内无法连接的情况，故提供两个新的api供使用： https://api-cf.nn.ci (套了一层cloudflare) https://api.xhofe.top (辽宁多线， 由亚洲云赞助) 需要将aliyundrive_open后台配置中的Oauth令牌链接更换为 https://api-cf.nn.ci/alist/ali_open/token https://api.xhofe.top/alist/ali_open/token 查看详情：https://github.com/alist-org/alist/discussions/4572

刷新令牌

点击 https://alist.nn.ci/tool/aliyundrive/request 来获取刷新Token。 获取示意图 以下两种方式都可以获得

根文件夹ID

打开阿里云盘官网，点击进入要设置的文件夹时点击 URL 后面的字符串 如 https://www.aliyundrive.com/drive/folder/5fe01e1830601baf774e4827a9fb8fb2b5bf7940 这个文件夹的 file_id 即为 5fe01e1830601baf774e4827a9fb8fb2b5bf7940

客户端 ID，秘钥

对于正常用户来说，如果不需要填写特定的令牌，则可以将该字段留空，默认使用AList提供的令牌。如果用户已经申请了官方授权并获得了自己的令牌，也可以在此处填写自己的令牌进行使用。

秒传

• 在v3.22.1版本中，新增了一个功能，即秒传。在挂载时，需要启用秒传功能。要进行秒传，前提是阿里云盘已经存在相同的文件，否则将进行普通的上传操作。 秒传的计算是基于文件的SHA1值（应该没错），您无需自行计算，只需进行上传操作即可。上传完成后，系统会自动计算SHA1值并完成上传。
• 此功能使用了阿里云盘官方API提供的接口，请查看相关的秒传逻辑https://www.yuque.com/aliyundrive/zpfszx/ezlzok#y7lyH以获取更多详细信息。

移除方式

默认情况下，删除操作会将文件移动到回收站内，占用云盘空间。如果空间不足，您需要手动清理回收站。如果误删文件，请前往阿里云盘官网客户端进行找回和恢复操作。

• 回收站：在AList中，直接删除文件时，文件不会进入回收站，也不会占用云盘空间。但是请注意，一旦误删文件，无法找回。
• 删除：请务必保护好您的阿里云盘Open获取的Token，避免泄露。如果不小心泄露了Token，请立即解除授权，并重新扫码授权以获取新的刷新令牌。同时，解除授权后之前获取的所有令牌都会失效，以保护您的账号安全。

内部上传

如果您部署AList的服务器是阿里云北京地区的ECS，打开此开关可以提升文件上传速度。但请注意，如果您的服务器不符合要求（非北京地区的阿里云ECS），请不要打开此开关，否则可能会导致无法上传文件的问题。

• 这是因为阿里云盘在使用北京地区的对象存储，所以只有位于北京地区的阿里云ECS才能享受到上传速度的提升。
• 对于内部上传非北京地区的阿里云ECS，不建议打开此开关，因为它们无法直接享受到上传速度的提升。

其他说明

一、

AList 仅获取了 云盘用户 (名称 头像 ¹)，(访问文件权限 ²)和(写入文件权限 ³)，未获取手机号权限 详情可以通过以下两种方式查看：

• 扫码获取刷新令牌时的提示
• 打开 阿里云盘 APP --> 我的 -->右上角设置齿轮 --> 隐私设置 --> 授权管理 --> 点击 AList 进行查看 若不使用了可以随时手动解除权限

二、

默认使用的是阿里云盘自带播放器 - Aliyun Video Previewer 上传到云盘的视频，会经过转码服务转成 H.264 编码的视频流。（好处是 IOS 可以播放了…嗯 应该是这样）

• 新上传到云盘的视频，默认只预转码视频的前 30s。第一次播放时会触发完整的视频转码。转码后的视频会缓存，之后再次触发播放不需要重新转码。
• 不足 30s 的视频不会触发预转码，只会在第一次播放时开始转码。
• 实时转码需要一定时间。
• 画质分别为：LD|SD|HD|FHD|QHD

三、

• Q：阿里云盘Open怎么看不了 Office 全家桶类型的文件 A：因为阿里云盘未开放相关API故暂时无法查看（敬请期待）

四、

• Q：在线播放阿里云盘视频无法播放，提示：ExceedCapacityForbidden 错误
• A：用户容量超限，限制播放，需要扩容或者删除不必要的文件释放空间，在AList和阿里云盘官方APP分别如下图提示

五、

• Q：如何加载字幕？
• 阿里云盘open 需要使用 Aliyun Video Previewer播放器，然后暂时"只支持转码 mkv 封装的 srt、vtt 文本格式字幕" 目前只支持转码 eng、jpn、chi 三种语言，其他语言会丢失

默认使用的下载方式

上传和下载文件

登录后，我们可以通过页面打开文件夹，点击”上传”按钮上传需要上传的文件，或者选择需要下载的文件后，点击“下载”按钮进行下载。

常用特性

AList网盘提供了很多实用的功能：

• 跨平台同步：AList网盘支持跨设备访问和管理，同时也支持多种平台的同步，可以轻松同步你的数据。
• 在线阅读：AList网盘支持多种文件格式的在线阅读和预览，比如PDF、Office、视频、音乐等，让你可以直接在线阅读而不需要下载。
• 文件共享：AList网盘支持用户进行文件分享，可以方便地分享自己的学习资料、音乐、电影等资源。
• 安全性：AList网盘提供了数据加密、防盗链等安全措施，保护你的数据不被非法窃取和使用。

注意事项

在使用AList网盘时，我们需要注意以下几点：

• 版权问题：在上传和分享文件时，我们需要避免侵犯版权和非法分享的问题，避免产生法律和道德问题。
• 安全性：我们需要保护我们的账户和数据安全，避免因安全问题而造成数据丢失和泄露。
• 存储空间限制：在使用免费的AList账户时，存储空间会有限制，需要注意使用的文件大小和数量，避免超出限制。

原理概述

AList网盘的原理是在云服务器上部署网盘系统，用户可以通过浏览器或客户端进行上传、下载、在线预览等操作，利用云计算的方式来提供稳定、高效、便捷的云存储和数据管理服务。

结语

通过本篇教程的介绍，相信对于AList网盘的基本认识、应用场景和常用特性有了大致的了解。AList网盘是一个非常方便和实用的云存储平台，提供了许多实用功能和特性，方便我们进行文件存储和共享，同时我们也需要注意使用时的一些基本操作细节，保证我们可以安全高效地使用。