box64

带有特色的Linux用户空间x86_64模拟器

查看更新日志 | 中文 | Українська | 报告错误

---

Box64让你能在非x86_64的Linux系统上运行x86_64 Linux程序（如游戏），比如ARM（主机系统需要是64位小端序）。

你可以在MicroLinux、Pi Labs或The Byteman YouTube频道找到许多Box64的视频。

由于Box64使用了一些"系统"库的原生版本，如libc、libm、SDL和OpenGL，因此它很容易与大多数应用程序集成和使用，在许多情况下性能可能出奇地高。看看这里的性能分析例子这里。

Box64为ARM64和RV64平台集成了DynaRec（动态重编译器），提供了5到10倍于仅使用解释器的速度提升。关于DynaRec如何工作的一些高层次信息可以在这里找到。

一些x64内部操作码使用了"Realmode X86 Emulator Library"的部分，详见x64primop.c中的版权信息

<img src="https://yellow-cdn.veclightyear.com/0a4dffa0/987ab0e5-b20f-4dcd-be02-a6a7e551578d.png" width="96" height="96">

标志和图标由@grayduck制作，谢谢！

---

使用方法

有几个环境变量可以控制Box64的行为。

查看这里了解所有环境变量及其作用。

注意：Box64的Dynarec使用内存保护和SegFault信号处理程序来处理JIT代码。简单来说，如果你想使用GDB调试使用JIT代码的运行程序（如mono/Unity3D），你仍然会遇到许多"正常的"段错误触发。建议在GDB中使用类似handle SIGSEGV nostop的命令来避免在每个段错误处停止，如果你想捕获段错误，可以在signals.c中的my_memprotectionhandler内设置断点。

---

编译/安装

编译说明可以在这里找到
为Box64安装Wine的说明可以在这里找到

---

版本历史/更新日志

更新日志可在这里查看。

---

关于32位平台的说明

由于Box64通过直接将x86_64的函数调用转换为主机系统的调用来工作，因此主机系统（运行Box64的系统）需要有64位库。Box64不包含任何64位<->32位的转换。

所以请理解，box64只能运行64位Linux二进制文件。对于32位二进制文件，你需要box86（在64位操作系统上这意味着所有的多架构或proot技巧）。 注意，许多安装程序（基于mojo setup）在检测到ARM64操作系统时会退回到"x86"，因此即使存在x86_64版本，也会尝试使用box86进行安装。你可以通过使用伪造的"uname"来解决这个问题，当参数为"-m"时返回"x86_64"。

另一种解决方案是使用带有新WoW64的Wine，但你将仅限于32位Windows应用程序和游戏。

---

关于Box64配置的说明

Box64现在有配置文件。加载了两个文件。/etc/box64.box64rc和~/.box64rc。两个文件具有相同的语法，基本上是ini文件。方括号中的部分定义进程名，其余部分是要设置的环境变量。查看使用方法了解可以设置哪些参数。Box64附带了一个默认文件，应该安装它以获得更好的稳定性。该文件位于system/box64.box64rc，应安装到/etc/box64.box64rc。如果由于某些原因你不想将该文件安装在这里，至少将其复制到~/.box64rc，否则某些游戏可能无法正常运行。 请注意，优先级为：~/.box64rc > /etc/box64.box64rc > 命令行 因此，~/.box64rc中的设置可能会覆盖命令行中的设置...

---

关于Unity游戏模拟的说明

运行Unity游戏应该可以直接工作，但你也应该注意，许多Unity3D游戏需要OpenGL 3+，这在ARM单板计算机（SBC）上可能很难提供。此外，许多较新的Unity3D游戏（如KSP）使用BC7压缩纹理，这在许多ARM集成GPU上不受支持。 提示：在 Pi4 和 Pi5 上使用 MESA_GL_VERSION_OVERRIDE=3.2，并配合 BOX64_DYNAREC_STRONGMEM=1 来防止冻结并启用强内存模式，同时使用 Panfrost PAN_MESA_DEBUG=gl3 来使用更高配置文件，以防游戏启动后在显示任何内容前就退出。

---

关于 GTK 程序的注意事项

box64 现在已经包装了 GTK 库，包括 gtk2 和 gtk3。

---

关于 Steam 的注意事项

请注意，Steam 是一个 32 位/64 位混合程序。你需要 box86 来运行 Steam，因为客户端应用是一个 32 位二进制文件。它还使用 64 位本地服务器二进制文件，而且 steamwebhelper 进程现在是必需的，即使在"小型模式"下也是如此。这个进程会消耗大量内存。因此，内存少于 6GB 的机器需要一个交换文件来使用 Steam。

---

关于 Wine 的注意事项

box64 支持 Wine64。Proton 也支持。请注意，64 位 Wine 也包含 32 位组件，以便能够运行 32 位 Windows 程序。32 位应用程序需要 box86，没有它就无法运行。在同时存在并正常工作的 box64 和 box86 的系统上，64 位 Wine 设置可以运行 32 位和 64 位 Windows 程序（分别使用 wine 和 wine64）。 请注意，Wine 团队目前在 Wine 7.+ 中实现的 64 位进程中的新 32 位 PE 现在已得到支持。它被称为"新 WoW64"，在 box64 上运行良好，允许在仅 64 位系统上使用 32 位 Windows 程序。

---

关于 Vulkan 的注意事项

Box64 包装了 Vulkan 库，但请注意，它主要在 AMD RX550 显卡和 Freedreno 驱动上进行了测试，因此根据你的显卡，可能缺少一些扩展。

---

最后的话

我要感谢所有为 box64 开发做出贡献的人。 有许多方式可以贡献：代码贡献、财务支持、硬件支持和宣传推广！ 因此，我想不分先后地感谢：

• 主要代码贡献者：rajdakin, mogery, ksco, xctan
• 主要财务贡献者：Playtron, FlyingFathead, stormchaser3000, dennis1248, sll00, libre-computer-project, CubeCoders Limited
• 硬件贡献和龙芯迁移：xiaoji, Deepin 北京开发团队
• 硬件贡献者：ADLINK 和 Ampere, SOPHGO, Radxa, StarFive, Pine64, AYN, AYANEO, jiangcuo
• 持续为 box64 项目做广告的人：salva (microLinux), PILab/TwisterOS 团队, The Byteman, NicoD, ekianjo (Boilingsteam)

我还要感谢其他许多参与过这个项目的人。

（如果你在项目中使用 Box64，请不要忘记提及它！）