项目 | 说明 |
适用设备 | 极空间 Z2 Pro （ RK3566 ， aarch64 ）及任意 arm64 NAS |
验证环境 | 极空间 Z2Pro-6094 （ ZOS ）， Docker Server 架构 arm64 |
涉及版本 | MediaGo 3.5.0 、 N_m3u8DL-RE v0.6.0-beta |
服务端口 | 8899 （ Web UI 与 API 共用） |
预计耗时 | 约 10 分钟（不含镜像下载时间） |
文档日期 | 2026-10-02 |
官方 arm64镜像存在打包 bug（元数据是 arm64，主程序却是 x86的），直接部署必然失败。本教程给出只需替换一个二进制的补丁方案，并说明启动参数必须显式传入的原因，帮助你在 10分钟内让 MediaGo在极空间 Z2 Pro上跑起来。
你将学到什么
- 看懂Exec format error / Restarting (126) 背后真正的架构不匹配问题
- 用补丁方式修复官方镜像，而不必自己构建整个镜像
- 避开极空间旧版 builder忽略 CMD [] 的坑，用一条docker run 稳定启动
- 把下载目录正确挂载到 NVMe硬盘，并按需升级内置下载器、备份与迁移镜像
- 与桌面端联动（含「添加到 Docker」报 404的真实原因）
前置要求
- 设备：极空间 Z2 Pro（RK3566，四核 Cortex-A55，aarch64）或其他 arm64 NAS，系统 ZOS
- 权限：可开启 SSH并具备 sudo 权限，会使用极空间「文件管理器」上传文件
- 基础：了解 Docker基本概念（镜像、容器、端口映射、卷挂载）
- 配套文件：patch.sh、mediago-core-arm64（必需）；update-nre.sh、N_m3u8DL-RE-arm64、export-image.sh、diagnose.sh（可选）
- 预计时间：完整跟完约 10分钟（不含镜像下载时间）
元信息
项目 | 内容 |
目标读者 | 具备基础 Linux / Docker 操作能力的 NAS 用户 |
前置知识 | SSH 登录、 docker run 基本参数、端口与卷挂载概念 |
技术栈版本 | MediaGo 3.5.0 （ master 构建）、极空间内置 arm64 Docker 引擎、 N_m3u8DL-RE v0.6.0-beta |
验证环境 | 极空间 Z2Pro-6094 （ ZOS ） |
预计阅读时间 | 12 分钟 |
一、为什么要走「补丁」这条路
官方镜像ghcr.io/caorushizi/mediago:3.5.0的 arm64版本元数据标注为 arm64，但镜像内的主程序mediago-core 实际是 x86-64 二进制。这会导致三个连锁问题，本教程的每一步设计都是为了绕开它们。
序号 | 现象 | 真实原因 |
1 |
深度掌握)
