--- id: platform_installation.linux page_type: download_article title: "Linux 版 Moonbot" description: "Linux 版 Moonbot 以独立的可执行容器运行，内含 Arch Linux、Wine 及所需组件。下载现成的文件，即可在 Linux 电脑上运行这款 Windows 终端。" section: download category: null url: https://moonbot.pro/zh/moonbot-pro/download/linux?format=md locale: zh alternate_ru: https://moonbot.pro/ru/moonbot-pro/download/linux?format=md alternate_en: https://moonbot.pro/moonbot-pro/download/linux?format=md parent: https://moonbot.pro/zh/moonbot-pro/download?format=md previous: null next: null status: published updated_at: 2026-11-11T00:20:19+03:00 --- # Linux 版 Moonbot 自包含的可执行容器镜像，内含精简的 Arch Linux 发行版，预装 Wine 及运行为 Windows 开发的 Moonbot 所需的组件。 ## 系统要求 - 已安装的软件包：fuse3（或 fuse/fuse2）和 coreutils - 可以从 /tmp 目录执行文件（大多数发行版默认允许）。 - 支持 user namespaces 的 Linux 内核（容器运行所需）。 - 已安装并配置好的图形桌面环境。 ### 在常见发行版上安装依赖 **Debian / Ubuntu** `sudo apt install fuse3 coreutils` **RHEL / CentOS / AlmaLinux** `sudo dnf install fuse3 coreutils` --- ## 启动 要正常启动 Moonbot，系统中必须安装 `fuse3`（或 `fuse` 第 2 版）和 `coreutils` 软件包。 此外，`/tmp` 目录所在的文件系统必须允许执行二进制文件（未使用 `noexec` 选项）。大多数现代发行版默认就是这样配置的。 Moonbot 既可以从命令行终端启动，也可以通过图形界面启动。 首次启动前，请先将文件设为可执行： `chmod +x MoonBot` 之后直接不带选项运行即可： `./MoonBot` 如果没有附加的命令行参数，Moonbot 终端将以预设的 Wine 和容器设置启动。 --- ## 支持的发行版 推荐使用 **Debian 12**，不过也已在以下发行版上验证可用： - **Debian:** 11, 12 - **Ubuntu:** 20.04, 22.04, 24.04 - **RHEL / CentOS based:** AlmaLinux 9.5, RockyLinux 9.5\ *预计与所有基于 RHEL 9 及以上版本的发行版兼容* --- ## 已知问题 由于与 Wine 不兼容，较新版本的 Moonbot 目前无法在 Linux 上运行。 **请勿更新终端版本**，否则它可能无法启动。 如需在更新后回退版本，请使用 `-R` 选项执行重置（终端设置会保留）： `./MoonBot -R`\ `./MoonBot` --- ## 说明 Linux 版 Moonbot 是一个自包含的可执行容器镜像，内含精简的 Arch Linux 发行版，预装 Wine 及运行 Windows 版 Moonbot 所需的全部组件。 整个构建打包为一个可执行文件，无需安装，也不需要用户一侧的额外依赖。 该构建的主要目标是为在 Linux 下运行 Moonbot 提供稳定、隔离且易于使用的环境。 与手动安装 Wine 和库的传统做法不同，容器提供完全开箱即用的方案，最大限度降低与宿主系统软件包发生冲突以及配置差异带来问题的可能性。 此外，镜像中已包含 Windows 版 Moonbot 本身。 ### 这种方式的优势 - **部署更简单。** 无需安装和维护最新版本的 Wine 及其依赖。 - 环境隔离。所有更改和用户设置都保存在容器单独的工作目录中，不影响宿主系统。 - 兼容性。容器使用 unprivileged user namespaces（通过 bubblewrap）、OverlayFS 和 FUSE（第 2 或第 3 版），不需要 Docker 之类的额外工具，也不需要 root 权限。 技术基础：Conty、bubblewrap 和 user namespaces。 --- ## 文件系统与更改的保存 容器镜像本身是只读的。启动时使用 OverlayFS，从而可以在读写模式下工作。 所有更改都保存在以下目录中： `$HOME/.local/share/MoonBot/overlayfs` 容器内 Moonbot 的工作目录： `$HOME/.local/share/MoonBot/overlayfs/opt/MoonBot` 为方便起见，会在用户主目录中创建一个符号链接： `$HOME/.config/MoonBot → $HOME/.local/share/MoonBot/overlayfs/opt/MoonBot` 启动容器不会影响 Wine 的系统设置或宿主操作系统的配置。 --- ## 不使用容器的替代启动方式 如果系统中已安装较新版本的 Wine（不低于 9.x，推荐 10.0 及以上），可以直接运行 Moonbot。 同时建议具备 vkd3d 支持及所有相关依赖。 使用以下命令启动： `wine MoonBot.exe` --- ## 配置系统参数 在某些发行版（例如 Ubuntu）上，unprivileged user namespaces 的使用可能被禁用。 如需手动启用，请执行： `sudo sysctl kernel.unprivileged_userns_clone=1` 对于 Ubuntu 24.04 及更新版本，还需执行： `sudo sysctl kernel.apparmor_restrict_unprivileged_userns=0` --- ## 命令行选项 Moonbot 容器支持以下启动参数： `-h` — 显示帮助 `-r` — 重置容器，保留 Moonbot 的工作目录和设置 `-R` — 与 `-r` 相同，并尝试恢复 Moonbot 的二进制文件（建议在更新失败后使用） `-RESETFULL` — **破坏性模式**，完全重置容器并删除所有数据和设置 查看帮助请使用： `./MoonBot -h` --- ![Linux 版 Moonbot](https://moonbot.pro/storage/media/Banner/image/46/conversions/01KBAGTJRKG48C9SY3SJDPCP7X-optimized.png) 打包为单个可执行文件的容器镜像，用于借助 Wine 在运行 Linux 操作系统的电脑上启动 Moonbot。 - [下载](https://api.moonbot.pro/files/MoonBot-linux-demo.zip) ## 导航 路径: [首页](https://moonbot.pro/zh?format=md) / [Moonbot PRO](https://moonbot.pro/zh/moonbot-pro?format=md) / [下载 Moonbot](https://moonbot.pro/zh/moonbot-pro/download?format=md) / Linux 版 Moonbot 上级栏目: [下载 Moonbot](https://moonbot.pro/zh/moonbot-pro/download?format=md)