一键安装 小雅Xiaoya全家桶

本文于 2026-10-24 对照 维护者 README、入口脚本 和 安装脚本 整理，未执行安装，也未对下表平台逐一实测。

NAS、Linux 主机和 macOS 的运行前提不同。先确认 Docker 已启动、镜像支持主机架构，并为元数据及缓存准备足够空间。Linux 脚本通常要求 root；维护者的 main.sh 明确要求 macOS 使用普通用户启动，由脚本处理需要的提权。已有部署先备份配置及数据，确认使用的实际目录。

执行命令

先查看 Docker 和磁盘状态，确认是在准备安装的那台主机上操作：

docker version
uname -m
df -h

下载脚本到本地，保留 HTTPS 证书校验；下载成功后再查看内容。以下采用维护者仓库的整合脚本地址：

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 xiaoya-all-in-one.sh

维护者 README 还列出 网站入口、网站整合脚本 和 jsDelivr 备用地址。直连失败时只替换下载地址，仍先检查下载内容；不要同时运行多个安装器。入口脚本会继续下载其他文件，因此只查看入口不等于审查了整个安装过程。

TLS 错误应先检查系统时间、CA 证书、代理及目标域名，默认不添加 --insecure。下载失败或得到 HTML 错误页面时不要执行。master / latest 内容会变化，升级前应重新查看维护者说明。

必要参数

账户凭据按脚本实际提供的阿里云盘接入方式填写。下表是常见文件，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 说明、Open Token 说明。第三方获取页面及网盘授权流程可能变化，以当前脚本和驱动文档为准。Token 文件相当于账户凭据，不要公开粘贴或随日志上传；清理助手操作的目录也应先核对。

功能列表

菜单数字是交互选择，不是 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 及部分定时同步功能移入弃用菜单，标为不再维护。兼容表中的历史勾选不代表这些功能已恢复维护。需要采用其他维护者的替代方案时，应阅读对应项目文档并单独核对迁移路径，不能把它作为原安装流程的直接续接步骤。

安装后验证与维护

先查看容器实际名称、端口和状态：

docker ps -a --format 'table {{.Names}}\t{{.Status}}\t{{.Ports}}'

将下面的 xiaoya 替换为输出中的目标容器名，检查日志和挂载目录：

docker logs --tail 100 xiaoya
docker inspect --format '{{range .Mounts}}{{println .Source "->" .Destination}}{{end}}' xiaoya

从浏览器打开该组件实际映射的地址，分别验证目录列表、账户授权和一个有权访问的测试文件。Emby 等组件还要确认元数据扫描及实际播放；容器显示 Running 只是第一步。

更新前记录容器名称、镜像、挂载和自定义参数，备份配置，并核对新版本要求。卸载和元数据清理是不同操作，执行前看清是否删除本地目录、网盘转存内容或媒体库；不要根据旧截图的按钮位置判断清理范围。

通用兼容性测试报告

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 (飞牛私有云)	✅	✅	✅