🔗 项目地址

xiaoyaDev/xiaoya-alist 官方GitHub仓库

---

🧩 一、项目简介

Xiaoya-Alist 是基于 AList 深度优化的云盘聚合与媒体管理系统，主要用途：

• ☁️ 聚合多个云盘（阿里云盘 / 115 / PikPak 等）
• 🎬 搭建家庭影视库
• 📁 WebDAV 文件管理
• 📺 支持 TVBox / Emby / Jellyfin

👉 核心作用：把多个云盘变成一个统一的媒体中心

---

🖼 二、界面效果预览

📌 可以看到：

• 文件管理器式 UI
• 多云盘切换
• 类 NAS 网盘体验

---

🏗 三、系统架构

---

⚡ 四、一键安装（重点🔥）

🚀 官方一键脚本（推荐）

直接执行以下命令即可完成安装：

bash -c "$(curl -fsSL http://docker.xiaoya.pro/update_new.sh)"

---

📌 一键脚本做了什么？

• ✔ 自动安装 Docker（如未安装）
• ✔ 自动拉取 Xiaoya-Alist 镜像
• ✔ 自动创建容器
• ✔ 自动初始化配置
• ✔ 自动开放端口

👉 本质：全自动部署环境 + 服务启动

---

🐳 五、Docker 手动部署（备用方案）

如果你想完全控制，可以用手动方式：

---

1️⃣ 安装 Docker

curl -fsSL https://get.docker.com | sh
systemctl enable docker
systemctl start docker

---

2️⃣ 拉取镜像

docker pull xiaoyaliu/alist:hostmode

---

3️⃣ 创建数据目录

mkdir -p /opt/xiaoya/data

---

4️⃣ 启动容器

docker run -d \
  --name xiaoya \
  --restart=always \
  -p 5678:5678 \
  -v /opt/xiaoya/data:/data \
  xiaoyaliu/alist:hostmode

---

🌐 六、访问后台

浏览器打开：

http://你的服务器IP:5678

默认账号：

admin / admin

---

🖼 七、后台管理界面

📌 功能包括：

• 云盘挂载
• Token 配置
• WebDAV 开关
• 权限管理

---

🔐 八、云盘配置说明（核心步骤）

进入后台后，需要配置：

📦 支持类型

• 阿里云盘
• 115 网盘
• PikPak
• 本地存储

---

🔑 必填信息

• refresh_token
• access_token
• storage_id

👉 配置完成后即可看到云盘文件

---

🎬 九、影视扩展（可选）

如果你要做家庭影视库，可以加 Emby：

docker run -d \
  --name emby \
  -p 8096:8096 \
  -v /opt/emby:/config \
  -v /media:/media \
  emby/embyserver

访问：

http://IP:8096

---

🧩 十、整体系统架构图

📌 流程说明：

1. 云盘提供资源
2. Alist 做索引
3. WebDAV 输出服务
4. Emby 做播放
5. TV / 手机访问

---

📁 十一、目录结构

/opt/xiaoya/
 ├── data/      # 配置文件
 ├── cache/     # 缓存数据
 ├── token/     # 云盘授权
 ├── media/     # 媒体资源

---

⚠️ 十二、常见问题

❌ 1. 页面打不开

docker ps
netstat -tunlp | grep 5678

---

❌ 2. Token 失效

重新登录云盘，更新 refresh_token

---

❌ 3. 容器异常

docker logs xiaoya

---

🔄 十三、更新方法

docker pull xiaoyaliu/alist:hostmode
docker restart xiaoya

---

🎯 十四、总结

Xiaoya-Alist 是非常适合：

• 🎥 家庭影视库
• ☁️ 多云盘管理
• 📺 TVBox / Emby 播放系统

---

🚀 推荐方式

• 🟢 小白：一键脚本安装
• 🟡 进阶：Docker 手动部署
• 🔵 高级：+ Emby / Jellyfin 影视系统

---

🔗 再次附上项目地址

xiaoyaDev/xiaoya-alist GitHub仓库