如何在VPS上部署小雅媒体资源库？

项目	内容
部署方式	Docker容器化部署
核心组件	Alist网盘挂载系统
所需资源	VPS服务器、阿里云盘账号
主要功能	资源同步、媒体播放、文件管理

VPS部署小雅完整指南

想要在VPS上搭建个人媒体资源库？小雅（Xiaoya）通过Docker容器化技术，让你能够轻松挂载丰富的媒体资源到自己的Alist系统中。下面将详细介绍完整的部署流程。

主要部署方法

方法类型	适用场景	难度级别
一键脚本安装	新手用户、快速部署	简单
Docker命令部署	需要自定义配置	中等
Docker Compose部署	生产环境、多服务管理	中等

详细部署步骤

步骤一：准备VPS环境

操作说明：确保VPS满足基本运行要求并安装必要工具。 使用工具提示：SSH客户端、系统终端

# 更新系统软件包
sudo apt update && sudo apt upgrade -y
安装Docker（如未安装）
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
验证Docker安装
docker --version

步骤二：获取阿里云盘凭证

操作说明：获取部署所需的Token和文件夹ID。 使用工具提示：阿里云盘App、网页浏览器

# 访问以下链接获取凭证：
1. Token获取：https://alist.nn.ci/zh/guide/drivers/aliyundrive.html
2. Refresh Token：https://alist.nn.ci/zh/guide/drivers/aliyundriveopen.html

3. 在阿里云盘资源库新建文件夹并获取ID

步骤三：选择部署方式

方法一：一键脚本安装（推荐新手）

操作说明：使用官方提供的一键安装脚本快速部署。

# 执行一键安装脚本
bash -c "$(curl http://docker.xiaoya.pro/updatenew.sh)"
按照提示输入：
- 32位Token
- 335位Refresh Token  
- 40位文件夹ID

方法二：Docker命令部署

操作说明：手动创建配置文件并使用Docker命令部署。

# 创建配置目录
mkdir -p /data/xiaoya
创建凭证文件
echo "你的32位Token" > /data/xiaoya/mytoken.txt
echo "你的335位Refresh Token" > /data/xiaoya/myopentoken.txt
echo "你的文件夹ID" > /data/xiaoya/temptransferfolderid.txt
启动容器
docker run -d --network=host -v /data/xiaoya:/data \
  --restart=always --name=xiaoya xiaoyaliu/alist:hostmode

方法三：Docker Compose部署

操作说明：使用docker-compose.yml文件进行服务管理。

version: '3'
services:
  xiaoya:
    image: xiaoyaliu/alist:hostmode
    networkmode: host
    volumes:

/data/xiaoya:/data

    restart: always
    container_name: xiaoya

步骤四：验证部署结果

操作说明：检查服务是否正常运行。

# 检查容器状态
docker ps
验证服务访问
curl http://127.0.0.1:5678

步骤五：配置Alist挂载

操作说明：在Alist中添加小雅存储挂载。 使用工具提示：Alist管理后台、网页浏览器

驱动选择：ALIST V3
挂载路径：/xiaoya（自定义）
链接地址：http://127.0.0.1:5678

常见问题及解决方案

问题现象	可能原因	解决方案
容器启动失败	端口冲突或凭证错误	检查5678端口是否被占用，验证Token格式是否正确
网页显示空白	链接地址结尾有斜杠	确保链接为http://127.0.0.1:5678（无斜杠）
资源无法加载	网络连接问题	检查VPS网络连接，确认能够访问阿里云盘API
访问速度慢	服务器性能不足	升级VPS配置或优化网络设置
数据不同步	元数据更新失败	执行docker restart xiaoya重启容器

通过以上步骤，你可以在VPS上成功部署小雅媒体资源库，享受丰富的媒体资源服务。记得定期维护和更新，确保服务的稳定运行。