AList 网盘聚合工具简介

AList是一款开源的网盘聚合管理工具，它能把各类网盘、云存储和本地文件整合在一个统一的界面中进行管理, 本文介绍相关内容。

简介

AList是一款支持多存储的文件列表程序，使用 Gin 和 Solidjs 开发。

特点

• 部署方便，开箱即用
• 文件预览（PDF、markdown、代码、纯文本……）
• 画廊模式下的图像预览
• 视频和音频预览，支持歌词和字幕
• Office 文档预览（docx、pptx、xlsx、…）
• README.md 预览渲染
• 文件永久链接复制和直接文件下载
• 黑暗模式
• 国际化
• 受保护的路由（密码保护和身份验证）
• WebDav (具体见 https://alistgo.com/zh/guide/webdav.html)
• Docker 部署
• Cloudflare workers 中转
• 文件/文件夹打包下载
• 网页上传(可以允许访客上传)，删除，新建文件夹，重命名，移动，复制
• 离线下载
• 跨存储复制文件
• 单线程下载/串流的多线程下载加速

相关链接

• Github : https://github.com/AlistGo/alist
• 中文文档: https://alistgo.com/zh/

支持列表

• 本地存储
• 阿里云盘
• OneDrive / Sharepoint（国际版, 世纪互联,de,us）
• 天翼云盘 (个人云, 家庭云)
• GoogleDrive
• 123云盘
• FTP / SFTP
• PikPak
• S3
• Seafile
• 又拍云对象存储
• WebDav(支持无API的OneDrive/SharePoint)
• Teambition（中国，国际）
• MediaFire
• 分秒帧
• ProtonDrive
• 和彩云 (个人云, 家庭云，共享群组)
• Yandex.Disk
• 百度网盘
• UC网盘
• 夸克网盘
• 迅雷网盘
• 蓝奏云
• 蓝奏云优享版
• 阿里云盘分享
• 谷歌相册
• Mega.nz
• 一刻相册
• SMB
• 115
• Cloudreve
• Dropbox
• 飞机盘
• 多吉云

安装方法

这里介绍 Docker 安装方法:

docker-compose.yml 文件配置

services:
  alist:
    restart: always
    volumes:
      - '/etc/alist:/opt/alist/data'
      - '/your_dir/data:/disk'
    ports:
      - '5244:5244'
      - '5245:5245'
    environment:
      - PUID=0
      - PGID=0
      - UMASK=022
      - TZ=UTC
    container_name: alist
    image: 'xhofe/alist:latest'

其中 '/your_dir/data:/disk' 用于将宿主机的路径映射进 docker 以便于后续映射本地存储

启动 docker:

docker-compose up -d

首次启动后需要在 docker logs 里查看初始密码:

docker logs alist

可以看到日志:

$ docker logs alist 
INFO[2026-01-26 06:58:41] reading config file: data/config.json        
INFO[2026-01-26 06:58:41] config file not exists, creating default config file 
INFO[2026-01-26 06:58:41] load config from env with prefix:            
INFO[2026-01-26 06:58:41] init logrus...                               
INFO[2026-01-26 06:58:41] Successfully created the admin user and the initial password is: xxxxxxx 

这里的 xxxxxxx 就是初始密码, 不太好记, 建议改掉

登录配置

访问: http://127.0.0.1:5244 可以进入登录界面

输入用户名 admin 密码 刚刚日志里看到的密码 进入系统.

进入存储, 添加网盘:

如果需要添加网盘服务可以参照官网文档: https://alistgo.com/zh/guide/drivers/

注意 该项目已在2024-2025年间被商业公司收购。社区和用户报告了以下几点风险：

• 权限与数据隐私：AList需要获取你网盘的访问令牌（Token）来工作，这个令牌理论上拥有读取你网盘文件的权限。项目被收购后，这些令牌的管理和数据流向存在不确定性。
• 存在“后门”争议：有用户发现在新版本的代码中添加了收集用户系统信息并上传至服务器的功能，引发了社区对“后门”的担忧。
• 网盘厂商限制：由于上述风险，部分网盘（如123网盘、115网盘）已暂停对AList的支持，未来可能会有更多网盘跟进。

建议优先使用本地存储, 我这里使用的就是.

设置挂载路径和根文件路径, 点击添加:

挂载路径为 alist 管理的路径, 可以随便起名字

根文件路径为容器内需要挂载的真实数据路径

回到主页可以测试是否成功:

如果看到刚刚挂载的目录并且可以正常浏览相关文件说明没有问题:

参考资料

• https://alistgo.com/zh/
• https://github.com/AlistGo/alist

文章链接：
https://www.zywvvd.com/notes/tools/alist-intr/alist-intr/