AList Docker 搭建与问题排查笔记

一、环境准备

推荐系统：

• Ubuntu 22.04
• Debian 12

更新系统：

apt update && apt upgrade -y

---

二、安装 Docker

安装：

curl -fsSL https://get.docker.com | bash

启动 Docker：

systemctl enable docker
systemctl start docker

检查版本：

docker --version

---

三、创建 AList 数据目录

mkdir -p /opt/alist

---

四、创建文件存储目录

推荐：

mkdir -p /home/storage

后续网盘文件都放这里。

推荐目录结构：

/home/storage
├── movie
├── anime
├── music
├── document
└── backup

创建：

mkdir -p /home/storage/{movie,anime,music,document,backup}

---

五、启动 AList（推荐方式）

docker run -d \
  --restart=always \
  -v /opt/alist:/opt/alist/data \
  -v /home/storage:/storage \
  -p 5244:5244 \
  --name="alist" \
  xhofe/alist:latest

---

六、Docker 目录映射理解（重点）

-v 宿主机目录:容器目录

例如：

-v /home/storage:/storage

含义：

| 宿主机 | Docker容器 | | ------------- | -------- | | /home/storage | /storage |

AList 只能看到：

/storage

看不到：

/home/storage

因为 AList 运行在 Docker 容器内部。

---

七、访问 AList

前台：

http://服务器IP:5244

后台：

http://服务器IP:5244/@manage

---

八、获取管理员密码

查看日志：

docker logs alist

会看到：

admin password: xxxxxx

默认账号：

admin

---

九、添加本机存储（关键配置）

进入：

存储 → 添加 → 本机存储

正确填写：

| 项目 | 内容 | | ----- | -------- | | 挂载路径 | / | | 根目录路径 | /storage |

---

十、常见错误与解决

---

1. Failed init storage: root folder /data not exists

原因：

容器内部不存在 /data

本质：

Docker 没有映射目录

解决：

重新启动容器并添加：

-v /home/storage:/storage

然后后台填写：

/storage

---

2. ls / 后看不到 data

原因：

/data 没映射进 Docker

验证：

进入容器：

docker exec -it alist sh

查看：

ls /

如果没有：

storage

说明目录未映射成功。

---

3. Key: 'Storage.MountPath' failed on required tag

原因：

挂载路径为空

解决：

填写：

挂载路径：/

---

十一、Docker 常用命令

---

查看运行容器

docker ps

---

查看日志

docker logs -f alist

---

重启容器

docker restart alist

---

停止容器

docker stop alist

---

删除容器

docker rm alist

---

进入容器

docker exec -it alist sh

进入后提示：

/ #

说明：

已经进入容器内部

退出：

exit

---

十二、Linux 权限说明

---

777 权限

含义：

所有用户都有全部权限

不够安全。

---

推荐目录权限

chmod -R 755 /home/storage

---

推荐文件权限

644

---

十三、安全建议

建议：

• 修改默认 admin 密码
• 开启 HTTPS
• 使用域名
• 不要开放默认后台
• 定期备份

---

十四、后续推荐玩法

推荐组合：

AList
+
Jellyfin
+
WireGuard
+
Cloudflare

可实现：

• 私人网盘
• 家庭影视库
• 手机自动备份
• 内网访问
• WebDAV
• 在线播放视频

---

十五、官方文档

AList 官网

AList Docker 文档

Docker 官网