文章目录

    • alist官网
      • alist网站风格说明
      • alist软件版本
    • 安装和启动使用必看文档
      • alist for android版本
      • 启动alist网页
    • 典型用例@挂载阿里云盘open
        • 获取阿里云令牌
      • 主页检查挂载情况
    • 常用页面
      • 以配置挂载列表
      • 管理配置页面
    • 配置文件和目录
    • FAQ可能遇到的错误
      • 检查服务重启前后alist的动作(自动挂载)
      • alist token问题
      • webDav链接和配置
    • 开机自动运行配置(守护进程)
    • 挂载到资源管理器(模拟本地磁盘分区)
    • refs

alist官网

alist网站风格说明

  • 官网的各个页面大多是以目录列表的形式作为一级界面
  • 点击列表中的各个条目打开详情(一个问题是一般的可点击条目(文字)有下划线,或者显示蓝色字体,而alist官网就不按惯例来,需要将鼠标悬停在目录列表上才显示为可点击链接的风格,阅读的时候要注意一下)
  • 鉴于此,本文对alist的基本使用稍作整理

alist软件版本

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

安装和启动使用必看文档

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

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

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

  • 执行alist server初始化

  • 根据需要可以修改密码:alist admin set

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

alist for android版本

  • Releases (github.com)
  • 加速下载:下载速度慢？教你如何高速下载 github release！ – 知乎 (zhihu.com)

启动alist网页

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

典型用例@挂载阿里云盘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家目录,然后根据需要可以返回或跳转到其他目录

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 |挂载填写实例

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

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

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

  • windows@映射磁盘驱动器若干方法-CSDN博客
  • 也可以考虑用第三方软件挂载,例如RailDrive,rclone等

refs

  • Alist保姆级搭建教程_alist搭建教程-CSDN博客