--- url: https://eoht.net/vps/serve/xiaoya-alist.md description: >- 按维护者文档整理小雅 Xiaoya 全家桶的脚本获取、Docker 前提、token 文件与功能入口，区分上游兼容性记录和当前实测，并补充安装后验证、更新及卸载检查。 --- # 一键安装 小雅Xiaoya全家桶 {#install-xiaoya-alist-bundle} 本文于 2026-10-24 对照 [维护者 README](https://github.com/xiaoyaDev/xiaoya-alist/blob/master/README.md)、[入口脚本](https://github.com/xiaoyaDev/xiaoya-alist/blob/master/main.sh) 和 [安装脚本](https://github.com/xiaoyaDev/xiaoya-alist/blob/master/all_in_one.sh) 整理，未执行安装，也未对下表平台逐一实测。 NAS、Linux 主机和 macOS 的运行前提不同。先确认 Docker 已启动、镜像支持主机架构，并为元数据及缓存准备足够空间。Linux 脚本通常要求 root；维护者的 `main.sh` 明确要求 macOS 使用普通用户启动，由脚本处理需要的提权。已有部署先备份配置及数据，确认使用的实际目录。 ## 执行命令 {#run-installation-command} 先查看 Docker 和磁盘状态，确认是在准备安装的那台主机上操作： ```bash docker version uname -m df -h ``` 下载脚本到本地，保留 HTTPS 证书校验；下载成功后再查看内容。以下采用维护者仓库的整合脚本地址： ```bash curl -fL --retry 3 \ https://raw.githubusercontent.com/xiaoyaDev/xiaoya-alist/master/all_in_one.sh \ -o xiaoya-all-in-one.sh && less xiaoya-all-in-one.sh ``` 确认内容与来源后，在符合上述用户权限要求的会话中执行： ```bash bash xiaoya-all-in-one.sh ``` 维护者 README 还列出 [网站入口](https://ddsrem.com/xiaoya_install.sh)、[网站整合脚本](https://ddsrem.com/xiaoya/all_in_one.sh) 和 [jsDelivr 备用地址](https://fastly.jsdelivr.net/gh/xiaoyaDev/xiaoya-alist@latest/all_in_one.sh)。直连失败时只替换下载地址，仍先检查下载内容；不要同时运行多个安装器。入口脚本会继续下载其他文件，因此只查看入口不等于审查了整个安装过程。 TLS 错误应先检查系统时间、CA 证书、代理及目标域名，默认不添加 `--insecure`。下载失败或得到 HTML 错误页面时不要执行。`master` / `latest` 内容会变化，升级前应重新查看维护者说明。 ## 必要参数 {#required-parameters} 账户凭据按脚本实际提供的阿里云盘接入方式填写。下表是常见文件，Linux 默认目录通常为 `/etc/xiaoya`；macOS、NAS 或自定义安装必须使用脚本提示和容器实际挂载的配置目录，不能一律往 `/etc/xiaoya` 写入。 | 参数 | 默认目录下对应文件 | 获取与核对 | | --- | --- | --- | | Refresh Token | `/etc/xiaoya/mytoken.txt` | 按脚本的账户管理提示完成授权，确认是所用账号的 refresh token | | Open Token | `/etc/xiaoya/myopentoken.txt` | 按所选 Open / TV 接入方式获取，不与上面的 refresh token 混用 | | 转存目录 ID | `/etc/xiaoya/temp_transfer_folder_id.txt` | 使用自己网盘中用于转存的目录 ID，核对所属账号和目录，避免误清理其他内容 | 旧版参考入口：[Refresh Token 说明](https://alist.nn.ci/zh/guide/drivers/aliyundrive.html)、[Open Token 说明](https://alist.nn.ci/zh/guide/drivers/aliyundrive_open.html)。第三方获取页面及网盘授权流程可能变化，以当前脚本和驱动文档为准。Token 文件相当于账户凭据，不要公开粘贴或随日志上传；清理助手操作的目录也应先核对。 ## 功能列表 {#feature-list} 菜单数字是交互选择，不是 Shell 命令。先选择功能组，再按当前终端显示的文字选择操作；不同脚本版本的深层编号会调整。下面按本次核对的脚本提供导航，避免把旧的多级数字串直接当成固定命令。 | 主菜单 | 功能范围 | 操作前核对 | | --- | --- | --- | | `1` 小雅 Alist | 安装、更新、卸载、账号管理、访问统计、定时重启 | 配置目录、挂载、凭据、容器名称 | | `2` Emby 全家桶 | 一键安装、手动元数据流程、Emby 安装、爬虫、配置编辑、升级及清理 | 磁盘空间、元数据路径、现有媒体库和所选镜像 | | `3` 小雅助手 | 安装 / 更新、一次性运行、卸载 | 会清理的网盘目录和账号 | | `4` 115 清理助手 | 安装、更新、卸载 | 115 账号与清理范围 | | `5` 其他组件与系统工具 | Portainer、Auto_Symlink、Onelist、Proxy、TVBox、LrcAPI、CasaOS 等 | 组件自身的端口、卷、架构和依赖 | | `6` 高级设置 | 容器名称、附加参数、检测选项、镜像源、网络模式和弃用菜单 | 现有容器与配置是否受影响 | 例如，当前脚本中 `1 → 1` 是小雅 Alist 安装，`2 → 1` 是 Emby 一键安装；进入后先阅读提示再确认。当前“其他组件”中的 CasaOS 位于 `5 → 9`，旧 README 的部分示例仍写 `5 → 8`，遇到差异应按实际脚本菜单文字操作。 手动元数据流程允许分别下载和解压不同数据包，下载完成不等于已解压、扫描或可播放。选择组件前确认所用播放器和媒体格式受支持，尤其不要把 Emby 的 `.strm` 工作流直接套用到其他媒体服务。 **弃用功能** 维护者将旧 Jellyfin 全家桶、Resilio-Sync 及部分定时同步功能移入弃用菜单，标为不再维护。兼容表中的历史勾选不代表这些功能已恢复维护。需要采用其他维护者的替代方案时，应阅读对应项目文档并单独核对迁移路径，不能把它作为原安装流程的直接续接步骤。 ### 安装后验证与维护 {#verify-xiaoya-installation} 先查看容器实际名称、端口和状态： ```bash docker ps -a --format 'table {{.Names}}\t{{.Status}}\t{{.Ports}}' ``` 将下面的 `xiaoya` 替换为输出中的目标容器名，检查日志和挂载目录： ```bash docker logs --tail 100 xiaoya docker inspect --format '{{range .Mounts}}{{println .Source "->" .Destination}}{{end}}' xiaoya ``` 从浏览器打开该组件实际映射的地址，分别验证目录列表、账户授权和一个有权访问的测试文件。Emby 等组件还要确认元数据扫描及实际播放；容器显示 Running 只是第一步。 更新前记录容器名称、镜像、挂载和自定义参数，备份配置，并核对新版本要求。卸载和元数据清理是不同操作，执行前看清是否删除本地目录、网盘转存内容或媒体库；不要根据旧截图的按钮位置判断清理范围。 ## 通用兼容性测试报告 {#compatibility-test-report} > \[!NOTE] > 以下表格保留维护者 README 的兼容性记录，核对日期为 2026-10-24，并非本站实测结果。 > ✅ 表示上游曾报告通过，❌ 表示上游列为不兼容，🚧 表示其测试不足；表内未给出统一测试日期与镜像版本，不能据此判断旧系统仍受安全维护、某功能当前仍可用或每个 NAS 型号都适配。 | 软件名称 | x86-64 | amd64 | arm64 | arm64v8 | armhf | armv7 | | :-------------------------------------------: | :-------------: | :--------------: | :------------: | | 小雅Alist | ✅ | ✅ | ✅ | | 小雅Emby全家桶 | ✅ | ✅ | ❌ | | 小雅Jellyfin全家桶 | ✅ | ✅ | ❌ | | 小雅助手（xiaoyahelper） | ✅ | ✅ | ✅ | | 小雅Alist-TVBox | ✅ | ✅ | ❌ | | Onelist | ✅ | ✅ | ✅ | | 小雅元数据爬虫（xiaoya-emd） | ✅ | ✅ | ✅ | | 小雅元数据爬虫（Web 版本） | ✅ | ✅ | ✅ | | 小雅Cron容器（xiaoya-cron） | ✅ | ✅ | ✅ | | 小雅代理容器（xiaoya-proxy） | ✅ | ✅ | ✅ | | 115清理助手（xiaoya-115cleaner） | ✅ | ✅ | ✅ | | xiaoya-glue（官方 python） | ✅ | ✅ | ❌ | | xiaoya-glue（官方 latest） | ✅ | ✅ | ✅ | | xiaoya-glue（DDSRem python） | ✅ | ✅ | ❌ | | xiaoya-glue（DDSRem aliyuntvtoken_connector） | ✅ | ✅ | ✅ | | 系统名称 | all_in_one.sh | emby_config_editor.sh | xiaoya_notify.sh（已弃用） | | :--------------------: | :-----------: | :-------------------: | :------------------------: | | CentOS 7.9 | ✅ | ✅ | ✅ | | CentOS 8.4 | ✅ | ✅ | ✅ | | CentOS 8 Stream | ✅ | ✅ | ✅ | | CentOS 9 Stream | ✅ | ✅ | ✅ | | Debian 10.3 | ✅ | ✅ | ✅ | | Debian 11.3 | ✅ | ✅ | ✅ | | Debian 12.0 | ✅ | ✅ | ✅ | | Ubuntu 18.04 | ✅ | ✅ | ✅ | | Ubuntu 20.04 | ✅ | ✅ | ✅ | | Ubuntu 22.04 | ✅ | ✅ | ✅ | | Ubuntu 22.10 | ✅ | ✅ | ✅ | | Ubuntu 23.04 | ✅ | ✅ | ✅ | | Fedora 31 | ✅ | ✅ | ✅ | | Fedora 32 | ✅ | ✅ | ✅ | | Fedora 36-38 | ✅ | ✅ | ✅ | | Fedora 40 | ✅ | ✅ | ✅ | | Fedora 41 | ✅ | ✅ | ✅ | | Fedora 42 | ✅ | ✅ | ✅ | | AlmaLinux 9 | ✅ | ✅ | ✅ | | RockyLinux 8.6 | ✅ | ✅ | ✅ | | Arch Linux | ✅ | ✅ | ✅ | | openSUSE 15.4 | ✅ | ✅ | ✅ | | FreeBSD | ✅ | ✅ | ✅ | | EulerOS | ✅ | ✅ | ✅ | | Amazon Linux | ✅ | ✅ | ✅ | | Alpine | ✅ | ✅ | ✅ | | MacOS | ✅ | ✅ | 🚧 | | UnRaid | ✅ | ✅ | ✅ | | OpenMediaVault | ✅ | ✅ | ✅ | | QNAP（威联通） | ✅ | ✅ | ✅ | | OpenWRT | ✅ | ✅ | ✅ | | Synology（群晖） | ✅ | ✅ | ✅ | | TrueNAS CORE | 🚧 | 🚧 | 🚧 | | TrueNAS SCALE | 🚧 | 🚧 | 🚧 | | UGOS（绿联云） | ✅ | ✅ | ✅ | | UGOS Pro（绿联云 Pro） | ✅ | ✅ | ✅ | | LibreELEC | ❌ | ❌ | ❌ | | Windows WSL Docker | 🚧 | 🚧 | ❌ | | ZSpace（极空间） | 🚧 | 🚧 | 🚧 | | fnOS (飞牛私有云) | ✅ | ✅ | ✅ |