Docs · Bắt đầu

Cài đặt

1VMTool cần gì, cách cài, và tại sao app phải được ký theo cách cụ thể.

1VMTool là một ứng dụng duy nhất. Không có runtime cài kèm, không hypervisor tải về, không trình quản lý gói.

Requirements

MacApple silicon. Không có bản Intel.
macOS26 trở lên.
DiskĐủ cho các máy bạn tạo. Đĩa sparse, tăng khi guest ghi chứ không cấp
phát trước.
Everything elseKhông gì. Không QEMU, Homebrew, Docker, kernel extension.

Yêu cầu Apple silicon không phải lựa chọn đóng gói. Cả hai engine chạy mã guest native trên CPU, nên guest phải ARM64. Không có giả lập tập lệnh nước ngoài, nên không hỗ trợ guest x86 trên Mac nào.

Install

Kéo 1VM.app vào /Applications và mở. Lần đầu macOS xác minh chữ ký và notarization; sau đó mở ngay, kể cả không mạng.

Dòng lệnh

1vm nằm trong app bundle để hai giao diện không lệch nhau. Liên kết vào PATH:

ln -sf /Applications/1VM.app/Contents/MacOS/1vm /usr/local/bin/1vm
1vm --version

Mọi thứ app làm, 1vm cũng làm — xem The 1vm command line.

Tại sao chữ ký quan trọng

App phải mang entitlement com.apple.security.virtualization nếu không mọi máy không khởi động. Đây là yêu cầu Apple cho process dùng Virtualization.framework, và engine first-party cần thêm entitlement hypervisor.

Hệ quả thực tế: đừng di chuyển binary ra khỏi bundle, đừng strip chữ ký. Build từ source thì script đóng gói ký trong quá trình build chứ không phải bước phát hành, để build local không bị hỏng bí ẩn.

Máy lưu ở đâu

Mặc định máy nằm trong thư mục home dưới dạng thư viện thư mục. Đặt ONEVM_HOME để giữ ở chỗ khác — SSD ngoài chẳng hạn:

export ONEVM_HOME=/Volumes/Fast/vms

Mỗi máy là một thư mục tự chứa. Xem The VM bundle.

Kiểm tra host

1vm doctor báo host, entitlement, thư viện và cả hai engine; 1vm capabilities in Mac cụ thể này làm và không làm gì — ảo hóa lồng nhau chẳng hạn được phát hiện tính năng chứ không giả định.

1vm doctor
1vm capabilities