文章目录

alist官网alist网站风格说明alist软件版本 安装和启动使用必看文档👺Alist生态alist for android版本启动alist网页 挂载云盘或本地存储本地存储挂载和分享👺挂载式共享方案选择案例:挂载阿里云盘open获取阿里云令牌主页检查挂载情况 常用页面以配置挂载列表管理配置页面 配置文件和目录👺FAQ可能遇到的错误检查服务重启前后alist的动作(自动挂载)alist token问题webDav链接和配置👺其他设备无法访问的问题👺 开机自动运行配置(守护进程)👺挂载到资源管理器(模拟本地磁盘分区)👺用户和权限管理😊

alist官网

alist网站风格说明

官网的各个页面大多是以目录列表的形式作为一级界面点击列表中的各个条目打开详情(一个问题是一般的可点击条目(文字)有下划线,或者显示蓝色字体,而alist官网就不按惯例来,需要将鼠标悬停在目录列表上才显示为可点击链接的风格,阅读的时候要注意一下)事实上手动安装 | AList文档 (nn.ci)包含了初次使用,配置,更新,以及加载的基本问题的解释;而从标题上看似乎仅仅介绍如何安装,没想到还包含了开机自启的配置的方法鉴于此,本文对alist的基本使用稍作整理

alist软件版本

对于windows,分为免费的命令行版本和收费的图形界面版本通常使用命令行版本就够用了,稍微懂命令行就可以操作,基础配置算简单安装 | AList文档 (nn.ci)

安装和启动使用必看文档👺

手动安装 | AList文档 (nn.ci)

介绍不同平台的安装和启动的方法

为可执行程序alist.exe配置Path变量或者取别名

执行alist server初始化

根据需要可以修改密码:alist admin set <new_password>

alist会默认在5244端口启动服务

Alist生态

Ecosystem | AList文档 (nn.ci)

alist for android版本

Releases (github.com)

FAQ:

如果您发现android端服务启动后,android设备自己可以访问挂载列表网页,但是其他同局域网内的设备却访问不了,这可能是手机上的代理软件干扰导致的另外,不恰当的修改配置文件,也可能导致其他设备无法访问服务端,手机端一般没有这个问题

加速下载:下载速度慢？教你如何高速下载 github release！

启动alist网页

浏览器中输入:http:\\localhost:5244登录刚才命令行给出的用户和账号(账号名admin,密码默认是随机密码,可以自行指定)启动配置页面,点击管理(manage),进入配置页面添加存储(storage)

挂载云盘或本地存储

alist可以不仅可以挂载网盘,还可以挂载本地存储

本地存储挂载和分享👺

本地存储 | AList文档 (nn.ci)挂载本地存储可以方便分享文件给其他人,特别是局域网内的人,在Alist管理页面中,创建一个shareUser用户,分发给需要共享的人或者自己使用,类似于windows下的共享文件夹或SMB服务被共享者(也可以是自己)可以用浏览器也可以用文件资源管理器挂载或着映射成驱动器来访问您共享的文件或者目录,也能够可控制被分享者对相关目录或文件的读写权限)WebDAV | AList文档 (nn.ci)

挂载式共享方案选择

对于windows,挂载为网络磁盘到资源管理器这一目的来说,使用共享文件夹会是更稳定的选择,即使alist也可以提供webdav挂载而通过网页访问的话,就不是共享文件夹可以比的,这种场景alist体验还可以,虽然打包下载没有那么友好,不过有其他类似的webdav软件比如chfs可以通过网页端下载文件夹(打包下载)

案例:挂载阿里云盘open

阿里云盘 Open | AList文档 (nn.ci)

获取阿里云令牌

Get Aliyundrive Refresh Token 登录阿里云盘账号,点击授权,可以获得令牌或者用手机扫码,授权获取令牌

主页检查挂载情况

本地alist服务器的主页为:http://localhost:5244/ 也可以点击配置页面的home(主页)跳转到挂载列表

常用页面

以配置挂载列表

Home | AList

管理配置页面

Profile | AList Manage

配置文件和目录👺

在命令行中,运行alist server会检查当前工作目录(由pwd命令返回的目录)是否存在配置文件(用户密码,已挂载过的网盘等)如果没有,则会在当前工作目录创建data目录并初始化创建必要的文件如果每次都在不同的目录上启动alist,会导致数据无法自动恢复,即每次需要登录alist都无法保持上一次的配置如果是通过创建快捷方式,通过快捷方式的方式启动,则可以确保每次alist家目录是一致的如果要在某个脚本中使用alist,建议使用cd <alist_home>,使得工作目录定位到alist家目录,然后根据需要可以返回或跳转到其他目录

FAQ可能遇到的错误

failed get objs: failed to list objs: InvalidParameter.ParentFileId:The input parameter parent_file_id is not valid. for cpp path domain parent_file_id is required

路径问题,考虑删除旧配置重新添加

检查服务重启前后alist的动作(自动挂载)

初次配置启动服务

PS C:\Users\cxxu\Desktop> alist serverINFO[2024-01-13 20:02:54] reading config file: data\config.jsonINFO[2024-01-13 20:02:54] load config from env with prefix: ALIST_INFO[2024-01-13 20:02:54] init logrus...WARN[2024-01-13 20:02:54] init tool aria2 failed: failed get aria2 version: Post "http://localhost:6800/jsonrpc": dial tcp [::1]:6800: connectex: No connection could be made because the target machine actively refused it.INFO[2024-01-13 20:02:54] init tool SimpleHttp success: okWARN[2024-01-13 20:02:54] init tool qBittorrent failed: Post "http://localhost:8080/api/v2/auth/login": dial tcp [::1]:8080: connectex: No connection could be made because the target machine actively refused it.INFO[2024-01-13 20:02:54] start HTTP server @ 0.0.0.0:5244INFO[2024-01-13 20:25:47] Shutdown server...INFO[2024-01-13 20:25:47] Server exit

成功挂在某个网盘后(以阿里云盘opne)为例,再次启动服务,输出:

PS C:\Users\cxxu\Desktop> alist serverINFO[2024-01-13 20:25:52] reading config file: data\config.jsonINFO[2024-01-13 20:25:52] load config from env with prefix: ALIST_INFO[2024-01-13 20:25:52] init logrus...WARN[2024-01-13 20:25:52] init tool aria2 failed: failed get aria2 version: Post "http://localhost:6800/jsonrpc": dial tcp [::1]:6800: connectex: No connection could be made because the target machine actively refused it.INFO[2024-01-13 20:25:52] init tool SimpleHttp success: okWARN[2024-01-13 20:25:52] init tool qBittorrent failed: Post "http://localhost:8080/api/v2/auth/login": dial tcp [::1]:8080: connectex: No connection could be made because the target machine actively refused it.INFO[2024-01-13 20:25:52] start HTTP server @ 0.0.0.0:5244INFO[2024-01-13 20:25:52] success load storage: [/AliyunDrive], driver: [AliyundriveOpen]

可以发现,alist可以自动将上次挂载的云盘重新挂载

alist token问题

PS 🕰️18:01:06 [C:\share] 🔋100% alist admin set 1212INFO[2024-02-10 18:01:13] reading config file: data\config.jsonINFO[2024-02-10 18:01:13] load config from env with prefix: ALIST_INFO[2024-02-10 18:01:13] init logrus...INFO[2024-02-10 18:01:13] admin user has been updated:INFO[2024-02-10 18:01:13] username: adminINFO[2024-02-10 18:01:13] password: 12345...ERRO[2024-02-10 18:01:13] [del_user_cache_online] error: that's not even a token

尝试关闭所有alist进程

用ps alist*检查是否有alist进程,如果有,则执行ps alist|stop,结束相关进程

重新设置admin密码

PS 🕰️18:01:13 [C:\share] 🔋100% alist admin set 1212INFO[2024-02-10 18:02:07] reading config file: data\config.jsonINFO[2024-02-10 18:02:07] load config from env with prefix: ALIST_INFO[2024-02-10 18:02:07] init logrus...INFO[2024-02-10 18:02:07] admin user has been updated:INFO[2024-02-10 18:02:07] username: adminINFO[2024-02-10 18:02:07] password: 1212WARN[2024-02-10 18:02:07] [del_user_cache_online] failed: Post "http://localhost:5244/api/admin/user/del_cache?username=admin": dial tcp [::1]:5244: connectex: No connection could be made because the target machine actively refused it.

抛出了一个WARN,可以打开浏览器,刷新alist管理网页,检查是否修改成功

webDav链接和配置👺

WebDAV | AList文档WebDav (nn.ci)

WebDAV | 获取已添加网盘的webdav链接配置 (nn.ci)WebDAV |挂载填写实例

其他设备无法访问的问题👺

通常保持默认配置不会出现这个问题,但是如果对配置文件做了不当修改,可能导致此类异常

以电脑端(windows为例),修改了config.json中的IP地址

配置文件路径

# [C:\exes\alist\data]PS> cat .\config.json

..."scheme": { "address": "0.0.0.0",#修改为127.0.0.1会导致其他设备无法访问 "http_port": 5244, "https_port": -1, "force_https": false, "cert_file": "", "key_file": "", "unix_file": "", "unix_file_perm": "" },...

开机自动运行配置(守护进程)👺

守护进程开机自启动 | AList文档 (nn.ci)windows配置开机自启动软件或脚本-CSDN博客

挂载到资源管理器(模拟本地磁盘分区)👺

windows@允许映射挂载http链接@挂载局域网http链接的webdav磁盘-CSDN博客 这涉及注册表修改 也可以考虑用第三方软件挂载,例如RailDrive,rclone等

用户和权限管理😊

在这个页面里配置和管理用户Users | AList Manage当您想要利用Alist提供的webdav服务分享文件给别人,或者自己的朋友,那么创建一个专门用来共享文件的用户是一个好主意我们对这个共享出去的用户配置权限,比如只允许他访问某个目录下的文件,更近一步可以限制对该目录下的文件的操作,比如删除和重命名等