diff --git a/.gitignore b/.gitignore index 79e4bd7..34a5091 100644 --- a/.gitignore +++ b/.gitignore @@ -45,3 +45,11 @@ DerivedData/ !.dev.vars.example .env* !.env.example + +# ---- Intro video source (Remotion project, renders, soundtrack) ---- +# Only the muted web encodes in landing/assets/ are published; the project +# that produces them stays local. +promo/ + +# ---- Claude Code local settings (launch configs, permissions) ---- +.claude/ diff --git a/CHANGELOG.md b/CHANGELOG.md index c2bdd7f..3c9a1d5 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -10,6 +10,15 @@ are taken from its section here. - Homebrew cask in this repository: `brew tap nextage-soft/dockz https://github.com/nextage-soft/dockz` then `brew install --cask nextage-soft/dockz/dockz`. Releases now also attach a stable-named `DockZ.dmg` that the cask installs. +- Vietnamese README (`README.vi.md`) and website (`/vi/`, with `hreflang` links and a + language switch). +- 34-second intro video on the website (muted, in English and Vietnamese). + +### Changed +- New screenshots (v0.2.1, demo data only) in the README and on the website, including + Monitor and the TLS / Secure Enclave environment editor. +- Architecture diagram no longer claims zero external Swift dependencies (TLS uses Apple's + swift-nio-ssl) and shows Monitor, the VM watchdog and remote engines. ## [0.2.1] - 2026-10-05 diff --git a/README.md b/README.md index 82a6bd4..51ad3f1 100644 --- a/README.md +++ b/README.md @@ -21,6 +21,8 @@ plus a Docker Desktop–style dashboard and Multipass-style Linux machines.

 ·  Signing guide

+

English · Tiếng Việt

+

Features · Why DockZ · @@ -33,6 +35,11 @@ Built entirely on Apple's **Virtualization.framework** — no external runtimes, one Swift dependency (Apple's own swift-nio-ssl, pinned exactly). The engine is exposed to the host as a normal Docker context: `docker`, `docker compose`, and buildx just work. +

+ Watch the 34-second DockZ intro
+ ▶ Watch the 34-second intro +

+

DockZ architecture

@@ -41,11 +48,15 @@ as a normal Docker context: `docker`, `docker compose`, and buildx just work. ## Screenshots -| Containers | Images | -| :---------------------------------------------------: | :------------------------------------------: | -| ![Containers](public/dashboard-containers.png) | ![Images](public/dashboard-images.png) | -| **Machines** | **Settings / About** | -| ![Machines](public/dashboard-machines.png) | ![Settings](public/dashboard-settings.png) | +| Containers | Monitor | +| :---------------------------------------------------: | :---------------------------------------------: | +| ![Containers](public/dashboard-containers.png) | ![Monitor](public/dashboard-monitor.png) | +| **Remote engine over TLS (Secure Enclave key)** | **Machines** | +| ![TLS environment](public/dashboard-environments.png) | ![Machines](public/dashboard-machines.png) | +| **Images** | **Settings / About** | +| ![Images](public/dashboard-images.png) | ![Settings](public/dashboard-settings.png) | + +Screenshots use demo containers and placeholder hosts (`10.0.0.5`, `203.0.113.10`). --- diff --git a/README.vi.md b/README.vi.md new file mode 100644 index 0000000..17b0aa2 --- /dev/null +++ b/README.vi.md @@ -0,0 +1,410 @@ +

+ DockZ — Docker và Linux VM chạy native trên Apple Silicon +

+ +

Ứng dụng trên thanh menu, khởi động dockerd thật bên trong một VM Alpine siêu nhỏ —
+kèm dashboard kiểu Docker Desktop và các máy Linux kiểu Multipass.

+ +

+ latest release + CI + platform + license + dependencies + size +

+ +

+ ⬇️ Tải bản DMG mới nhất +  ·  Website +  ·  Changelog +  ·  Hướng dẫn ký ứng dụng +

+ +

English · Tiếng Việt

+ +

+ Tính năng · + Vì sao chọn DockZ · + Cài đặt · + Sử dụng · + Kiến trúc +

+ +Xây dựng hoàn toàn trên **Virtualization.framework** của Apple — không runtime bên ngoài, +chỉ một dependency Swift (swift-nio-ssl của chính Apple, pin đúng phiên bản). Engine được đưa ra +máy host dưới dạng một Docker context bình thường: `docker`, `docker compose` và buildx chạy ngay. + +

+ Xem video giới thiệu DockZ dài 34 giây
+ ▶ Xem video giới thiệu 34 giây +

+ +

+ Kiến trúc DockZ +

+ +--- + +## Ảnh chụp màn hình + +| Containers | Monitor | +| :---------------------------------------------------: | :---------------------------------------------: | +| ![Containers](public/dashboard-containers.png) | ![Monitor](public/dashboard-monitor.png) | +| **Engine từ xa qua TLS (khoá trong Secure Enclave)** | **Machines** | +| ![TLS environment](public/dashboard-environments.png) | ![Machines](public/dashboard-machines.png) | +| **Images** | **Settings / About** | +| ![Images](public/dashboard-images.png) | ![Settings](public/dashboard-settings.png) | + +Ảnh chụp màn hình dùng container demo và host giả lập (`10.0.0.5`, `203.0.113.10`). + +--- + +## Tính năng + +| | | +| --- | --- | +| 🐳 **Docker engine thật** | `dockerd` chính gốc chạy trong Alpine Linux, được đưa ra dưới dạng context `dockz` — `docker`, `docker compose`, buildx đều chạy được. | +| 🖥️ **Dashboard quản lý** | Phong cách Docker Desktop / Portainer: container, image, volume, network, registry, **stack** compose — form tạo/sửa, log trực tiếp, thống kê, inspect. Mọi danh sách đều có chip lọc phạm vi, tìm kiếm và sắp xếp; container được nhóm theo stack, container bị crash hoặc health check không đạt sẽ được đánh dấu (⌘F / ⌘R / ⌘N). | +| 📊 **Monitor** | CPU, bộ nhớ, network và disk I/O theo thời gian thực cho từng container, các chỉ số sống còn của VM, phân tích dung lượng lưu trữ, và dọn dẹp image, volume và build cache không dùng đến. | +| 🌐 **Nhiều environment** | Quản lý cả các Docker engine khác — host từ xa qua **SSH** hoặc **mutual TLS**, hay socket của một engine khác trên chính máy Mac này — và chuyển mọi tab giữa chúng ngay từ sidebar (⌘1…⌘9). Chỉ quản lý: không join hay chia sẻ gì cả. | +| 🛟 **VM tự phục hồi** | Nếu dockerd ngừng phản hồi hoặc kernel của guest gặp lỗi, DockZ tự khởi động lại VM (có giới hạn để tránh crash loop) và giữ lại log console của những lần boot gần nhất. | +| 📦 **Máy Linux** | VM kiểu Multipass (Alpine / Debian / Ubuntu, ARM64) truy cập qua SSH, kèm template cluster **k3s / k8s** master/node tạo chỉ bằng một cú click. | +| 🚀 **Thiết lập ban đầu trong một cửa sổ** | Lần chạy đầu tiên build guest image trong một VM netboot dùng một lần rồi bỏ, đồng thời cài CLI song song — khi cửa sổ đóng lại, `docker ps` đã chạy được. | +| 🔌 **Tự động port forwarding** | Các cổng TCP + UDP được publish sẽ tự xuất hiện trên `localhost` nhờ theo dõi Docker events API. | +| 📸 **Snapshot VM** | Snapshot copy-on-write APFS tức thì cho ổ đĩa VM, có rollback. | +| 🔄 **Rosetta** | Chạy image `linux/amd64` trên Apple Silicon. | +| ⚙️ **Tuỳ chỉnh được** | Số CPU, bộ nhớ, giới hạn dung lượng đĩa, chia sẻ `$HOME` qua virtiofs, thư mục dữ liệu có thể chuyển chỗ (dùng tốt với SSD gắn ngoài). | +| 🧰 **Docker CLI khi cần** | Không cần Homebrew: tải `docker` + compose bản static chính thức, có kiểm tra checksum; terminal được nối qua một khối cấu hình trong `~/.zshrc` có thể gỡ bỏ, và khối này tự nhường chỗ nếu bạn đã cài Docker riêng. | +| 🪶 **Tối thiểu dependency** | Framework của Apple, code nằm ngay trong repo, và swift-nio-ssl mã nguồn mở của Apple (pin chính xác phiên bản) cho khoá TLS lưu trong Secure Enclave; chỉ cần Command Line Tools là build được. | + +## Vì sao chọn DockZ? + +**Một ứng dụng native 8 MB thay thế cả bộ công cụ**: Docker engine + dashboard kiểu Docker +Desktop + Linux VM kiểu Multipass + môi trường thử nghiệm k3s/k8s — miễn phí, +Apache-2.0, không cần tài khoản, không telemetry, không Electron. + +Điều làm DockZ khác với những cái tên quen thuộc: + +- **Thật sự nhỏ gọn và native.** App bundle chỉ khoảng ~8 MB (bản tải về 3.5 MB), viết bằng Swift/SwiftUI trên + Virtualization.framework của Apple. Không vỏ Electron, không đóng gói kèm node/qemu, không + trình cập nhật chạy nền. Ổ đĩa VM 64 GB là file sparse trên APFS — một engine mới tinh thực tế + chỉ chiếm ~1.3 GB. +- **Tự khởi tạo trên một máy Mac trống trơn.** Bài toán con gà quả trứng kinh điển ("bạn cần + Docker để build image VM cho Docker") đã được giải quyết: lần chạy đầu tiên build guest + image bên trong một VM netboot Alpine dùng một lần rồi bỏ, đồng thời tải song song CLI `docker` + + compose chính thức, có kiểm tra checksum. Không cần Homebrew, không cần mật khẩu admin, + không curl-pipe-bash. +- **`dockerd` thật, không phải bản viết lại.** Tương thích engine 100 % — + buildx, compose, registry, mọi thứ — vì nó *chính là* Docker upstream + chạy trong Alpine. Socket được bắc cầu qua vsock; các cổng được publish tự xuất hiện trên + `localhost` (TCP + UDP). +- **Hai sản phẩm trong một.** Container *và* máy Linux đầy đủ (Alpine, Debian, + Ubuntu) với SSH, cloud-init, clone tức thì bằng APFS, và template k3s/k8s + master/node chỉ một cú click — đáp ứng cả nhu cầu của Docker Desktop *lẫn* Multipass, + dùng chung một mạng NAT nên cluster nhiều node chạy được ngay. +- **Những tiện ích vận hành mà công cụ khác bắt trả phí hoặc bỏ qua**: snapshot VM copy-on-write + APFS có rollback, thư mục dữ liệu có thể chuyển chỗ (chuyển toàn bộ sang SSD gắn ngoài ngay từ + Settings), Rosetta cho image `linux/amd64`, thông tin đăng nhập private registry lưu trong + Keychain, tắt VM nhẹ nhàng (graceful), và file `host.log` dạng văn bản thuần khi bạn muốn + biết chính xác vòng đời VM đã làm gì. +- **Một người có thể tự kiểm tra toàn bộ trong một lần ngồi.** Chỉ một dependency Swift bên ngoài — + swift-nio / swift-nio-ssl của Apple, pin chính xác phiên bản (`Package.resolved`) và + chỉ dùng để các environment TLS có thể giữ khoá trong Secure Enclave. + Mọi thứ còn lại là framework của Apple và code trong repo này. Chỉ cần Command Line Tools + là build được (lần build đầu sẽ tải các package). + +### So sánh (macOS · Apple Silicon · giữa năm 2026) + +| | **DockZ** | Docker Desktop | OrbStack | Colima (Lima) | Multipass | +| -------------------------- | :----------------: | :-------------: | :-------------: | :-------------: | :-------------: | +| 💵 Giấy phép / giá | **Apache 2.0, miễn phí** | 💰 trả phí khi ≥ 250 nhân sự | 💰 mã nguồn đóng, trả phí khi dùng thương mại | MIT, miễn phí | miễn phí (Canonical) | +| 💾 Dung lượng app trên đĩa | **~8 MB** | ~1.5 GB+ | hàng trăm MB | CLI + các dependency của brew | ~350 MB | +| 🎨 Giao diện | SwiftUI native | Electron | native | chỉ có CLI | GUI tối giản | +| 🐳 Docker engine | `dockerd` thật | `dockerd` thật | stack riêng | `dockerd` thật | — | +| 🖥️ Dashboard (container/stack) | ✅ | ✅ | ✅ | ❌ | — | +| 📦 Linux VM đa dụng | ✅ + cloud-init | ❌ | ✅ | qua lima | ✅ | +| ☸️ k8s có sẵn | ✅ k3s/k8s nhiều node | một node | ✅ (k8s) | k3s một node (`--kubernetes`) | ❌ | +| 🔧 Điều kiện cài đặt | **không cần gì** | helper quyền admin | không cần gì | Homebrew | gói cài đặt (pkg) | +| 📸 Snapshot VM + rollback | ✅ APFS CoW | ❌ | ❌ | ❌ | ✅ | +| 🔓 Mã nguồn mở | ✅ hoàn toàn | một phần | ❌ | ✅ | ✅ | + +*Nói thẳng những hạn chế*: DockZ chỉ chạy trên Apple Silicon + macOS 15 trở lên, còn non trẻ, các bản phát hành +chưa được notarize cho đến khi dự án thiết lập xong Developer ID (bạn cần cho phép một lần trong +System Settings), và được tinh chỉnh cho các tình huống phổ biến chứ không phải mọi trường hợp biên. Nếu bạn +cần Mac chip x86, tương đương trên Windows/Linux, hay SLA từ nhà cung cấp, thì các công cụ lâu năm ở trên là +lựa chọn an toàn hơn — đất của DockZ là "mọi thứ một lập trình viên Mac cần, bớt đi sự +cồng kềnh và nỗi lo giấy phép." + +## Yêu cầu hệ thống + +- macOS **15 (Sequoia) trở lên** +- **Apple Silicon** (M1 hoặc mới hơn) +- Command Line Tools hoặc Xcode (để build từ mã nguồn) + +**Không cần Homebrew (tuỳ chọn, xem bên dưới), không cần Docker Desktop, không cần mật khẩu admin.** Dashboard giao tiếp +trực tiếp với engine qua vsock, nên hoàn toàn không cần file thực thi `docker`. Compose stack +và shell của container thì có cần — nếu máy Mac chưa có, DockZ sẽ tải CLI `docker` bản static +chính thức + plugin compose (≈48 MB) vào thư mục dữ liệu riêng của nó, kiểm tra cả hai +với mã SHA-256 đã pin sẵn, đặt `dockz` làm context mặc định, và thêm một +khối cấu hình có điều kiện vào file rc của shell để `docker ps` chạy được trong terminal mới. Việc này +diễn ra tự động trong lần thiết lập đầu tiên (hoặc sau đó từ +**Settings → Docker CLI**). Nếu đã có sẵn `docker` thì DockZ luôn ưu tiên dùng bản đó và +không bao giờ động vào. + +## Cài đặt / Build + +**Homebrew:** + +```bash +brew tap nextage-soft/dockz https://github.com/nextage-soft/dockz +brew install --cask nextage-soft/dockz/dockz +``` + +Cập nhật bằng `brew upgrade --cask --greedy dockz` (cask luôn theo bản phát hành +mới nhất). + +**Tải về:** lấy `DockZ-.dmg` từ +[Releases](https://github.com/nextage-soft/dockz/releases), mở ra và kéo +DockZ vào Applications. Mỗi bản phát hành đều ghi kèm SHA-256 của DMG. Các bản build chưa +được notarize sẽ bị chặn ở lần mở đầu tiên — hãy cho phép DockZ một lần trong **System Settings → +Privacy & Security → Open Anyway**. Để ký DockZ bằng chứng chỉ của riêng bạn, hoặc +để phát hành bản đã ký + notarize, xem +[docs/deployment-guide.md](docs/deployment-guide.md). + +**Build từ mã nguồn:** không cần Xcode đầy đủ — DockZ build bằng Swift Package +Manager và một script đóng gói. + +```bash +# Build + sign the host app → build/DockZ.app +scripts/build-and-bundle-app.sh +open build/DockZ.app + +# Optional: pack it as build/DockZ-.dmg +scripts/make-dmg.sh +``` + +**Phát hành một bản release:** push một tag, ví dụ `v0.2.0`. Workflow *Release* sẽ +chạy test, build, đóng gói DMG (ký + notarize nếu các secret liệt kê ở +đầu `.github/workflows/release.yml` tồn tại) và đính kèm vào một GitHub +Release. Chạy workflow thủ công sẽ build một artifact DMG mà không phát hành. + +Chép `build/DockZ.app` vào `/Applications` để cài đặt. Ở lần mở đầu tiên, DockZ +đề nghị tự build image đĩa cho guest (một VM netboot Alpine dùng một lần rồi bỏ sẽ +dựng nó qua serial console — không cần Docker ở bất kỳ đâu) và cài song song +docker CLI nếu máy Mac chưa có. Các cách chạy không cần giao diện: + +```bash +# Standalone image build (same path the setup window uses): +build/DockZ.app/Contents/MacOS/DockZ build-image +# Or, with any working Docker daemon already available: +guest/build-guest-image.sh # installs /disk.img +# CLI + compose + shell integration without the GUI: +build/DockZ.app/Contents/MacOS/DockZ install-docker-cli +build/DockZ.app/Contents/MacOS/DockZ setup-shell # --remove to undo +``` + +### Ký code (tự làm, không cần tài khoản trả phí) + +Virtualization.framework từ chối khởi động VM nếu app không được ký với +entitlement `com.apple.security.virtualization` +([scripts/dockz.entitlements](scripts/dockz.entitlements)). Script build +tự động ký, chọn identity đầu tiên tìm thấy theo thứ tự: + +1. `$SIGN_IDENTITY` nếu bạn export biến này, +2. nếu không, chứng chỉ **Apple Development** đầu tiên có trên máy, +3. nếu không nữa, chữ ký **ad-hoc** (`-`). + +Cả ba đều chạy VM bình thường. Khác biệt là: chứng chỉ Apple Development +cho app một danh tính ổn định qua các lần build lại (macOS ghi nhớ các quyền đã cấp +như Local Network), còn ad-hoc thì vô danh — không gây hại gì, nhưng macOS +coi mỗi lần build lại là một app hoàn toàn mới. Bạn có thể tạo chứng chỉ Apple Development +miễn phí (không cần gói thành viên trả phí): Xcode → Settings → Accounts → thêm +Apple ID của bạn → Manage Certificates → **+** → Apple Development. + +```bash +# See what's available, then pin one explicitly if you like: +security find-identity -v -p codesigning +SIGN_IDENTITY="Apple Development: you@example.com (TEAMID)" scripts/build-and-bundle-app.sh +``` + +**Chạy hoặc ký lại một bản release đã tải về** ("Open Anyway" của Gatekeeper, +`xattr`, ký bằng chứng chỉ của riêng bạn mà vẫn giữ entitlement +virtualization) được hướng dẫn từng bước trong +[docs/deployment-guide.md](docs/deployment-guide.md). Kiểm tra nhanh xem một bản +đã ký có boot được VM hay không: + +```bash +codesign -d --entitlements - /Applications/DockZ.app # must list …virtualization +``` + +## Sử dụng + +```bash +docker run --rm hello-world +docker run --rm -p 8080:80 nginx # reachable at http://localhost:8080 +``` + +Nếu DockZ đã cài CLI, `dockz` sẵn là context mặc định. Nếu bạn dùng +bản docker tự cài, chỉ cần chuyển một lần: `docker context use dockz` (hoặc theo từng lệnh: +`docker --context dockz …`). + +Mở dashboard từ biểu tượng trên thanh menu (**Open Dashboard…**, ⌘D) để quản lý +container, image, volume, network, registry, stack và machine; theo dõi +CPU, bộ nhớ và I/O của từng container (và dọn dẹp dung lượng đĩa) trong **Monitor**; thêm +các Docker engine khác trong **Environments** và chuyển sang chúng từ đầu +sidebar (⌘1…⌘9). Mọi danh sách đều có bộ lọc và tìm kiếm (⌘F, ⌘R để làm mới, +⌘N để tạo mới). **Settings** chứa tài nguyên VM, múi giờ, snapshot, thư mục +dữ liệu, và — trong mục **Advanced** — file `daemon.json` của engine. + +## Kiến trúc + +- **Host app (Swift, thanh menu)** — `sources/dockz/` + - VZ VM: EFI boot → ổ đĩa virtio-blk, mạng NAT, chia sẻ `$HOME` qua virtiofs tại + đúng đường dẫn đó (bind mount nhanh), vsock, chia sẻ thư mục Rosetta, memory + balloon + entropy, serial console → `console.log`. + - `docker.sock` — mỗi kết nối từ client được bắc cầu qua vsock cổng 2375 tới + unix socket của `dockerd` trong guest. + - Port forwarding — đăng ký lắng nghe API `/events` của Docker, liệt kê các cổng + TCP/UDP được publish, và phản chiếu chúng lên `localhost`, chuyển tiếp tới IP của guest. + - Machines — ISO seed cloud-init (NoCloud) cho cloud image; clone APFS để + tạo tức thì; đọc DHCP lease để lấy IP của machine. + - Khởi tạo lần đầu — một **VM builder netboot** Alpine dùng một lần rồi bỏ, được điều khiển qua + serial console của nó bằng một expect engine nhỏ (`serial-expect.swift`), + sẽ phân vùng và dựng `disk.img` từ đầu; script dựng máy phát ra + các marker `DOCKZ-STEP` để điều khiển thanh tiến trình của cửa sổ thiết lập. Song + song đó, trình cài CLI tải `docker` + compose (pin SHA-256) và + nối vào file rc của shell người dùng. + - Chẩn đoán — mọi sự kiện trong vòng đời VM (đổi trạng thái, đường poweroff, + dừng cưỡng bức) đều được ghi nối vào `host.log` nằm cạnh `console.log` của guest. +- **Guest (Alpine)** — `guest/` + - Kernel `linux-virt`, grub arm64-efi (standalone, `--removable`), OpenRC, + `dockerd` + plugin compose. + - Các agent chỉ là `socat`: vsock 2375 → `/var/run/docker.sock`, 2376 → báo + IP của `eth0`, 2377 → poweroff nhẹ nhàng (graceful), 2378 → debug shell. + - Lần boot đầu tiên mở rộng phân vùng root để lấp đầy ổ đĩa (sparse). + - Đăng ký binfmt cho Rosetta khi host chia sẻ tag `rosetta`. + +### Environments (các Docker engine khác) + +Bộ chuyển environment trên sidebar trỏ mọi tab — Monitor, Containers, +Stacks, Images, Volumes, Networks — sang một engine khác. DockZ luôn mở ở +**Local**; environment từ xa có thanh tiêu đề màu cam và các hộp xác nhận thao tác +phá huỷ đều ghi rõ tên host. Machines chỉ dùng ở Local, và Settings luôn +cấu hình VM của chính máy Mac này. + +| Loại | Bạn nhập gì | DockZ kết nối thế nào | +| --- | --- | --- | +| **SSH** | `user@host`, hoặc một alias trong `~/.ssh/config` | `/usr/bin/ssh … docker system dial-stdio`, giống `docker -H ssh://`. Dùng key, ssh-agent và ssh config của bạn (không lưu mật khẩu, chỉ xác thực bằng key). User ở máy từ xa phải chạy được `docker`. | +| **TLS** | host, port (2376), `ca.pem` của server, sau đó là chứng chỉ cho khoá của máy Mac này | Mutual TLS (swift-nio-ssl) tới một engine `dockerd --tlsverify`; chỉ tin CA đó và có kiểm tra tên/IP của server. | +| **Socket** | đường dẫn tới một unix socket | Một engine khác trên chính máy Mac này (Colima, OrbStack, Docker Desktop). | + +Hộp thoại Add Environment có kèm hướng dẫn thiết lập từng bước cho mỗi loại +(cũng có thể in ra bằng `DockZ env-guide [port]`) và +giải thích nguyên nhân khi kết nối thất bại. + +**Khoá TLS không bao giờ rời khỏi máy Mac.** DockZ tạo client key của mỗi environment TLS +bên trong Secure Enclave của máy Mac và chỉ hiển thị một yêu cầu ký chứng chỉ +(CSR); quản trị viên server ký nó bằng CA của họ (một lệnh duy nhất, hiển thị trong +hộp thoại) rồi dán chứng chỉ trở lại. Hệ quả: + +- Không hề tồn tại file private key nào — không trong thư mục của DockZ, không trên server, không + trong `~/Downloads`. Sao chép dữ liệu của DockZ, một bản backup hay cả ổ đĩa cũng không thu được gì + dùng được; `client-key.se` chỉ là một handle mà chỉ con chip của chính máy Mac này dùng được. +- Dùng khoá cần Touch ID (hoặc mật khẩu đăng nhập), do con chip bắt buộc. + Một lần xác nhận sẽ mở khoá environment cho đến khi màn hình khoá, máy Mac + ngủ hoặc bạn chuyển sang environment khác; việc liệt kê environment không bao giờ hỏi xác nhận. +- Chứng chỉ client có hạn 90 ngày (dockerd không thể thu hồi riêng một chứng chỉ); + gia hạn ngay từ hộp thoại. Máy Mac bị mất sẽ bị cắt quyền truy cập bằng cách thay CA của server. +- Docker CLI (compose, Shell) truy cập environment TLS qua một relay socket + riêng tư mà DockZ phục vụ trong lúc environment đó đang được chọn (`$TMPDIR/dockz-cli/`, 0600) + — CLI không bao giờ nhận được chứng chỉ hay khoá. +- App được ký với hardened runtime, nên code khác không thể bị + inject vào DockZ để mượn quyền truy cập của nó. + +Engine Windows cũng dùng được — container Windows được liệt kê và quản lý qua +cùng API đó; các tuỳ chọn chỉ dành cho Linux sẽ được ẩn đi với chúng. + +Kiểm tra một environment từ terminal: `DockZ env-probe ssh user@host [port]` +(hoặc `tls [--relay SECONDS]`, `socket `). Bản probe +TLS đọc `ca.pem`, `cert.pem` và một `key.pem` từ thư mục được chỉ định — +nó dành cho các engine thử nghiệm. + +## Tệp dữ liệu + +Mọi thứ nằm trong thư mục dữ liệu (mặc định `~/.dockz/`, có thể chuyển chỗ trong +Settings): + +| Tệp / thư mục | Mục đích | +| -------------- | -------------------------------------------------------------- | +| `disk.img` | Ổ đĩa VM (sparse; tăng dần tới giới hạn dung lượng đĩa đã cấu hình) | +| `docker.sock` | Docker socket phía host (bắc cầu tới guest qua vsock) | +| `console.log` | Serial console của guest — nơi đầu tiên cần xem khi debug quá trình boot | +| `host.log` | Log vòng đời VM phía host (đổi trạng thái, đường stop/poweroff) | +| `config.json` | cpus, memoryGiB, diskLimitGB, shareHomeDirectory, enableRosetta | +| `bin/`, `docker-config/` | Docker CLI do DockZ quản lý + plugin compose và các context của nó | +| `environments.json`, `environments//` | Các Docker engine khác (0600); `ca.pem` / `cert.pem` công khai của environment TLS và handle khoá Secure Enclave `client-key.se` | +| `snapshots/` | Snapshot ổ đĩa VM + `index.json` | +| `machines/` | Máy Linux kiểu Multipass (`machines/bases/` = image của các distro) | + +## Kiểm thử + +Command Line Tools không đi kèm XCTest, nên test được chạy dưới dạng một subcommand +chạy ngay trong tiến trình của file thực thi app: + +```bash +swift run -c release DockzApp test # exits non-zero on failure +``` + +CI chạy đúng lệnh này trên runner `macos-15` (`.github/workflows/ci.yml`). + +## Ghi chú + +- App phải được ký với entitlement `com.apple.security.virtualization`, + nếu không VM sẽ không khởi động — `scripts/build-and-bundle-app.sh` đã lo việc + này (chứng chỉ Apple Development, hoặc ad-hoc nếu không có). +- Build lại guest image sẽ xoá sạch dữ liệu Docker (có chặn bằng `--force`). +- DMG của bản release chỉ được notarize khi repository có Developer ID và + các secret cho notary ([docs/deployment-guide.md](docs/deployment-guide.md)); + nếu không, hãy cho phép DockZ một lần trong System Settings → Privacy & Security, hoặc chạy + `xattr -dr com.apple.quarantine /Applications/DockZ.app`. + +## Câu hỏi thường gặp + +**DockZ có phải là lựa chọn thay thế Docker Desktop miễn phí cho Mac không?** +Có — miễn phí và theo giấy phép Apache-2.0, không tính phí theo số người dùng cho doanh nghiệp. +Nó chạy Docker Engine thật (`dockerd`) trong một VM Alpine Linux nhẹ trên +Virtualization.framework của Apple. + +**DockZ khác OrbStack hay Colima thế nào?** +OrbStack rất tốt nhưng là mã nguồn đóng và phải trả phí khi dùng thương mại; Colima +miễn phí nhưng chỉ có CLI và cài qua Homebrew. DockZ là ứng dụng native ~8 MB, mã nguồn mở +hoàn toàn, có dashboard giao diện đồ hoạ, không cần Homebrew hay mật khẩu +admin, và còn quản lý được Linux VM đa dụng. Xem +[bảng so sánh](#vì-sao-chọn-dockz). + +**Tôi có chạy được Kubernetes (k3s/k8s) trên đó không?** +Có — tab Machines tạo VM Alpine/Debian/Ubuntu với template k3s hoặc +kubeadm master/node chỉ một cú click; các node dùng chung một mạng NAT, nên cluster +nhiều node chạy được trên một máy Mac duy nhất. + +**`docker compose` / buildx / amd64 có chạy được không?** +Có. Engine là Docker upstream, nên compose, buildx và private registry +hoạt động y hệt như trên Linux. Image `linux/amd64` chạy qua Rosetta. + +**Tôi có cần cài Docker hay Homebrew trước không?** +Không. Lần chạy đầu tiên tự build guest image và tải CLI `docker` + plugin +compose chính thức, có kiểm tra checksum — một máy Mac mới tinh đi từ con số không +đến `docker ps` chỉ trong một cửa sổ. + +## Giấy phép + +DockZ được phát hành theo [Apache License 2.0](LICENSE) — © 2026 The DockZ +Authors. Xem [NOTICE](NOTICE) để biết thông tin ghi công. + +Apache 2.0 được chọn vì điều khoản cấp quyền sáng chế rõ ràng (bảo vệ dự án và +người dùng) và yêu cầu "ghi rõ thay đổi" (state changes) đối với các file đã chỉnh sửa. + +Các guest image mà DockZ build có đóng gói phần mềm theo giấy phép riêng của chúng +(Alpine Linux, Debian, Ubuntu, Docker, k3s, v.v.); những phần mềm đó giữ nguyên giấy phép +upstream tương ứng. diff --git a/landing/assets/architecture.svg b/landing/assets/architecture.svg index 92bd19f..8ae9db5 100644 --- a/landing/assets/architecture.svg +++ b/landing/assets/architecture.svg @@ -37,8 +37,8 @@ DockZ.app (Swift, menu bar) - Dashboard · Machines · Settings · port forwarder - Zero external Swift dependencies + Dashboard · Monitor · Machines · port forwarder · VM watchdog + Remote engines: SSH · TLS (key in Secure Enclave) · socket @@ -70,7 +70,7 @@ vsock 2375 - HTTP/1.1 Docker API + Docker API relay → guest IP diff --git a/landing/assets/dashboard-containers.png b/landing/assets/dashboard-containers.png index e08a22b..6dae961 100644 Binary files a/landing/assets/dashboard-containers.png and b/landing/assets/dashboard-containers.png differ diff --git a/landing/assets/dashboard-environments.png b/landing/assets/dashboard-environments.png new file mode 100644 index 0000000..571a920 Binary files /dev/null and b/landing/assets/dashboard-environments.png differ diff --git a/landing/assets/dashboard-images.png b/landing/assets/dashboard-images.png index 372b480..5f3d482 100644 Binary files a/landing/assets/dashboard-images.png and b/landing/assets/dashboard-images.png differ diff --git a/landing/assets/dashboard-machines.png b/landing/assets/dashboard-machines.png index 601a807..280b4b1 100644 Binary files a/landing/assets/dashboard-machines.png and b/landing/assets/dashboard-machines.png differ diff --git a/landing/assets/dashboard-monitor.png b/landing/assets/dashboard-monitor.png new file mode 100644 index 0000000..b278b0a Binary files /dev/null and b/landing/assets/dashboard-monitor.png differ diff --git a/landing/assets/dashboard-settings.png b/landing/assets/dashboard-settings.png index 7810da3..361868c 100644 Binary files a/landing/assets/dashboard-settings.png and b/landing/assets/dashboard-settings.png differ diff --git a/landing/assets/dockz-intro-en.mp4 b/landing/assets/dockz-intro-en.mp4 new file mode 100644 index 0000000..ffc4158 Binary files /dev/null and b/landing/assets/dockz-intro-en.mp4 differ diff --git a/landing/assets/dockz-intro-poster.jpg b/landing/assets/dockz-intro-poster.jpg new file mode 100644 index 0000000..8a04cfb Binary files /dev/null and b/landing/assets/dockz-intro-poster.jpg differ diff --git a/landing/assets/dockz-intro-vi.mp4 b/landing/assets/dockz-intro-vi.mp4 new file mode 100644 index 0000000..21c8006 Binary files /dev/null and b/landing/assets/dockz-intro-vi.mp4 differ diff --git a/landing/index.html b/landing/index.html index b349e89..b0f45ac 100644 --- a/landing/index.html +++ b/landing/index.html @@ -4,12 +4,15 @@ DockZ — Docker & Linux VMs on Apple Silicon, natively - + + + + - + @@ -17,10 +20,10 @@ - + - + @@ -248,6 +251,18 @@ font-size: 17px; } + /* Intro video */ + #video { padding-top: 0; } + .video-frame { + aspect-ratio: 16 / 9; + border-radius: 18px; + overflow: hidden; + border: 1px solid var(--border); + background: #000; + box-shadow: 0 30px 80px rgba(0, 0, 0, 0.55); + } + .video-frame video { width: 100%; height: 100%; display: block; } + /* Screenshots grid */ .shots { display: grid; @@ -480,6 +495,7 @@ Screenshots Install Compare + Tiếng Việt GitHub @@ -533,6 +549,16 @@

+
+
+
+ +
+
+
+
@@ -542,19 +568,27 @@

A native dashboard, not Electron

-
Containers
-
Containers · live logs, stats, inspect, exec
+
Containers grouped by compose stack
+
Containers · grouped by stack, crashes and failing health checks flagged
-
Images
-
Images · pull / push, registry credentials in Keychain
+
Monitor tab
+
Monitor · live CPU / memory / network per container, disk breakdown
-
Machines
+
TLS environment editor
+
Remote engines · SSH or TLS, client key kept in the Secure Enclave
+
+
+
Machines
Machines · Alpine / Debian / Ubuntu, one-click k3s / k8s clusters
-
Settings
+
Images
+
Images · in use / unused / dangling, pull and prune
+
+
+
Settings
Settings · CPU / RAM / disk, snapshots, move data to external SSD
diff --git a/landing/sitemap.xml b/landing/sitemap.xml index 95a45f4..54fb316 100644 --- a/landing/sitemap.xml +++ b/landing/sitemap.xml @@ -1,7 +1,11 @@ - - https://dockz.nextagesoft.com/2026-10-05 - https://dockz.nextagesoft.com/vs/docker-desktop/2026-10-05 - https://dockz.nextagesoft.com/vs/orbstack/2026-10-05 - https://dockz.nextagesoft.com/vs/colima/2026-10-05 + + https://dockz.nextagesoft.com/2026-10-06 + https://dockz.nextagesoft.com/vi/2026-10-06 + https://dockz.nextagesoft.com/vs/docker-desktop/2026-10-06 + https://dockz.nextagesoft.com/vi/vs/docker-desktop/2026-10-06 + https://dockz.nextagesoft.com/vs/orbstack/2026-10-06 + https://dockz.nextagesoft.com/vi/vs/orbstack/2026-10-06 + https://dockz.nextagesoft.com/vs/colima/2026-10-06 + https://dockz.nextagesoft.com/vi/vs/colima/2026-10-06 diff --git a/landing/vi/index.html b/landing/vi/index.html new file mode 100644 index 0000000..f59ebcd --- /dev/null +++ b/landing/vi/index.html @@ -0,0 +1,856 @@ + + + + + + DockZ — Docker & máy ảo Linux chạy native trên Apple Silicon + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+
+
+ + Apache 2.0 · macOS 15+ · Apple Silicon +
+

+ Docker & máy ảo Linux
+ trên Apple Silicon, chạy native. +

+

+ DockZ là app menu bar chỉ ~8 MB, chạy dockerd thật trong một VM Alpine siêu nhẹ — kèm dashboard kiểu Docker Desktop và máy ảo Linux kiểu Multipass. Một app thay cho cả bộ công cụ. +

+ + +
+
+
~8 MB
+
Dung lượng app
+
+
+
3.5 MB
+
Bản tải về
+
+
+
100%
+
dockerd thật
+
+
+
Miễn phí
+
Apache 2.0
+
+
+
+
+ +
+
+
+ +
+
+
+ +
+
+
+
Ảnh chụp màn hình
+

Dashboard native, không phải Electron

+

Viết hoàn toàn bằng SwiftUI trên Virtualization.framework của Apple. Quản lý container, image, volume, network, registry, compose stack và máy ảo Linux — tất cả trong một cửa sổ.

+
+
+
+
Container được nhóm theo compose stack
+
Containers · nhóm theo stack, đánh dấu container bị crash và health check lỗi
+
+
+
Tab Monitor
+
Monitor · CPU / bộ nhớ / mạng của từng container theo thời gian thực, phân tích dung lượng đĩa
+
+
+
Màn hình chỉnh sửa môi trường TLS
+
Engine từ xa · SSH hoặc TLS, client key được giữ trong Secure Enclave
+
+
+
Machines
+
Machines · Alpine / Debian / Ubuntu, dựng cluster k3s / k8s chỉ với một click
+
+
+
Images
+
Images · đang dùng / không dùng / dangling, pull và prune
+
+
+
Cài đặt
+
Settings · CPU / RAM / ổ đĩa, snapshot, chuyển dữ liệu sang SSD rời
+
+
+
+
+ +
+
+
+
Kiến trúc
+

Một VM Alpine, một vsock, vậy thôi

+

Docker socket được nối qua vsock. Các port publish ra được tự động ánh xạ về localhost. $HOME được chia sẻ qua virtiofs nên bind mount dùng được ngay.

+
+
+ Sơ đồ kiến trúc DockZ +
+
+
+ +
+
+
+
Tính năng
+

Đủ mọi thứ bạn cần, không thừa thứ gì

+
+
+
+
🐳
+

Docker engine thật

+

dockerd upstream chạy trong Alpine. docker, docker compose và buildx đều chạy được — thông qua context dockz.

+
+
+
🖥️
+

Dashboard native

+

Container, image, volume, network, registry, compose stack. Form tạo / sửa, log trực tiếp, inspect, cùng bộ lọc + tìm kiếm trên mọi danh sách (container nhóm theo stack, container crash được đánh dấu) — giống Docker Desktop, nhưng viết bằng SwiftUI.

+
+
+
📦
+

Máy ảo Linux

+

VM Alpine / Debian / Ubuntu (ARM64), truy cập qua SSH. Template cluster k3s / k8s master + node chỉ với một click. Kiểu Multipass, dùng chung một mạng NAT.

+
+
+
🚀
+

Thiết lập trong một cửa sổ

+

Lần chạy đầu tiên, DockZ build guest image trong một VM netboot dùng xong bỏ, đồng thời tải CLI song song. Đóng cửa sổ lại là docker ps chạy được ngay.

+
+
+
🔌
+

Tự động forward port

+

Các port TCP và UDP được publish sẽ tự động ánh xạ về localhost thông qua Docker events API. Không cần cấu hình gì.

+
+
+
📸
+

Snapshot VM

+

Snapshot copy-on-write APFS tức thì cho ổ đĩa VM, có rollback. Dùng Rosetta để chạy image linux/amd64 trên ARM.

+
+
+
⚙️
+

Tùy chỉnh được

+

Số CPU, RAM, giới hạn ổ đĩa, chia sẻ $HOME qua virtiofs, thư mục dữ liệu đổi được vị trí (chuyển toàn bộ sang SSD rời).

+
+
+
🧰
+

Docker CLI khi cần

+

Không cần Homebrew. DockZ tải binary tĩnh chính thức của docker + compose, có kiểm checksum, rồi nối vào terminal của bạn bằng một đoạn trong ~/.zshrc có thể gỡ bỏ.

+
+
+
🪶
+

Tối thiểu phụ thuộc

+

Chỉ gồm framework của Apple, code trong repo này, và swift-nio-ssl của chính Apple (đã pin phiên bản) cho TLS key lưu bằng phần cứng. Build được chỉ với Command Line Tools.

+
+
+
🌐
+

Nhiều môi trường

+

Quản lý Docker host từ xa qua SSH hoặc mutual TLS — hoặc Colima / OrbStack ngay trên Mac này — và chuyển mọi tab bằng ⌘1…⌘9. TLS key nằm trong Secure Enclave, mở bằng Touch ID.

+
+
+
📊
+

Monitor

+

CPU, bộ nhớ, mạng và ổ đĩa của từng container theo thời gian thực, cùng các chỉ số của VM, phân tích dung lượng lưu trữ, và dọn image, volume, build cache không dùng chỉ với một click.

+
+
+
🛟
+

VM tự phục hồi

+

Nếu engine ngừng phản hồi hoặc kernel của guest gặp lỗi, DockZ tự khởi động lại VM và giữ console log của các lần boot gần đây để chẩn đoán.

+
+
+
+
+ +
+
+
+
So sánh
+

Một app 8 MB thay cho cả bộ công cụ

+

Không tài khoản, không telemetry, không trình cập nhật chạy ngầm. Ngồi đọc hết cả codebase trong một lần là được.

+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
DockZDocker DesktopOrbStackColima
💾 Dung lượng app~8 MB (bản tải 3.5 MB)~1.5 GB+vài trăm MBCLI + các gói phụ thuộc qua brew
💵 Giấy phépApache 2.0, miễn phíTrả phí nếu ≥ 250 nhân viênMã nguồn đóng, trả phíMIT, miễn phí
🐳 Docker engine✓ thật✓✓✓
🖥️ Máy ảo Linux✓ Alpine / Debian / Ubuntu———
⚡ Native (không Electron)✓ Swift / SwiftUI— Electron—— CLI
🔌 Tự động forward port✓ TCP + UDP✓✓Thủ công
+
+
+
+ +
+
+
+
Cài đặt
+

Tải về, hoặc tự build chỉ với một lệnh

+

macOS 15+ trên Apple Silicon. Không cần Homebrew (nhưng vẫn có bản Homebrew), không cần mật khẩu admin.

+
+
+
+

1. Tải về

+

Tải DockZ-<version>.dmg từ trang Releases, kéo DockZ vào Applications rồi mở lên. Với bản build chưa notarize: cho phép một lần trong System Settings → Privacy & Security → Open Anyway.

+
# hoặc cài bằng Homebrew +brew tap nextage-soft/dockz https://github.com/nextage-soft/dockz +brew install --cask nextage-soft/dockz/dockz
+
+
+

2. …hoặc build từ mã nguồn

+

Cần có Command Line Tools. Script tự ký kèm entitlement cho VM (dùng chứng chỉ Apple Development nếu tìm thấy, không thì ký ad-hoc). Muốn dùng chứng chỉ riêng? Xem hướng dẫn ký.

+
git clone https://github.com/nextage-soft/dockz.git +cd dockz +scripts/build-and-bundle-app.sh +open build/DockZ.app
+
+
+

3. Dùng docker như bình thường

+

DockZ tự tải CLI và thiết lập context dockz giúp bạn.

+
docker run --rm hello-world +docker run --rm -p 8080:80 nginx +# mở http://localhost:8080 — chạy luôn
+
+
+

4. (Tùy chọn) Máy ảo Linux

+

Tạo một VM Ubuntu và SSH thẳng vào từ Terminal.

+
# Trong dashboard: Machines → New → Ubuntu 24.04 +ssh ubuntu@<ip> +docker context use dockz
+
+
+
+
+ +
+
+
+
FAQ
+

Câu hỏi thường gặp

+

Đang cân nhắc giữa các công cụ? Xem so sánh DockZ với Docker Desktop, OrbStack và Colima.

+
+
+
+ DockZ có phải là lựa chọn miễn phí thay Docker Desktop trên Mac không? +

Đúng vậy — miễn phí, giấy phép Apache 2.0, công ty dùng cũng không phải mua license theo đầu người. DockZ chạy Docker Engine thật (dockerd) trong một VM Alpine Linux gọn nhẹ trên Virtualization.framework của Apple.

+
+
+ DockZ khác gì OrbStack hay Colima? +

OrbStack rất tốt nhưng là mã nguồn đóng và phải trả phí khi dùng cho mục đích thương mại; Colima miễn phí nhưng chỉ có CLI và cài qua Homebrew. DockZ là app native mã nguồn mở hoàn toàn, chỉ ~8 MB, có dashboard GUI, không cần Homebrew, không cần mật khẩu admin, và còn quản lý được cả máy ảo Linux đa dụng.

+
+
+ Chạy Kubernetes (k3s/k8s) trên DockZ được không? +

Được — tab Machines tạo VM Alpine/Debian/Ubuntu kèm template master/node k3s hoặc kubeadm chỉ với một cú click; các node dùng chung một mạng NAT nên bạn dựng được cluster nhiều node ngay trên một chiếc Mac.

+
+
+ docker compose / buildx / amd64 có chạy được không? +

Có. Engine là Docker upstream nên compose, buildx và registry riêng chạy y hệt như trên Linux. Image linux/amd64 chạy qua Rosetta.

+
+
+ DockZ có quản lý được Docker host từ xa không? +

Có — bạn thêm các engine khác qua SSH hoặc mutual TLS (hoặc socket của một engine khác ngay trên Mac) rồi chuyển qua lại giữa chúng trên mọi tab. Client key TLS được tạo trong Secure Enclave của Mac và dùng kèm Touch ID.

+
+
+ Có cần cài Docker hay Homebrew trước không? +

Không. Lần chạy đầu tiên, DockZ tự build guest image và tải docker CLI chính thức + plugin compose, có kiểm checksum — một chiếc Mac mới tinh đi từ con số 0 tới docker ps chỉ trong một cửa sổ.

+
+
+
+
+
+
+

Sẵn sàng tạm biệt Docker Desktop?

+

Tải về (hoặc build trong vài phút), gỡ Docker Desktop và quên luôn Electron đi. DockZ chạy native, tốn rất ít RAM và không gửi dữ liệu về cho ai cả.

+ +
+
+ + + + diff --git a/landing/vi/vs/colima/index.html b/landing/vi/vs/colima/index.html new file mode 100644 index 0000000..136282a --- /dev/null +++ b/landing/vi/vs/colima/index.html @@ -0,0 +1,79 @@ + + + + + + DockZ vs Colima — lựa chọn thay Colima có GUI native + + + + + + + + + + + + + + + + + + + + + + +
+
So sánh
+

DockZ vs Colima

+

Colima là một CLI miễn phí, mã nguồn mở, chạy Docker trong VM Lima. DockZ đi theo cùng hướng mã nguồn mở, dùng dockerd thật, và bổ sung thêm một dashboard native.

+

Nhìn nhanh

+
+ + + + + + + + + +
DockZColima
Giấy phépApache 2.0MIT
Giao diệnDashboard native + menu bar + CLIChỉ CLI
Cài đặtDMG, không cần Homebrew, không cần mật khẩu adminHomebrew (Lima, QEMU hoặc VZ)
Docker enginedockerd upstream trong Alpinedockerd upstream
KubernetesTemplate k3s / k8s nhiều nodek3s một node (colima start --kubernetes)
Máy ảo Linux đa dụngAlpine / Debian / UbuntuQua Lima
Snapshot VM + rollbackAPFS copy-on-write—
Nền tảngmacOS 15+, Apple SiliconmacOS (Intel + Apple Silicon), Linux
+

Vì sao nhiều người chọn DockZ

+
    +
  • Miễn phí và mã nguồn mở (Apache 2.0) — không phải đếm số người dùng, không lo kiểm tra license.
  • +
  • Một app native ~8 MB: Docker engine, dashboard kiểu Portainer, máy ảo Linux kiểu Multipass và môi trường k3s/k8s để vọc.
  • +
  • Quản lý Docker host từ xa qua SSH hoặc mutual TLS; TLS key nằm yên trong Secure Enclave của Mac.
  • +
  • VM tự phục hồi: nếu engine ngừng phản hồi, DockZ tự khởi động lại.
  • +
+

Khi nào Colima là lựa chọn tốt hơn

+
    +
  • Bạn muốn một setup thuần terminal, dễ viết script, hoặc cần chạy trên Mac chip Intel hay máy Linux.
  • Bạn đang quản lý sẵn các VM Lima và muốn chỉ dùng một công cụ.
  • +
+

Chuyển sang chỉ mất vài phút

+
    +
  • Cài DockZ từ file DMG rồi mở lên; lần chạy đầu tiên sẽ build VM image và, nếu máy bạn chưa có docker CLI, cài luôn bản chính thức.
  • +
  • DockZ đăng ký một Docker context tên dockz: docker context use dockz. Image, file compose và các lệnh bạn đang dùng vẫn giữ nguyên.
  • +
  • Image được lưu riêng theo từng engine — hãy pull lại (hoặc docker save / docker load) và tạo lại các volume bạn cần.
  • +
+
+
Dùng thử DockZ

Miễn phí, mã nguồn mở, ~8 MB (bản tải 3.5 MB). macOS 15+ trên Apple Silicon.

+ Tải file DMG +
+

So sánh tại thời điểm tháng 10/2026, dựa trên tài liệu công khai của từng sản phẩm. Thấy thông tin nào đã cũ? Mở issue nhé.

+
+ + + diff --git a/landing/vi/vs/docker-desktop/index.html b/landing/vi/vs/docker-desktop/index.html new file mode 100644 index 0000000..2ce9103 --- /dev/null +++ b/landing/vi/vs/docker-desktop/index.html @@ -0,0 +1,80 @@ + + + + + + DockZ vs Docker Desktop — lựa chọn miễn phí thay Docker Desktop trên Mac + + + + + + + + + + + + + + + + + + + + + + +
+
So sánh
+

DockZ vs Docker Desktop

+

Docker Desktop là cách chính thức để chạy Docker trên Mac. DockZ chạy đúng dockerd upstream đó, nhưng dưới dạng một app SwiftUI native chỉ ~8 MB và miễn phí cho công ty ở mọi quy mô.

+

Nhìn nhanh

+
+ + + + + + + + + + +
DockZDocker Desktop
Giấy phépApache 2.0, miễn phí cho tất cảPhải mua gói trả phí với công ty lớn (từ 250 nhân viên hoặc doanh thu từ 10 triệu USD)
Dung lượng app trên đĩa~8 MB~1.5 GB+
Giao diệnSwiftUI nativeElectron
Docker enginedockerd upstream trong Alpinedockerd upstream
Máy ảo Linux đa dụngAlpine / Debian / Ubuntu, cloud-init—
KubernetesTemplate k3s / k8s nhiều nodeMột node
Snapshot VM + rollbackAPFS copy-on-write—
Docker engine từ xaSSH / mutual TLS, key nằm trong Secure EnclaveQua docker context (CLI)
Nền tảngmacOS 15+, chỉ Apple SiliconmacOS, Windows, Linux
+

Vì sao nhiều người chọn DockZ

+
    +
  • Miễn phí và mã nguồn mở (Apache 2.0) — không phải đếm số người dùng, không lo kiểm tra license.
  • +
  • Một app native ~8 MB: Docker engine, dashboard kiểu Portainer, máy ảo Linux kiểu Multipass và môi trường k3s/k8s để vọc.
  • +
  • Quản lý Docker host từ xa qua SSH hoặc mutual TLS; TLS key nằm yên trong Secure Enclave của Mac.
  • +
  • VM tự phục hồi: nếu engine ngừng phản hồi, DockZ tự khởi động lại.
  • +
+

Khi nào Docker Desktop là lựa chọn tốt hơn

+
    +
  • Bạn cần chạy trên máy Windows hoặc Linux, Mac chip Intel, hoặc muốn cả một team dùng nhiều nền tảng khác nhau chung một công cụ.
  • Bạn phụ thuộc vào Docker Extensions, hỗ trợ thương mại của Docker, hoặc các tính năng khác trong gói Docker subscription.
  • +
+

Chuyển sang chỉ mất vài phút

+
    +
  • Cài DockZ từ file DMG rồi mở lên; lần chạy đầu tiên sẽ build VM image và, nếu máy bạn chưa có docker CLI, cài luôn bản chính thức.
  • +
  • DockZ đăng ký một Docker context tên dockz: docker context use dockz. Image, file compose và các lệnh bạn đang dùng vẫn giữ nguyên.
  • +
  • Image được lưu riêng theo từng engine — hãy pull lại (hoặc docker save / docker load) và tạo lại các volume bạn cần.
  • +
+
+
Dùng thử DockZ

Miễn phí, mã nguồn mở, ~8 MB (bản tải 3.5 MB). macOS 15+ trên Apple Silicon.

+ Tải file DMG +
+

So sánh tại thời điểm tháng 10/2026, dựa trên tài liệu công khai của từng sản phẩm. Thấy thông tin nào đã cũ? Mở issue nhé.

+
+ + + diff --git a/landing/vi/vs/orbstack/index.html b/landing/vi/vs/orbstack/index.html new file mode 100644 index 0000000..aa941ea --- /dev/null +++ b/landing/vi/vs/orbstack/index.html @@ -0,0 +1,79 @@ + + + + + + DockZ vs OrbStack — lựa chọn miễn phí, mã nguồn mở thay OrbStack + + + + + + + + + + + + + + + + + + + + + + +
+
So sánh
+

DockZ vs OrbStack

+

OrbStack là một app native nhanh và chỉn chu. DockZ hướng tới cùng trải nghiệm “native và nhẹ” đó, nhưng mã nguồn mở hoàn toàn và miễn phí cho cả mục đích thương mại.

+

Nhìn nhanh

+
+ + + + + + + + + +
DockZOrbStack
Giấy phépApache 2.0, miễn phí cho tất cảĐộc quyền; trả phí khi dùng cho mục đích thương mại
Mã nguồnMã nguồn mở hoàn toànMã nguồn đóng
Giao diệnSwiftUI nativeNative
Docker enginedockerd upstream trong AlpineStack riêng đã được tối ưu
Máy ảo Linux đa dụngAlpine / Debian / UbuntuCó
KubernetesTemplate k3s / k8s nhiều nodek8s tích hợp sẵn
Snapshot VM + rollbackAPFS copy-on-write—
Docker engine từ xaSSH / mutual TLS, key nằm trong Secure Enclave—
+

Vì sao nhiều người chọn DockZ

+
    +
  • Miễn phí và mã nguồn mở (Apache 2.0) — không phải đếm số người dùng, không lo kiểm tra license.
  • +
  • Một app native ~8 MB: Docker engine, dashboard kiểu Portainer, máy ảo Linux kiểu Multipass và môi trường k3s/k8s để vọc.
  • +
  • Quản lý Docker host từ xa qua SSH hoặc mutual TLS; TLS key nằm yên trong Secure Enclave của Mac.
  • +
  • VM tự phục hồi: nếu engine ngừng phản hồi, DockZ tự khởi động lại.
  • +
+

Khi nào OrbStack là lựa chọn tốt hơn

+
    +
  • Bạn muốn sự trưởng thành và khả năng tinh chỉnh hiệu năng của OrbStack (chia sẻ file, networking), và team bạn không ngại dùng một sản phẩm trả phí có hỗ trợ.
  • Bạn cần nhiều bản phân phối Linux hơn ngoài Alpine, Debian và Ubuntu.
  • +
+

Chuyển sang chỉ mất vài phút

+
    +
  • Cài DockZ từ file DMG rồi mở lên; lần chạy đầu tiên sẽ build VM image và, nếu máy bạn chưa có docker CLI, cài luôn bản chính thức.
  • +
  • DockZ đăng ký một Docker context tên dockz: docker context use dockz. Image, file compose và các lệnh bạn đang dùng vẫn giữ nguyên.
  • +
  • Image được lưu riêng theo từng engine — hãy pull lại (hoặc docker save / docker load) và tạo lại các volume bạn cần.
  • +
+
+
Dùng thử DockZ

Miễn phí, mã nguồn mở, ~8 MB (bản tải 3.5 MB). macOS 15+ trên Apple Silicon.

+ Tải file DMG +
+

So sánh tại thời điểm tháng 10/2026, dựa trên tài liệu công khai của từng sản phẩm. Thấy thông tin nào đã cũ? Mở issue nhé.

+
+ + + diff --git a/landing/vs/colima/index.html b/landing/vs/colima/index.html index 2599a2a..746294a 100644 --- a/landing/vs/colima/index.html +++ b/landing/vs/colima/index.html @@ -6,6 +6,9 @@ DockZ vs Colima — a Colima alternative with a native GUI + + + @@ -27,6 +30,7 @@ vs Docker Desktop vs OrbStack vs Colima + Tiếng Việt GitHub
diff --git a/landing/vs/docker-desktop/index.html b/landing/vs/docker-desktop/index.html index 7668792..d6dcfbb 100644 --- a/landing/vs/docker-desktop/index.html +++ b/landing/vs/docker-desktop/index.html @@ -6,6 +6,9 @@ DockZ vs Docker Desktop — free Docker Desktop alternative for Mac + + + @@ -27,6 +30,7 @@ vs Docker Desktop vs OrbStack vs Colima + Tiếng Việt GitHub diff --git a/landing/vs/orbstack/index.html b/landing/vs/orbstack/index.html index 17b5bf3..a348a7e 100644 --- a/landing/vs/orbstack/index.html +++ b/landing/vs/orbstack/index.html @@ -6,6 +6,9 @@ DockZ vs OrbStack — free, open-source OrbStack alternative + + + @@ -27,6 +30,7 @@ vs Docker Desktop vs OrbStack vs Colima + Tiếng Việt GitHub diff --git a/public/architecture.svg b/public/architecture.svg index 92bd19f..8ae9db5 100644 --- a/public/architecture.svg +++ b/public/architecture.svg @@ -37,8 +37,8 @@ DockZ.app (Swift, menu bar) - Dashboard · Machines · Settings · port forwarder - Zero external Swift dependencies + Dashboard · Monitor · Machines · port forwarder · VM watchdog + Remote engines: SSH · TLS (key in Secure Enclave) · socket @@ -70,7 +70,7 @@ vsock 2375 - HTTP/1.1 Docker API + Docker API relay → guest IP diff --git a/public/dashboard-containers.png b/public/dashboard-containers.png index e08a22b..6dae961 100644 Binary files a/public/dashboard-containers.png and b/public/dashboard-containers.png differ diff --git a/public/dashboard-environments.png b/public/dashboard-environments.png new file mode 100644 index 0000000..571a920 Binary files /dev/null and b/public/dashboard-environments.png differ diff --git a/public/dashboard-images.png b/public/dashboard-images.png index 372b480..5f3d482 100644 Binary files a/public/dashboard-images.png and b/public/dashboard-images.png differ diff --git a/public/dashboard-machines.png b/public/dashboard-machines.png index 601a807..280b4b1 100644 Binary files a/public/dashboard-machines.png and b/public/dashboard-machines.png differ diff --git a/public/dashboard-monitor.png b/public/dashboard-monitor.png new file mode 100644 index 0000000..b278b0a Binary files /dev/null and b/public/dashboard-monitor.png differ diff --git a/public/dashboard-settings.png b/public/dashboard-settings.png index 7810da3..361868c 100644 Binary files a/public/dashboard-settings.png and b/public/dashboard-settings.png differ diff --git a/public/intro-poster.jpg b/public/intro-poster.jpg new file mode 100644 index 0000000..8a04cfb Binary files /dev/null and b/public/intro-poster.jpg differ