前言:什么是Alist?
Alist是一款功能强大的开源文件共享程序,有桌面版(收费)和命令行版(免费,本文主要介绍),支持Windows/Linux跨平台安装,以网页形式呈现,占用小,内置多种文件在线查看器,支持WebDav,还可以 将市面上几乎所有的网盘系统(百度,阿里,腾讯等) 作为存储源。它的官网是:https://alist.nn.ci/
一、Alist的安装
- Windows环境下:
Windows环境的配置较为简单,官方Github已经打包好exe。
打开官方Releases界面 (国内无法打开可以在链接网址的github.com前面加上kk切换国内镜像) ,下滑找到最新版本的Assets,如图:
找到对应系统文件下载(例如我这里是 alist-windows-amd64.zip
找不到Windows的文件?上面就是一个Very Good的例子:点击Show all xx assets,展开所有文件!!!如图:
就会出现完整列表啦
国内用户下载慢?右键文件下载链接,复制链接,在复制的链接之前加上https://hub.gitmirror.com/ 就可以啦!如图:
下载速度(我是300M Wifi)
注:使用kkgithub访问的复制链接时一定!要!改回github.com!不然代理不了!
- Linux环境下
如果你不作,官方提供了一键安装脚本,只需要如此操作:
安装:sudo curl -fsSL "https://alist.nn.ci/v3.sh" | bash -s install
更新:sudo curl -fsSL "https://alist.nn.ci/v3.sh" | bash -s update
卸载:sudo curl -fsSL "https://alist.nn.ci/v3.sh" | bash -s uninstall
默认将安装在系统的 /opt/alist
路径。如果你想更改,将自定义路径作为一键安装脚本的第二个参数传入(以/root为例):
安装:sudo curl -fsSL "https://alist.nn.ci/v3.sh" | bash -s install /root
更新:sudo curl -fsSL "https://alist.nn.ci/v3.sh" | bash -s update /root
卸载:sudo curl -fsSL "https://alist.nn.ci/v3.sh" | bash -s uninstall /root
alist将作为服务安装,可以使用systemctl操作:
- 启动:
systemctl start alist
- 关闭:
systemctl stop alist
- 状态:
systemctl status alist
- 重启:
systemctl restart alist
二、第一次启动
进入alist所在目录,输入:alist server
,如图:
出现“
start HTTP server @ 0.0.0.0:5244
” 就启动成功了。
设置/获取admin密码
其实这个步骤也可以不用,但前提是你得愿意每次都用默认的随机密码……
第一次启动后会输出初始密码(如下图红框),如果不想改的一定!记住!只输出一次!
如果你不想用这个东西(反正我不想

Ctrl+C
终止服务器,再输入:
./alist admin set 新密码
看到如图输出即可。
忘记密码也可以使用此命令重设。
三、配置
打开用浏览器打开本机5244端口的页面,如图:
输入账号admin,密码使用刚才设置的密码,点击“登录”,进入主页:
这个初始主页是没有问题的。
- 添加存储
Alist的核心功能是存储。接下来我介绍几款常见网盘的添加方法:
先点击主页页脚的“管理”
进入管理界面后,依次点击存储->添加,如图
在“驱动”中选择自己想要添加的网盘。
常用:
- 本地存储
使用服务器本地磁盘存储。
参数解析:“挂载路径”在Alist中的虚拟路径,在添加多个存储时,该值必须唯一。
下一页:
根文件夹路径:要从哪里读取文件进行展示。
2、蓝奏云
提示
蓝奏网盘挂载有三种模式(类型),分别是 账户,cookie 和 链接
- 账户:可以显示自己网盘所有文件,只需要填写帐号密码,会自动帮你刷新cookie
- cookie:可以显示自己网盘所有文件,但是需要提供网盘的cookie
- 链接:只能显示链接里面的内容(不需要提供cookie就可以挂载)
推荐使用账户的方式挂载:
- cookie模式需要手动更换cookie
- 用链接模式总是会抽风不知道怎么回事
根文件夹ID
蓝奏云盘根目录ID,默认为-1
,如果使用链接
类型挂载根文件夹ID请看[填写说明]的第三条
- 其他文件夹ID
- 两种获取方式(看下图即可)
账户
只需要填写自己的蓝奏云帐号密码
Cookie
登录自己的 蓝奏云盘 open in new window 账号,然后F12打开开发者模式,就能找到 Cookie
,没有具体的,例如图片中左侧的随便点一个然后有右图蓝色部分的 Cookie
即可.
分享链接和分享密码
- 分享链接:在蓝奏云盘内随便生成一个分享链接
- 小提示 :链接里面的 lanzouX,最后这个默认的 X内容有时候有些地区打不开,可以自己更换一下试试看比如换成 i,x,u,t 等等等反正好多自己试试看就行.
- 分享密码 :链接的密码
修复文件信息
需要 WebDav 服务的,需要打开它
错误信息
使用Cookie类型或者账户类型添加提示not find file page param
错误是因为蓝奏云更换了域名
- 解决方案:建议使用账户类型添加
- 把分享链接改成
https://wwop.lanzoul.com
保存即可,如果还是不可以,右下角刷新一下。 - 后续蓝奏可能还会更改。
- 把分享链接改成
填写说明
- 账户模式:类型选择
账户
,填写账户
和密码
选项,以及根文件夹ID
(选填,默认为根目录全部文件) - Cookie模式:类型选择
Cookie
,填写Cookie
,以及根文件夹ID
(选填,默认为根目录全部文件) - 链接模式:类型选择
链接
,填写分享链接
和根文件夹ID
以及分享密码(如果有密码)
两个选项就可以
- 分享链接是
https://xxx.lanzou.com/aaabbbcccopen in new window
这种格式的
- 在
分享链接
填写:https://xxx.lanzou.comopen in new window - 在
根文件夹ID
填写:aaabbbccc - 在
分享密码
填写:有密码就写没有就不用写
默认使用的下载方式
百度网盘
提示
由于百度网盘 API 的限制,下载大于 20M 左右的文件需要携带 header:“User-Agent”:“pan.baidu.comopen in new window”,所以下载大于 20M 的文件时,需要设置请求头,例如使用 curl:
curl -L -X GET 'YOUR_LINK' -H 'User-Agent:pan.baidu.com'
或者使用本程序中的代理功能进行传输。
刷新令牌
点击这里open in new window 来获取刷新令牌。
根文件夹路径
要挂载的根文件夹,默认为/
- 单独挂载某文件夹,按照下面格式,
/
是根目录,想挂载那个目录就延伸到那个目录就可以- /文件夹-A/……/文件夹-x
##自定义破解ua
使用【本地代理 & Crack API】时候使用的UA open in new window
##Download API
- official: 官方接口,很稳定,但是文件比较大,需要修改UA,速度慢 (SVIP速度快)
- crack: 非官方接口,现在也需要修改UA且部分文件可能不限速,但是会不稳定(不保证100%可用性)需要使用大于
3.19.0
的版本- 需要将UA改成
netdisk
,修改方法参考下方添加-user-agent-使用示例 - 或者开启Web代理(需要大宽带才能带的动)
- WebDav播放不需要修改UA,可以直接302播放
- 仅限于播放/下载
视频(只测试了mp4格式其他格式未测试)
,其他类型文件的会出现下方提示 - 如果出现下面的提示请勿担心,这不是错误不是Bug,这只是限制,请勿填写
issue
上报.
- 需要将UA改成
{
error_code: 31119,
error_msg: "hit black userlist , hit illeage dlna",
request_id: 541111111111111140
}
添加 “User-Agent” 使用示例
如果你不会设置 “User-Agent” 请看这里
以下方法仅限于有百度超级会员用户使用
再次提示 以下方法仅限于有百度超级会员用户使用
有会员改完 "User-Agent"
才会有用(选择官方和302)
如果不改 "User-Agent"
,可以开启 Web代理,缺点是需要你搭建Alist的机器中转,也就是说你需要大宽带帮你中转
网页插件
- 使用浏览器插件修改的好处是 可以直接在线播放,当然了下载也是可以的。
例1:实在不会的可以看看一个Web网页端的例子: https://www.bilibili.com/video/BV1UA4y1X7J8open in new window
例2:另一款插件方法涵盖360,Chrome,Edge: https://youtu.be/PP6b0WSzYMcopen in new window
不过没有SVIP还是限速。。。
更多存储,请转官方文档查看哦
以下是效果图:
是的,音乐在同目录有lrc文件时是可以显示歌词的
视频(由于我下载时下载了弹幕Alist又内置B站播放器所以会显示弹幕)
- 外链
Alist中的一切文件都可以外链,只需要点击文件的"download"页签即可:
点击“复制链接”就可以导出外链。