Linbox-WinEmu

Linbox-WinEmu（原 WinEmulator）是一款运行在 Android 设备上的 Linux 环境模拟器，通过利用 PRoot、Box64/86、Termux-X11 等技术，在 Android 手机或平板上创建一个完整的 Linux 容器环境，从而实现运行 Windows 应用程序和游戏的目的。本应用支持自定义分辨率、多种输入模式、Wine 兼容层配置以及 DXVK/VKD3D 图形加速，适用于办公、娱乐和游戏等多种场景。

本项目由 ewt45 发起，afeimod 持续维护更新。

核心功能 Linbox-WinEmu 提供了以下核心功能，以满足用户在 Android 设备上运行 Linux 和 Windows 应用的需求：

PRoot 容器环境 应用内置 PRoot 技术，无需 root 权限即可在 Android 设备上运行完整的 Linux 容器。支持切换不同的 Linux 发行版 rootfs，兼容 Debian、Ubuntu、Arch Linux 等多种发行版。每个容器可以独立配置语言环境、共享文件夹和启动命令。

X11 显示服务 集成 Termux-X11 作为 X11 服务器，支持自定义分辨率（从 800x600 到 1920x1080 等多种预设，并支持自定义分辨率）。提供三种触摸操作模式：虚拟触控板模式适合精确光标控制；模拟触摸模式支持单指点击和长按右键；触摸屏模式则直接在屏幕上操作。

Wine 兼容层 支持多种 Wine 版本安装和管理，包括 wine-ge-custom、wine-tkg 等优化版本。内置 DXVK、DXVK-ASYNC、DXVK-GPLASYNC 等 DirectX 到 Vulkan 的转换层，以及 VKD3D（Direct3D 12 到 Vulkan）和 D8VK（Direct3D 8 到 Vulkan）支持，显著提升 Windows 游戏的图形性能。

Box64/86 模拟器 内置 Box64 和 Box86 模拟器，使 ARM64/Android 设备能够运行 x86_64 和 x86 架构的 Linux 和 Windows 程序。通过动态翻译技术，在移动设备上实现更广泛的软件兼容性。

输入控制系统 功能完善的虚拟输入控制系统，支持创建和管理多个控制配置文件。每个配置文件可以包含虚拟按键、虚拟摇杆、鼠标区域等控件元素。支持导入导出配置，方便用户分享和备份。

快速上手指南 按照以下步骤，您可以快速在 Android 设备上启动 Linux 环境并运行 Windows 程序。

准备工作 在开始使用 Linbox-WinEmu 之前，请确保完成以下准备工作。首先，进入手机设置，开启开发者选项。在开发者选项中，找到并勾选「USB 调试」和「USB 安装」选项。随后，找到「后台进程限制」或「停止限制子进程」选项，勾选「不允许后台进程被限制」或类似的选项。这一步非常重要，可以避免应用在后台运行时出现报错 9（崩溃/闪退）的问题。

如果应用提示需要存储权限，请授予「管理所有文件」的权限，以便应用能够访问和修改文件系统。

创建第一个容器 首次启动应用后，您需要创建一个 Linux 容器。在应用主界面，双击容器管理（分为wine和fexwine两种）点击「新建容器」按钮

容器创建完成，选择您刚创建的容器作为当前使用的容器。

主要设置说明 Linbox-WinEmu 提供了丰富的设置选项，让您可以根据具体需求调整应用的运行行为。以下是各主要设置面板的详细说明。

常规设置 在常规设置面板中，您可以配置以下选项：

分辨率设置：进入「X11 显示设置」中的分辨率选项，可选择预设分辨率（800x600、1024x768、1280x720、1600x900、1920x1080）或自定义输入分辨率。分辨率越高，画面越精细，但对设备性能要求也越高。默认推荐 1280x720。

容器语言：设置容器启动时的 locale 环境变量（LANG），影响程序界面的语言显示。可选 zh_CN.utf8（简体中文）或 en_US.utf8（英文）。

共享文件夹：添加 Android 设备上的文件夹，使这些文件夹在 Linux 容器内可访问。默认已配置 Download 文件夹共享。点击添加按钮可选择更多文件夹，被共享的文件夹会在容器内挂载到指定路径。

Rootfs 切换：管理多个 Linux 容器，可以添加、删除、重命名容器，或在容器之间切换。当前正在运行的容器无法被删除。切换容器后需要重启应用生效。

X11 显示设置 X11 显示设置面板控制 X11 服务器的行为和显示效果：

触摸方式：应用提供三种触摸操作模式。虚拟触控板模式将屏幕下方区域作为触控板使用，单指移动控制光标，轻点模拟鼠标左键，一指按住加另一指轻点模拟右键，双指移动模拟滚轮。模拟触摸模式中单指点击即为鼠标操作，长按模拟右键。触摸屏模式则直接将屏幕作为触摸屏使用。

屏幕方向：控制 X11 显示的屏幕方向，可选跟随系统自动旋转、固定横屏、固定竖屏、反向横屏或反向竖屏。此设置不影响系统界面的方向。

显示缩放：通过滑块调整 X11 显示的缩放比例，范围从 30% 到 300%。当设备屏幕较大或分辨率较高时，可以适当降低缩放比例以显示更多内容；反之则可放大显示。

保持屏幕常亮：启用此选项后，在 X11 运行期间防止屏幕自动熄灭，适合长时间游戏或观看视频。

PRoot 参数设置 PRoot 参数设置面板允许高级用户调整容器运行参数：

PRoot 选项：可用的选项包括 -L（启用符号链接模拟）、--link2symlink（启用 link2symlink 功能，必要）、--kill-on-exit（退出时清理进程）、--sysvipc（启用 System V IPC 支持）和 --ashmem-memfd（使用 ashmem 内存文件描述符）。建议保持默认选项不变，除非您明确知道某个选项的作用。

启动后执行命令：在此处输入的命令会在容器启动后自动执行。常见的用途包括设置环境变量、启动特定服务或程序。例如，输入 cd /usr/local/games && wine game.exe 可在容器启动后自动运行游戏。

输入控制设置 输入控制系统允许您创建自定义的虚拟按键布局：

创建配置：在「输入控制」设置中，点击「添加配置」创建新的控制方案。为配置命名后，点击「编辑控件」进入编辑器界面。

添加控件：在编辑器中，点击空白区域可添加新的控件。可选的控件类型包括按钮（可绑定键盘按键或鼠标动作）、鼠标区域（拖动时光标跟随移动）、摇杆和滚轮。

绑定动作：选中控件后，点击「绑定」选项进入绑定模式。点击某个按钮或移动摇杆，应用将识别对应的输入信号，然后将其绑定到选中的控件上。例如，将游戏手柄的 A 按钮绑定到键盘的 Enter 键。

调整样式：可以为控件选择不同的图标、形状和颜色，设置控件的透明度。透明度越低，控件在游戏中越不明显，避免遮挡游戏画面。

导入导出：支持将控制配置导出为文件，方便备份或在其他设备上导入使用。

常见问题解答 以下是用户在使用 Linbox-WinEmu 时经常遇到的问题及其解决方案：

应用启动后立即崩溃（报错 9） 这个问题通常是由于 Android 系统限制了后台进程导致的。解决方法如下：进入手机设置，打开「开发者选项」，找到「后台进程限制」或「停止限制子进程」相关选项，选择「不允许后台进程被限制」或「无限制」。部分手机品牌可能将此项放在「电池管理」或「应用后台管理」设置中。

无法安装 rootfs 或安装后无法启动 首先检查设备存储空间是否充足，每个 rootfs 至少需要 2-4GB 空间。其次，确保已授予应用「管理所有文件」权限。如果网络不稳定，建议使用 VPN 或在网络条件较好的环境下重试。

音频无法正常工作 检查容器内 PulseAudio 服务是否正常运行。在终端输入 pulseaudio --check 检查服务状态。如果音频断续，可以尝试在 PRoot 启动命令中添加 -pa 参数或手动启动 PulseAudio。

触摸操作不灵敏或光标漂移 在 X11 显示设置中尝试切换触摸模式。虚拟触控板模式适合需要精确控制的场景。如果使用模拟触摸模式，适当调整光标速度设置。

容器内无法访问共享文件夹 检查共享文件夹路径是否正确，确认 Android 端对应文件夹存在且应用已获得访问权限。在终端中使用 ls /storage/emulated/0/ 命令检查共享目录是否正确挂载。