ptitSeb /box64

Box64 - Linux Userspace x86_64 Emulator with a twist, targeted at ARM64, RV64 and LoongArch Linux devices

★ 5,715⑂ 490👁 78⑃ 3,005● 1,575▤ 22
CMITCreated 2020-12-01box86.org
下载:v0.4.4v0.4.4 ↓0.4.42026-08-02
+1
日增长
5,715
stars
490
forks
78
watchers
3,005
prs
1,575
issues
22
releases

README

!图标

 Box64:Linux 用户空间 x86-64 模拟器(支持原生库)

官网 | 更新日志 | English | Українська | Report an Error

!Build Status !Stars !Forks !Contributors !Pull Requests !Issues

---

请查看我们的游戏兼容性列表:https://box86.org/app/,并请帮助我们改进它!

---

Box64 可以在非 x86_64 Linux 主机系统(比如 Arm)上运行 x86_64 Linux 程序(比如游戏),目前仅支持 64 位小端主机系统。

Box64 可以使用本机原生的系统库(libc、libm、SDL、OpenGL),有着易于集成的特性和令人惊讶的性能。如需性能基准测试,请查看此分析。

借助适用于 Arm,RISC-V 以及龙架构平台的 DynaRec,Box64 的速度比单独使用解释器快 5-10 倍。如需深入了解 DynaRec,请参考此文章。



_Logo 由 @grayduck 制作,感谢!_

---

 使用方法

- $ box64 ./program [args] 运行 Linux x86_64 程序。
- $ box64 -k 杀死所有模拟的进程。
- $ box64-bash 进入 x86_64 bash 环境。
- 想要使用 wine?请参阅 Wine 使用说明。

Box64 还提供了环境变量和 Rc 文件来控制其行为。有关详细信息请参阅使用文档。

---

 编译和安装

- 编译说明
- 安装 Wine

---

 版本历史

请参阅变更日志了解版本更新说明。

---

 平台兼容性说明

Box64 直接转换 x86_64 函数调用到本机原生库,因此需要主机系统上的 64 位库。对于 32 位二进制文​​件,请使用 Box86 或 Box32。

注意事项

1. Box32 仍然是实验性质。
2. 某些 Shell 脚本(比如 GOG 游戏安装脚本)可能会依赖 uname -m 判断当前架构,请使用 box64 script.sh 的方式运行以便让 Box64 接管。

---

 配置

Box64 的配置文件位于 /etc/box64.box64rc 和 ~/.box64rc,均为 .ini 格式的文件。如果您不想使用默认的 /etc/box64.box64rc 文件,请将其复制到 ~/.box64rc 以确保兼容性。

配置项的优先级:~/.box64rc  /etc/box64.box64rc  命令行。

更多信息,请参阅使用文档。

---

 特定平台的其他说明

 Unity 游戏
- 许多 Unity 游戏需要 OpenGL 3+,这对 ARM/RISC-V SBC 来说可能具有挑战性。
- 对 Pi4 和 Pi5 用户的提示:设置 MESA_GL_VERSION_OVERRIDE=3.2 和 BOX64_DYNAREC_STRONGMEM=1 以防止卡死并启用强内存模式。
- Panfrost:为了在 ARM 上实现更好的兼容性,启用 PAN_MESA_DEBUG=gl3 以强制更高的 OpenGL Profile。如果游戏可以启动但在显示任何内容之前意外退出,这个设置可能会有所帮助。

 Steam

Box64 支持 Linux Steam 和 Windows Steam,更多细节请参考Steam 文档。

 由于 Linux Steam 客户端应用是 32 位的,需要使用 Box86 或 Box32,但其本地服务器是 64 位的二进制文件。对于内存少于 6GB 的系统,可能需要使用交换文件以获得最佳性能。

 Wine

Box64 支持 Wine64 和 Proton。对于 32 位组件,需要 Box86。配备 Box64 和 Box86 的系统可以运行 32 位和 64 位的 Windows 程序。

提示:您可以使用 Wine WOW64 版本在仅限 Box64 的环境中运行 x86 Windows 程序,这项支持仍处于实验阶段,但在大多数情况下都可以工作。

有关更多信息,请参阅 Wine 使用说明。

----

结语
----

我要感谢所有为 box64 开发做出贡献的人。
贡献方式有很多种:代码贡献、财务帮助、捐赠捐赠和广告合作!
以下感谢不分先后: 

  代码贡献:rajdakin, mogery, ksco, xctan
  财务支持:Playtron, tohodakilla, FlyingFathead, stormchaser3000, dennis1248, sll00, libre-computer-project, CubeCoders Limited
  硬件捐赠和 LoongArch 迁移:xiaoji, Deepin Beijing Develop Team
  硬件捐赠:ADLINK with Ampere, SpacemiT, SOPHGO, Radxa, StarFive, Pine64, AYN, AYANEO, jiangcuo
  为本项目持续的宣传:salva (microLinux), PILab/TwisterOS team, The Byteman, NicoD, ekianjo (Boilingsteam)

我还要感谢很多人,即使他们只参与了一次本项目。

(如果你的项目中使用了Box64,请不要忘记提及!)

Top issues

Discussions

Latest release

v0.4.4 v0.4.4 2026-08-02
What's Changed
 A new box64-configurator is now present (a python app) to help managing custom RCFILE profiles. It is available in both english and chinese.
 DynaCache is now enabled by default. It will compress the files and use up to 2GB of disk space.
 You can use box64-configurator on the special [] profile to change default values
 More improvements on emulation accuracy that help running more DRM'd games
 Many Speed improvements in the LoongArch backend
 Many new opcodes in the RISC-V backend

More details in New release blog

 Contributions
 [DYNAREC] Optimized native_pclmul 

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON