🌐 简体中文
English日本語বাংলাEspañolFrançaisDeutschNederlandsРусский简体中文한국어हिन्दी
← 全部文章
· 更新于 2026年10月10日

在 muOS 上安装应用：用 Archive Manager 安装 .muxapp 和 .muxzip 文件

muOS 的应用是一个以 .muxapp 结尾的单个文件。你不需要解压，也不需要到处复制文件夹：muOS 内置了一个名为 Archive Manager 的安装器，会替你完成。本教程介绍整个流程、背后发生了什么，以及最容易踩坑的两件事：更新会重置设置，以及如何卸载。

**测试环境：**Anbernic RG40XXH · muOS 2601.0 Jacaranda。其他 muOS 掌机的操作相同。

什么是 .muxapp 文件

.muxapp 文件就是换了扩展名的普通 ZIP 压缩包。里面有一个以应用命名的文件夹，例如：

WiFiTransfer.muxapp
└── WiFiTransfer/
    ├── mux_launch.sh    ← muOS 用它启动应用
    ├── config.ini
    └── …

安装就是把这个文件夹解压到 SD 卡的 MUOS/application/ 中。这个文件夹里的每个应用都会出现在 Applications 菜单中。

第 1 步：把文件复制到 ARCHIVE 文件夹

Archive Manager 会列出 SD 卡 1（muOS 运行所在的卡）根目录下 ARCHIVE 文件夹中的文件。如果没有这个文件夹，请用大写字母创建它。

把文件放进去有三种简单的方法：

  • **读卡器：**关闭掌机，把 SD 卡 1 插入电脑，把 .muxapp 文件复制到 ARCHIVE。取出前请先安全弹出。
  • **通过 Wi-Fi 使用 Wi-Fi Transfer：**在掌机上打开应用，在手机或电脑浏览器中打开它显示的地址，然后在 SD 卡 1 标签页点 添加游戏，选择 .muxapp。它会自动进入 ARCHIVE。
  • **SFTP：**muOS 可以运行 SFTP 服务器：在 Configuration → Connectivity → Web Services 中打开 SFTP + Filebrowser。之后任何 SFTP 应用（FileZilla、Cyberduck、WinSCP）都能把文件复制到 SD 卡 1 的 ARCHIVE 中。

请保持文件名不变：Archive Manager 根据扩展名（.muxapp）决定怎么处理。

第 2 步：用 Archive Manager 安装

  1. 在掌机上打开 Applications → Archive Manager。
  2. 选中 .muxapp 文件，按 A。
  3. muOS 会关闭菜单，并在工作时显示文字界面：Inspecting Archive…、正在解压的文件、Sync Filesystem，最后是 All Done!
  4. 几秒钟后回到 Archive Manager。该文件现在标记为 INSTALLED。

打开 Applications：新应用已在列表中。有些应用在启动前还需要打开 Wi-Fi（Configuration → Connectivity → Wi-Fi Network）。

安装后 .muxapp 文件仍留在 ARCHIVE 中。你可以留作备份，也可以删除；已安装的应用不需要它。

Archive Manager 实际做了什么

在解压任何内容之前，Archive Manager 会检查压缩包，只要其中有任何路径指向目标文件夹之外（绝对路径或 ..），就拒绝安装。因此，损坏或恶意的安装包无法通过这种方式覆盖 muOS 的系统文件。

这项检查针对的是文件的位置，而不是应用运行后会做什么。muOS 上的应用拥有对系统的完全访问权限，所以请只安装来自可信来源的 .muxapp 文件：开发者自己的网站或 GitHub 发布页面。

Archive Manager 不只用于应用。它会根据文件扩展名选择安装方式：

扩展名 内容 安装到
.muxapp 应用程序 MUOS/application/
.muxthm 主题 MUOS/theme/<名称>/
.muxalt 当前主题的另一种外观 当前主题的文件夹
.muxzip 内容包（例如存档、BIOS 或合集，取决于其中内容） 对应的 muOS 文件夹
.muxcat 目录包（封面和简介） MUOS/package/catalogue/
.muxcfg RetroArch 配置包 MUOS/package/config/
.muxupd muOS 系统更新 系统本身

更新应用：先保存设置

要更新，请把较新的 .muxapp 复制到 ARCHIVE，然后用同样的方法安装。Archive Manager 会把它解压并覆盖现有的应用文件夹：

  • 新安装包中的文件会替换旧文件，包括 config.ini；
  • 安装包中没有的文件，例如应用的 data/ 或 logs/ 文件夹，会保留。

所以你在应用 config.ini 中改过的内容，更新后都会恢复为默认值。更新前，请把应用的 config.ini 复制到安全的地方（或记下你的设置），更新后再改回来。Game Manager 是个例外：它的安装包不含 config.ini，所以更新后你的设置（包括 itch.io API 密钥）都会保留。你的已安装游戏列表位于 data/，更新后仍会保留。

如果新文件与旧文件同名，请先删除或替换 ARCHIVE 中的旧文件，确保你清楚正在安装哪一个。

卸载应用

muOS 2601 没有卸载应用的按钮。要删除应用，请删除它的文件夹：

  • SD 卡 1 → MUOS/application/<应用名>

可以用读卡器、SFTP 或 Wi-Fi Transfer 来删除。然后回到主菜单，重新打开 Applications，应用就不见了。删除文件夹也会删除应用自己的设置和数据，所以请先复制你想保留的内容。

故障排除

  • **Archive Manager 显示 “No Archives Found”：**文件不在 SD 卡 1 根目录的 ARCHIVE 中，或者文件夹名称不对。它必须叫 ARCHIVE，不能放在 ROMS 或 MUOS 里面。
  • **文件出现在列表中，但安装时报 “unsafe paths”：**安装包制作有误。请联系应用的开发者；不要尝试手动解压。
  • **“Could not open archive… Corrupt?”：**下载没有完成，或复制中断了。请重新下载；如果开发者提供了 SHA-256 校验值，请对比一下（在 Mac 或 Linux 上运行 shasum -a 256 file.muxapp）。
  • **应用已安装但没有出现：**回到主菜单，重新打开 Applications。如果还是没有，请检查 MUOS/application/<应用名>/mux_launch.sh 是否存在。
  • **应用一打开就关闭：**很多应用会在自己的文件夹里写日志，通常是 logs/app.log。查看一下；如果应用需要联网，请打开 Wi-Fi。

总结

  1. 把 .muxapp 文件放到 SD 卡 1 的 ARCHIVE 中。
  2. Applications → Archive Manager，选中文件，按 A，等待 All Done!
  3. 从 Applications 打开应用。
  4. 更新前保存应用的 config.ini。卸载时删除它在 MUOS/application/ 中的文件夹。

有问题？请发邮件至 feedback@pocketkode.com。

PocketKode 与 muOS 和 Anbernic 均无关联。