QEMU 版本取决于你安装的包而非 APK 版本；官方 3dfx 补丁 QEMU 仅提供 arm64-v8a 与 x86_64，ARMv7 和 32 位 x86 用 Alpine 官方标准包；首次设置需联网下载 QEMU 并预留足够存储空间解压环境与客户磁盘
Vectras-VM-Android
xoureldeenGPL-2.0活跃维护基于 QEMU 的 Android 虚拟机应用，让你在手机上直接跑 Linux 等完整操作系统，适合移动端做轻量虚拟化实验。
It's a Virtual Machine App for Android Which is Based on QEMU
4.5.0-3dfx发布于 2026-10-08 20:09 UTC2,784star +3 / 7 天249fork同步于 2026-11-10 17:44 UTC
从 GitHub Releases 下载对应架构的 APK（不确定选 universal）安装并打开，按提示完成首次设置 硬件要求按 README 说明
Android 6.0 起，最低 3GB RAM（1GB 可用）；推荐 Android 8.1 起、8GB RAM（3GB 可用）、64 位系统、骁龙 855 或更强，并建议配散热。README 未给出显存要求。
基于 QEMU 的安卓虚拟机应用，可在手机或平板上创建并运行客户操作系统
基于 QEMU 的 Android 虚拟机应用，让你在手机上直接跑 Linux 等完整操作系统，适合移动端做轻量虚拟化实验。
核心能力
- 创建并配置 QEMU 虚拟机的内存、存储与启动介质
- 导入导出 .cvbi ROM 包，也可用自有磁盘镜像
- 内置 ROM Store 与 Software Store 下载内容
- 通过 PROOT 提供 Alpine Linux 环境与集成终端
- 支持在线下载或本地选择 QEMU 包，ARM64/x86_64 有 3dfx 补丁版
容易踩的坑
内容由模型根据 README 生成，可能不完整或不准确，以官方文档为准。看原文 README
- 4.5.0-3dfxv4.5.0-3dfx最新正式版2026-10-08 · 2026-10-08 20:09 UTC
Vectras VM 4.5.0-3dfx — Github/Community Version
This release is functionally unchanged from 4.4.9. It fixes server and download configuration issues and updates the branding for the GitHub Community Version. No new emulation features are introduced.
🔧 Changes
- Fixed server links and online resource configuration.
- Updated branding for the Community Version.
🎮 3dfx Support
Our 3dfx-patched QEMU builds are currently available only for ARM64 (
arm64-v8a) and x86_64 devices.ARMv7 (
armeabi-v7a) and 32-bit x86 devices use standard QEMU without the 3dfx modification and currently do not support 3dfx.Download 3dfx-Wrappers for 4.1.1
Other versions: 3dfx Wrappers
📥 Manual QEMU Downloads
Download the archive matching your Android device’s architecture, then choose Select QEMU during setup:
For ARMv7 and 32-bit x86, setup installs standard QEMU through Alpine when the corresponding archive link in the setup JSON is empty.
- 4.4.02026-07-19 · 2026-07-19 08:46 UTC
查看更新说明
[!TIP] This is the stable version recommended for all users.
- Improved system update.
- Added error reporting when virtual drive creation fails.
- Automatically resumes opening the X11 screen after missing packages have been installed.
- Fixed an issue with the virtual machine startup dialog getting stuck.
- Fixed an issue when selecting an invalid file in the virtual machine control dialog.
- Fixed a failure to check if the device supports 64-bit.
- Added a check for available Google Play services.
- Improved checking for broken virtual machine listings.
- New Terminal2.
- Cleaned up unnecessary resources and assets.
- Improved detection of whether QEMU returns an error.
- Fixed the issue of being unable to insert or change optical discs, floppy drives, and memory cards when filenames contained spaces.
- Added equalizer.
- Bubbles on the built-in VNC screen will automatically fade when there is no interaction.
- The default setting for automatically switching to external mouse mode on the built-in VNC screen is now off.
- Fixed the issue of sending incorrect characters that required Shift when using Send text in the built-in VNC display.
- Added a built-in File picker.
- Open source licenses have been added.
- New virtual machine creator interface.
- Network card options have been added.
- Improved Chinese language support (Thanks to @power690 for the contribution) (https://github.com/xoureldeen/Vectras-VM-Android/pull/664) (https://github.com/xoureldeen/Vectras-VM-Android/pull/689).
- Fixed an issue where the virtual machine creator crashed after the Vectras VM was freed from memory and reopened.
- Fixed the issue where Ctrl, Alt, and Windows keys were not working on the built-in VNC screen.
- Fixed the inability to type characters requiring Shift when typing directly on the built-in VNC screen.
- Added brightness adjustment for the built-in VNC screen.
- Added volume adjustment for the virtual machine.
- Added a Machine type option.
- Added a Nested virtualization option.
- Improved the process of not adding machine type, processor, symmetric multiprocessing, and memory parameters when the expansion parameter already includes them.
- Added optical disc creation from a folder.
- Added folder selection for the built-in file picker.
- Added folder selection to save using the built-in file picker when exporting the virtual machine.
- Fixed issues when exporting the virtual machine with missing configurations.
- Added conversion and folder path retrieval for FileUtils.
- Added support for Termux (terminal-emulator) for 32-bit and x86_64.
- Improved Terminal View Bottom Sheet.
- Removed old Terminal (first version).
- Fixed other minor issues.
- 4.3.02026-06-29 · 2026-06-29 07:00 UTC
查看更新说明
[!TIP] This is the stable version recommended for all users.
- Improved Settings.
- Added option to receive notifications about suggestions and tips.
- Added support for Qemu 7.2.22-3dfx.
- Fixed the issue where sound wouldn't play when returning to the virtual machine.
- Shared Folder will now check for capacity when the virtual machine starts and is using Shared Folder.
- Removed the warning when using Shared Folders with i386.
- Removed the warning when using the IDE for ARM64.
- Removed the option to edit the virtual machine while it's running.
- Updated the missing package warning dialog.
- The built-in X11 display now works with Android 14+.
- Added the option to use the built-in X11 display or the Termux:X11 app.
- Added the option to toggle the blur effect.
- Added the ability to hide all buttons on the built-in X11 display.
- Fixed the issue where the app wouldn't respond when the virtual machine was using Shared Folder.
- New VM options dialog.
- Added a Cleanup option.
- Fixed the issue where the virtual machine startup dialog wouldn't close when the virtual machine failed to start.
- Fixed the issue with the virtual machine list.
- Fixed the issue when opening links in Rom info.
- Removed the img file creation size limit.
- Several minor interface improvements.
- Faster return to virtual machine.
- Fixed the frozen virtual machine startup dialog when using X11.
- Added audio support for the built-in X11 display.
- Improved notifications.
- Fixed an issue with the confusing virtual machine control dialog box.
- Fixed the frozen virtual machine startup dialog box.
- Added marking of content containing advertisements.
- Added select and display of the virtual machine control dialog box to the built-in X11 screen.
- Removed the quick software launch shortcut button from the built-in X11 screen.
- Added a blur effect to the built-in X11 screen.
- Increased the number of bits per pixel from 16 to 32 for the built-in VNC display, improving image quality.
- Added search filter (https://github.com/AnBui2004/Vectras-VM-Emu-Android/issues/79).
- Added random suggestions.
- Added search settings.
- Improved support for external mouse in the built-in VNC display.
- Added an option to automatically switch to external mouse (https://github.com/xoureldeen/Vectras-VM-Android/issues/627) (https://github.com/xoureldeen/Vectras-VM-Android/issues/669).
- Added an option to reset the default UEFI/BIOS.
- No longer add memory capacity setting param when the VM's QEMU params are already set.
- Added Korean language support (Thanks to @sampple-korea for the contribution) (https://github.com/xoureldeen/Vectras-VM-Android/pull/661).
- Fixed the black screen issue when returning to the built-in VNC screen.
- Added bubble to hide and show buttons when using an external mouse.
- The built-in VNC display has been improved.
- Bugs fixed.
- 4.2.02026-05-22 · 2026-05-22 16:48 UTC
查看更新说明
[!TIP] This is the stable version recommended for all users.
- Support for higher refresh rates for VNC.
- Updated 3dfx for Qemu.
- Added a parameter to set the refresh rate for VNC in Qemu.
- Added toggle for Edge-to-Edge in VNC.
- Fixed the issue of overlapping multiple audio sources in VNC.
- Added screenshot animation for VNC.
- Added press and hold an item in the Log to copy it.
- Added pinch-to-zoom functionality for VNC.
- Added quick switching between running virtual machines to the VNC screen.
- Removed the option button from the virtual machine list, replaced by a long press.
- Fixed issues where other virtual machines would unexpectedly shut down when the first one was shut down.
- Improved the interface.
- Added Rom store link with An Bui app.
- Added a second hard drive option.
- Improved file management when creating and editing virtual machines.
- Optical drives now allow selecting files with invalid formats.
- Removed the hard drive and optical drive priority marking.
- Fixed the issue of shutting down all virtual machines when only shutting down one in X11.
- Floppy drive option has been added.
- Added feature to prevent reusing a file in multiple locations within the virtual machine.
- Fixed issue preventing the creation and editing of virtual machines from Param Notebook.
- Added high-quality image option for VNC.
- Added option to completely hide control buttons on the VNC screen.
- Added battery emulation.
- Added secondary optical drive.
- Improved the virtual machine bootloader.
- Fixed the issue where the socket file was not cleaned up after the virtual machine shut down.
- Fixed other bugs.
- 4.1.02026-05-02 · 2026-05-02 14:20 UTC
查看更新说明
[!TIP] This is the stable version recommended for all users.
- Fixed the issue where log files were not created when running virtual machines with X11.
- Fixed the issue where the virtual machine startup dialog did not close when the Termux:X11 installation prompt dialog appeared.
- Improved VNC display.
- Fixed the issue where ISO files were not accepted when the file extension was capitalized.
- Fixed crash issue when selecting files.
- Added a stretch mode to fit the screen for VNC.
- Fixed the crash issue when dragging and dropping files.
- Added the Use default BIOS/UEFI option in the virtual machine editing and creation settings.
- Added a restriction when selecting the output save directory as the virtual machine's own directory.
- Fixed the issue of the virtual machine control panel dialog freezing.
- Fixed the issue of creating unused virtual machine directories.
- Added automatic cleanup of empty directories and files in the virtual machine directory.
- Removed the Hard drive interface, Boot from, Custom params, and Use default BIOS/UEFI options in the general Qemu settings.
- VNC is now the default for Android 13 and below.
- Added the Shared Folder option for creating and editing virtual machines.
- Improved the hard disk creation tool.
- i386 can now use Shared Folder.
- Removed the Shared Folder and UI environment options from the Qemu general settings.
- Cores and Threads options have been added.
- Gets more accurate CPU information.
- Bugs fixed.
用户点评
登录用户的真实使用记录，可按版本和硬件筛选共 0 条
还没有人点评。第一个说出真实体验的人最有价值。
🪴 Vectras VM Github
🌱 Community Version for Android
Vectras VM is a QEMU-based virtual machine app for Android. Create and manage virtual machines, import prepared ROM packages, and experiment with guest operating systems from your phone or tablet.
This is the original Vectras VM repository, home of the open-source GitHub Community Version. The Play Store edition is a separate product with a different runtime and a simplified experience.
📑 Contents
- Features
- Device compatibility
- Installation
- First-time setup
- ROMs and software
- Online resources
- Play Store edition
- Build from source
- Community and contributions
- License and policies
- Acknowledgements
✨ Features
- Create and configure QEMU virtual machines, including their memory, storage, and boot media.
- Import and export
.cvbiROM packages, or use your own disk images and installation media. - Browse the ROM Store and Software Store for downloadable content.
- Use the bundled bootstrap and Alpine Linux environment through PROOT, with an integrated terminal.
- Choose an online QEMU package or supply a compatible local archive when available.
- Use supported graphics options, including 3dfx with a suitable QEMU build and guest configuration.
The QEMU version depends on the package you install; it is not fixed by the APK version.
📱 Device Compatibility
Works fine on devices manufactured in 2021 or later and devices equipped with Snapdragon 855 CPU or better. You can try running Vectras VM on unsupported devices, but we cannot guarantee stability or support. Here are the devices tested:
| Brands | Compatibility status |
|---|---|
| Samsung | ⭐⭐⭐⭐⭐ |
| Google Pixel | ⭐⭐⭐⭐⭐ |
| Xiaomi | ⭐⭐⭐⭐⭐ |
| Redmi | ⭐⭐⭐⭐⭐ |
| Poco | ⭐⭐⭐⭐⭐ |
| ZTE | ⭐⭐⭐⭐ |
| RedMagic | ⭐⭐⭐⭐ |
| Oppo | ⭐⭐⭐ |
| Realme | ⭐⭐⭐ |
| OnePlus | ⭐⭐ |
| vivo | ⭐⭐ |
| IQOO | ⭐⭐ |
| Huawei | ⭐ |
| Honor | ⭐ |
⚡ Minimum System Requirements
- Android 6.0 and up.
- 3GB RAM (1GB of free RAM).
- A good processor.
💡 Recommended System Requirements
- Android 8.1 and up.
- 8GB RAM (3GB of free RAM).
- CPU and Android OS support 64-bit.
- Snapdragon 855 CPU or better.
- Integrated or removable cooling system (if running operating systems from 2010 to present).
[!TIP] If the OS you are trying to emulate crashes, try using an older version.
📥 Installation
Download a Community Version APK from the GitHub Releases page.
- Choose the APK matching your Android device's CPU architecture, or choose
universalif you are unsure. - Allow installation from the app you use to open the APK when Android asks.
- Install Vectras VM and open it to complete the first-time setup below.
Release filenames follow this pattern: vectras-vm-github-<architecture>-<versionCode>.apk.
| APK architecture | Package |
|---|---|
| Universal | vectras-vm-github-universal-<versionCode>.apk |
| ARM64 | vectras-vm-github-arm64-v8a-<versionCode>.apk |
| ARM 32-bit | vectras-vm-github-armeabi-v7a-<versionCode>.apk |
| x86 | vectras-vm-github-x86-<versionCode>.apk |
| x86-64 | vectras-vm-github-x86_64-<versionCode>.apk |
versionCode is the numeric build identifier, not the dotted app version. The APK architecture describes your Android device, not the architecture of the guest operating system you want to run.
An alternative download listing is available on OpenAPK. Use GitHub Releases as the reference for this repository's builds and release notes.
🚀 First-time setup
The Community Version uses the bootstrap and Alpine Linux environment bundled in the APK. The app extracts this environment during setup, then installs QEMU using the path for your device architecture.
Our official 3dfx-patched QEMU builds are currently available only for ARM64 (arm64-v8a) and x86_64. ARMv7 (armeabi-v7a) and 32-bit x86 use standard official QEMU packages from Alpine, without the 3dfx modification, when their archive links in setupfiles.json are empty.
When prompted, choose one of the two QEMU setup options:
- Online QEMU: fetch the download configuration from the bucket repository and download the package specified for your device architecture. An internet connection and an available package link are required.
- Select QEMU: choose a compatible QEMU
.tar.gzarchive already saved on your device, for example in Downloads. Use a package intended for your device architecture and the bundled Alpine environment.
Allow extraction and setup to finish before starting a virtual machine. Keep enough free storage for the extracted environment, the QEMU package, and your guest disks.
💿 ROMs and software
The ROM Store provides a catalog of prepared ROM packages. You can also import a .cvbi file that you have downloaded or exported yourself.
For a custom virtual machine, supply your own disk image or installation media and configure the guest architecture, memory, drives, and boot settings. The Software Store provides additional downloadable media and tools; attach installation ISOs as CD/DVD media in the virtual machine configuration when appropriate.
Back up important guest disks and exported packages before changing their configuration or replacing files. Only download and use operating systems and software that you are authorized to use; a store listing does not grant a license to third-party content.
🌐 Online resources
The app's update, ROM Store, Software Store, and QEMU setup metadata are maintained in vectras-vm-bucket/web/data.
| Metadata file | Purpose |
|---|---|
setupfiles.json | QEMU package download configuration |
vroms-store.json | ROM Store catalog |
software-store.json | Software Store catalog |
UpdateConfig.json | App update metadata, when published |
The app reads these JSON files through GitHub's raw-content URLs. Downloadable archives and disk images are separate assets linked from the JSON, including files hosted in GitHub Releases. Updating a catalog does not require embedding its download files in this source repository.
🛒 Play Store edition
The Play Store edition is a separate, paid, simplified ui version of Vectras VM. It runs QEMU 10 natively on Android with Spice Client instead of legacy vnc, rather than using the PROOT-based runtime of the GitHub Community Version.
This repository and its installation instructions cover the Community Version. The two editions have different runtimes and setup flows; their features and requirements should not be assumed to be identical.
🔧 Build from source
📋 Requirements
- Android Studio with Gradle JDK set to Java 21.
- Android SDK Platform 37 and Build Tools 36.1.0.
- Android NDK 27.3.13750724 and CMake 3.22.1.
- The repository's Gradle wrapper; it currently selects Gradle 9.6.1.
🧩 Android Studio
- Clone this repository and open its root directory in Android Studio.
- Install the required SDK components and select Java 21 as the Gradle JDK.
- Sync the project with Gradle.
- Run
:app:assembleReleasefrom the Gradle tool window's Execute Gradle Task action. For a debug build, run:app:assembleDebuginstead.
Release builds produce a universal APK and the four architecture-specific APKs listed above in app/build/outputs/apk/release/. The universal debug APK is named app-debug.apk and is written to app/build/outputs/apk/debug/.
💻 Command line
With Java 21 configured in your environment, use the wrapper from the repository root:
# Windows
.\gradlew.bat :app:assembleRelease
# Linux / macOS
./gradlew :app:assembleRelease
When distributing your own builds, configure your own release signing key and keep its credentials private. Preserve the project's license notices and the licenses of bundled components.
🤝 Community and contributions
- Report a bug or request a feature.
- Join the Telegram discussion.
- Follow the Telegram channel.
- Join the Discord community.
Bug reports are most useful when they include the app version, device model, Android version, APK architecture, installed QEMU version, relevant VM settings, and steps to reproduce the issue. Remove personal information from logs before sharing them.
Contributions to the app belong in this repository. Catalog and downloadable-content configuration changes belong in the bucket repository.
📜 License and policies
Vectras VM is distributed under the GNU General Public License v2. Third-party components and guest software remain subject to their own licenses.
Read the Terms of Service and Privacy Policy. Both documents are also accessible from the app's About screen.
💖 Acknowledgements
Special thanks to AnbBui2004 for his code contributions and for the time he spent maintaining the GitHub Community Version of Vectras VM. His work and maintenance efforts are appreciated as part of this project's history.
Thanks also to the projects and contributors whose work makes Vectras VM possible:
shadPS4
shadps4-emu·C++
用 C++ 编写的 PlayStation 4 模拟器，支持 Windows、Linux、macOS 和 FreeBSD，让玩家能在电脑上运行 PS4 游戏。
PS4模拟器+4模拟器
34113+292.9kv.0.21.02026-11-10 10:57 UTC
v86
copy·JavaScript
在浏览器里跑完整 x86 PC 的模拟器，带 x86 到 WebAssembly 的 JIT 编译器，可直接启动 Linux 等系统。
x86 模拟器+3模拟器
23672+51.9klatest2026-10-30 21:48 UTC
ish
ish-app·C
在 iOS 设备上跑起 Linux shell 的模拟器，靠用户态 x86 模拟执行命令行工具，让 iPhone/iPad 也能用上熟悉的 Linux 命令环境。
iOS 模拟器+4模拟器
20698+151.6kbuilds/8132026-11-07 00:46 UTC
rpcs3
RPCS3·C++
跨平台的 PlayStation 3 模拟器与调试器，用 C++ 编写，支持 OpenGL 和 Vulkan 渲染，让玩家能在 PC 上运行 PS3 游戏并调试。
PS3模拟器+4模拟器
20388+212.6kv0.0.432026-11-10 11:41 UTC