Hướng dẫn Script v1.2

Hướng dẫn cài đặt WinBoat

Toàn bộ quy trình từ A→Z: kiểm tra hệ thống, chạy script, đến mở WinBoat lần đầu.

! Trước khi cài đặt

⚠️ Quan trọng — Đọc kỹ trước khi chạy

Script cần chạy với quyền sudo/root · Chỉ hỗ trợ Linux Mint 22.x (Xia, Wilma, Virginia) và Ubuntu/Debian · CPU phải bật VT-x (Intel) hoặc AMD-V trong BIOS/UEFI · Cần ít nhất 32 GB dung lượng trống · Internet ổn định trong suốt quá trình.

Kiểm tra CPU có hỗ trợ ảo hóa không:

bash 
# Kết quả > 0 = OK | = 0 = chưa bật VT-x trong BIOS
grep -E -c "(vmx|svm)" /proc/cpuinfo
Nếu kết quả = 0: Vào BIOS/UEFI, bật Intel Virtualization Technology hoặc AMD-V / SVM Mode, Save & reboot.

1 Cài đặt nhanh — 1 lệnh

Lệnh này tải script mới nhất và cài với Docker (khuyến nghị):

terminal 
# Mặc định: menu tương tác
curl -fsSL https://winboat.pages.dev/install.sh | sudo bash

# Hoặc cài thẳng Docker backend
curl -fsSL https://winboat.pages.dev/install.sh | sudo bash -s -- install-docker

# Hoặc Podman backend
curl -fsSL https://winboat.pages.dev/install.sh | sudo bash -s -- install-podman
Script sẽ hiển thị menu tương tác nếu không truyền tham số. Thời gian: 10–20 phút tùy tốc độ mạng.

2 Cài thủ công (xem trước script)

Cách an toàn nhất — tải về, xem nội dung, rồi mới chạy:

terminal 
# 1. Tải script về
wget https://winboat.pages.dev/install.sh

# 2. Xem nội dung trước khi chạy (khuyến nghị)
cat install.sh

# 3. Cấp quyền và chạy
chmod +x install.sh && sudo ./install.sh

Tham số dòng lệnh:

LệnhMô tả
sudo ./install.shMenu tương tác (mặc định)
sudo ./install.sh install-dockerCài với Docker backend
sudo ./install.sh install-podmanCài với Podman backend
sudo ./install.sh uninstallGỡ bỏ hoàn toàn
sudo ./install.sh --helpHiển thị trợ giúp

3 Docker hay Podman?

🐳 Docker
Khuyến nghị
  • ✓ Ổn định, WinBoat tương thích tốt nhất
  • ✓ Cộng đồng lớn, dễ troubleshoot
  • ✓ Tài liệu phong phú
  • ✗ Daemon chạy với quyền root
  • ✗ Tốn tài nguyên hơn một chút
📦 Podman
Rootless
  • ✓ Không cần daemon root
  • ✓ Bảo mật theo mô hình rootless
  • ✓ Tích hợp tốt systemd user
  • ✗ Một số tính năng WinBoat có thể bị hạn chế
  • ✗ Cấu hình phức tạp hơn

✓ Sau khi cài xong

⚠️ Bắt buộc: Đăng xuất và đăng nhập lại
Script đã thêm user vào group docker và kvm. Thay đổi này chỉ có hiệu lực sau khi bạn đăng xuất/đăng nhập lại (hoặc reboot).
  • Bước 1: Đăng xuất và đăng nhập lại với tài khoản của bạn
  • Bước 2: Nhấp đôi icon WinBoat trên Desktop, hoặc gõ winboat trong Terminal
  • Bước 3: Lần đầu WinBoat sẽ hướng dẫn bạn tải Windows ISO và cài đặt VM
  • Xem thêm: Hướng dẫn cài Windows →

Test nhanh nhóm docker sau khi cài (không cần logout):

bash 
newgrp docker && winboat

✗ Gỡ bỏ WinBoat

⚠️ Cảnh báo: Thao tác này xóa WinBoat, dữ liệu Windows VM, container và shortcut. Không thể hoàn tác!
bash 
# Gỡ bỏ qua tham số
sudo ./install.sh uninstall

# Hoặc qua menu tương tác (chọn option 3)
sudo ./install.sh

📋 Xem log file

bash 
# Log mới nhất
ls -la /var/log/winboat-manager-*.log

# Xem nội dung log
cat /var/log/winboat-manager-YYYYMMDD-HHMMSS.log

# Lọc lỗi và cảnh báo
grep -E '(ERR|WARN)' /var/log/winboat-manager-*.log