AList 一键脚本搭建教程

一、安装前准备

• 系统要求：Linux（amd64/arm64）、Windows、macOS、Docker 均支持
• AList 会默认安装在 /opt/alist 目录下

---

二、Linux 安装

正式版（推荐）

curl -fsSL "https://alistgo.com/v3.sh" -o v3.sh && bash v3.sh

测试版

curl -fsSL "https://alistgo.com/beta.sh" | bash -s install

自定义安装路径

如果你想安装到 /root 目录下，以正式版为例：

curl -fsSL "https://alistgo.com/v3.sh" -o v3.sh && bash v3.sh install /root

安装完成后脚本会输出你的 管理后台地址 和 初始密码，务必记下来。

---

三、Windows 安装

以 管理员身份 打开 PowerShell，执行：

iwr -useb "https://alistgo.com/alist-manager.ps1" | iex

脚本会弹出交互式菜单，包含：

1. 安装/更新 AList
2. 卸载 AList
3. 注册 Windows 系统服务（开机自启）
4. 启动/停止服务
5. 删除系统服务

默认安装路径为 C:\alist

---

四、Linux 服务管理

安装完成后以 systemd 管理服务：

操作	命令
启动	systemctl start alist
停止	systemctl stop alist
重启	systemctl restart alist
查看状态	systemctl status alist

也可以直接输入 alist 或 alist-manager 进入交互式管理面板。

---

五、密码管理

AList 3.25.0+ 版本密码采用加密 hash 存储，无法反向推算，忘记密码只能重置。

需要先 cd 进入 AList 安装目录，然后执行：

# 随机生成一个新密码
./alist admin random

# 手动设置指定密码
./alist admin set 你的新密码

Windows 下对应命令：

cd C:\alist
.\alist admin random
.\alist admin set 你的新密码

---

六、常见问题：「正在加载存储」进不去后台

挂载的网盘失效可能导致 AList 启动卡住，网页提示「获取设置失败：请稍后，正在加载存储」。

解决步骤：

1) 列出所有存储（先 cd 进安装目录）

./alist storage list

输出示例：

┌──────────────────────────────────────────────────────────────┐
│ ID    Driver            Mount Path                   Enabled │
│──────────────────────────────────────────────────────────────│
│ 1     AliyundriveOpen   /open                        true    │
│ 2     Local             /code                        true    │
└──────────────────────────────────────────────────────────────┘

2) 禁用有问题的存储

./alist storage disable /open

3) 重启 AList

systemctl restart alist

如果是 Docker 环境：

# 列出存储
docker exec -it alist ./alist storage list

# 禁用存储
docker exec -it alist ./alist storage disable /pikpak

# 重启容器
docker restart alist

---

七、Docker 安装（补充）

如果你更倾向用 Docker 部署：

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 exec -it alist ./alist admin random

---

安装完成后访问 http://你的IP:5244 即可进入管理后台，在「存储」页面添加网盘驱动即可开始使用。