+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
#1182Valheim Dedicated Server Crashes Post Unity 2022 Update124 comments · 2024-01-02#1780[BOX32] Getting the native Linux version of steam working on Apple silicon70 comments · 2024-08-31#3593Bunch of game performance tested on rk358846 comments · 2026-02-28#1046Satisfactory Dedicated Server34 comments · 2023-10-29#2020(Documentation request) Add a FAQ on the website32 comments · 2024-11-12#287box64 Viber: Symbol xcb_randr_get_output_info_name_length not found27 comments · 2022-04-21#1376Unable to launch war thunder26 comments · 2024-03-20#3632Packet tracer: SIGABRT crash (Console logs + KDE crash process overview + coredump)19 comments · 2026-03-09
Discussions
#4719is "Available in WowBox64." in docs/USAGE.md ONLY wowbox64 or in box64 AND wowbox64?0 comments · 2026-11-15#4298Potential task for Wine + Box86/64 developer1 comments · 2026-08-27#4128Why does Box64 tracing stop after my_execv() on x86_64?1 comments · 2026-07-27#3976Box32: x86 LD_PRELOAD dropped as ELFCLASS32 inside a system() call - expected?3 comments · 2026-06-22#3962Can Termux with proot and box64 run Linux Unity games?3 comments · 2026-06-18#3947box64 behavior after execv(wine) on x86_64 vs ARM641 comments · 2026-06-14#3918LD_PRELOAD1 comments · 2026-05-29#3881Box64 Trace Stops After my_execv Execution1 comments · 2026-05-22
Latest release
v0.4.4 v0.4.4 2026-08-02What'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