网盘聚合工具 AList 搭建示例

更新时间: 2025/9/22 | 总字数: 0 字 | 阅读时长: 0 分钟

前言

AList 是一个支持多种存储的文件列表程序，可以将多平台网盘及存储进行聚合展示、统一管理，特别适用于网络资源归纳分享，本文基于 Linux 系统，对 AList 的搭建进行展开说明，教程部分参考自 AList 官网：https://alist.nn.ci/zh 。

安装方式

AList 提供如下安装方式，本文仅针对 脚本安装 、Docker 安装 进行说明，其他方式可访问官网进行查看。

安装方式	说明
一键脚本 推荐	通过官方提供脚本进行快捷安装、更新、卸载等。上手难度比较低。
手动安装	下载执行文件手动运行及服务配置，相对来说较繁琐，建议使用脚本安装。
使用 Docker 推荐	通过 Docker 进行快速安装启动，前提是需要对 Docker 有一定的了解。
桌面版	客户端安装，需要收费。
PaaS	使用 Koyeb、Render、Heroku 等云服务器部署。
从源码运行	通过源码进行编译，技术门槛较高，需修改源码可使用此种方式。

脚本安装方式 推荐

此方式安装比较方便，无需过多配置，对于新手比较友好。

安装

输入如下命令开始安装，耐心等待即可。

curl -fsSL "https://alist.nn.ci/v3.sh" | bash -s install

安装完成会自动启动服务，其他服务操作命令如下：

查看状态：systemctl status alist
启动服务：systemctl start alist
重启服务：systemctl restart alist
停止服务：systemctl stop alist

更新

curl -fsSL "https://alist.nn.ci/v3.sh" | bash -s update

卸载

curl -fsSL "https://alist.nn.ci/v3.sh" | bash -s uninstall

自定义路径

提示

默认安装在 /opt/alist 路径下，若需要自定义安装路径，脚本命令指定（绝对路径）参数即可，以安装到 /root 为例，如下：

# 安装
curl -fsSL "https://alist.nn.ci/v3.sh" | bash -s install /root

# 更新
curl -fsSL "https://alist.nn.ci/v3.sh" | bash -s update /root

# 卸载
curl -fsSL "https://alist.nn.ci/v3.sh" | bash -s uninstall /root

获取密码

需要进入脚本安装 AList 的目录文件夹内执行如下命令：

低于 v3.25.0 版本

./alist admin

高于 v3.25.0 版本

随机生成一个密码

./alist admin random

手动设置一个密码，NEW_PASSWORD 为需要设置的密码，替换即可。

./alist admin set NEW_PASSWORD

Docker 安装方式

docker-cli 安装

docker run -d \
       --restart=unless-stopped \
       -v /etc/alist:/opt/alist/data \
       -p 5244:5244 \
       -e PUID=0 \
       -e PGID=0 \
       -e UMASK=022 \
       --name="alist" \
       xhofe/alist:latest

docker-compose 安装

version: '3.3'
services:
    alist:
        image: 'xhofe/alist:latest'
        container_name: alist
        volumes:
            - '/etc/alist:/opt/alist/data'
        ports:
            - '5244:5244'
        environment:
            - PUID=0
            - PGID=0
            - UMASK=022
        restart: unless-stopped

更多用法可参考：

• AList 官方文档

• 安安稳稳

常见问题