Cài đặt MixLab

Đây là tài liệu hướng dẫn dùng MixLab qua dòng lệnh mix. Nếu bạn muốn thao tác bằng giao diện đồ hoạ cho dễ hơn thì bạn đã có sẵn: mọi bộ cài đều đặt sẵn cửa sổ MixLab ngay cạnh dòng lệnh. Cả hai đều điều khiển cùng một MixEngine bên dưới, nên mọi khái niệm trong cẩm nang này vẫn áp dụng.

Mọi bản build đều được phát hành trên trang releases của dự án trên GitHub, kèm theo checksum và chữ ký. Bạn chọn file đúng với hệ điều hành của mình ở bên dưới. Bộ cài thay đổi máy bạn ít nhất có thể: chưa có gì được thêm vào kho chứng chỉ, cài đặt DNS hay firewall cho tới khi bạn yêu cầu một tính năng cần tới chúng. Chi tiết xem ở MixLab xin quyền để làm gì.

Một lệnh

Trên macOS hoặc Linux:

curl -fsSL https://mixnz.github.io/mixlab/install.sh | sh

Trên Windows, mở PowerShell:

irm https://mixnz.github.io/mixlab/install.ps1 | iex

Lệnh này tự chọn bộ cài hợp với máy bạn trong các mục bên dưới, kiểm checksum và chữ ký bằng khoá của MixLab, rồi mới chạy bộ cài như từng mục mô tả. Thêm --headless (trên Windows là -Headless) nếu chỉ cần các chương trình dòng lệnh, không cần cửa sổ; --version 0.0.13 để cài một bản cũ hơn; --dry-run để xem nó sẽ tải và chạy gì mà không cài gì cả. Trên macOS và Linux, tuỳ chọn đặt sau sh -s --. Trên Windows thì truyền qua & ([scriptblock]::Create((irm https://mixnz.github.io/mixlab/install.ps1))) -Headless.

Muốn đọc script trước khi chạy thì tải nó về trước:

curl -fsSLO https://mixnz.github.io/mixlab/install.sh
less install.sh
sh install.sh

Script cần minisign để kiểm chữ ký. Máy chưa có thì nó tải tạm một bản cho lần chạy đó, trừ Mac chip Intel: ở đó bạn cần brew install minisign trước. Mọi thứ nó tải về đều bị xoá khi chạy xong, chỉ còn lại những gì bộ cài đã cài.

Bạn đang cài những gì

Có năm chương trình. Nên biết mỗi cái làm gì trước khi một trong số chúng làm bạn bất ngờ.

Chương trình	Nhiệm vụ
`mixengined`	Daemon. Lưu mọi trạng thái MixEngine biết và giám sát mọi tiến trình MixEngine chạy.
`mix`	Lệnh bạn gõ. Nó hỏi daemon rồi in câu trả lời ra.
`mixengine-shim`	Chương trình thế chỗ cho `php`, `node`, `python` và `ruby`, chọn đúng phiên bản cần chạy.
`mixengine-elevate`	Chương trình duy nhất chạy với quyền quản trị, mỗi lần chỉ vài giây.
MixLab	Cửa sổ: bảng điều khiển cho daemon, kèm một client cơ sở dữ liệu, một client HTTP và một terminal.

Ba chương trình đầu và MixLab được cài chung một lượt. Trên Windows chúng được cài dưới tài khoản của bạn, và bộ cài không đặt mixengine-elevate vào máy: MixLab tự cài nó vào lần đầu tiên có việc cần quyền quản trị, ngay trong hộp thoại xin quyền mà đằng nào bạn cũng sẽ thấy. .pkg, .deb và .rpm thì đặt nó vào máy với quyền root ngay lúc cài. Dù cài cách nào, MixLab cũng tự cập nhật nó: khi một bản cập nhật thay đổi nó, lần xin quyền kế tiếp sẽ thay nó.

Nếu bạn không cần cửa sổ, có bản tải không kèm nó. Mỗi hệ điều hành đều phát hành một bản headless chỉ chứa bốn chương trình dòng lệnh và không gì khác: không có cửa sổ, và trên Linux cũng không cần cài WebKitGTK. Link nằm trong từng mục bên dưới, và đó là bản dành cho máy chủ, image container, hay bất kỳ máy nào không có màn hình.

Windows

Hoặc cài bằng mục Một lệnh ở trên.

Tải bộ cài · bộ cài headless · Windows ARM: bộ cài, headless

Có hai bộ cài được phát hành, bộ nào cũng là một bản cài đầy đủ.

mixlab-<version>-windows-x86_64-setup.exe: bộ cài theo từng người dùng. Nó ghi vào profile của bạn và thêm thư mục cài vào PATH, nên lúc cài không cần quyền quản trị, và cũng không đụng tới tài khoản của người khác trên cùng máy. Nó còn thêm MixLab vào Start Menu, cho bạn chọn tạo shortcut ngoài desktop ở trang thành phần, và đặt MixLab làm chương trình mở link mixlab://.
mixengine-<version>-windows-x86_64-headless-setup.exe: cũng bộ cài đó nhưng không có MixLab, chỉ bốn chương trình dòng lệnh và không gì khác.

Lần đầu MixLab cần quyền quản trị, thường là lúc bạn cho phép bước thiết lập đầu tiên, cùng một hộp thoại đó cũng đặt chương trình phụ trợ đặc quyền vào chỗ.

Bản cho Windows ARM được phát hành bên cạnh, đặt tên aarch64.

Bạn sẽ gặp cảnh báo SmartScreen. MixLab chưa được ký bằng chứng chỉ Authenticode, nên Windows hiện "Windows protected your PC" và giấu nút chạy sau More info → Run anyway. Cảnh báo này chỉ nói rằng chưa ai mua chứng chỉ, chứ không nói gì về bản thân file. Nếu muốn biết chắc file mình tải có đúng không, hãy kiểm tra chữ ký theo hướng dẫn bên dưới. Cảnh báo này thường xuất hiện lại ở mỗi bản phát hành, vì khi không có danh tính nhà phát hành, "uy tín" mà Windows tích luỹ gắn với từng file chứ không gắn với dự án.

macOS

Hoặc cài bằng mục Một lệnh ở trên.

Tải gói cài · gói headless

mixlab-<version>-macos-universal.pkg: một gói dùng chung cho cả Intel lẫn Apple silicon. Nó đặt các chương trình dòng lệnh vào /usr/local/bin và MixLab vào /Applications, nên cửa sổ có mặt trong Spotlight và Launchpad ngay khi cài xong.

mixengine-<version>-macos-universal-headless.pkg cài đúng bốn chương trình dòng lệnh đó và cùng chương trình phụ trợ đặc quyền, nhưng không kèm MixLab, dành cho máy không cần cửa sổ. Khi cập nhật, mỗi máy Mac nhận đúng loại gói nó đang dùng.

MixLab cũng chưa có Apple Developer ID, nên nếu bạn nhấp đúp gói cài trong Finder thì sẽ gặp hộp thoại Gatekeeper. Trên macOS 15 trở lên còn phải vào System Settings → Privacy & Security → Open Anyway. Cài từ terminal thì bỏ qua được tất cả những bước đó:

sudo installer -pkg mixlab-*-macos-universal.pkg -target /

Với một sản phẩm dòng lệnh thì đây là cách nên dùng trước tiên. Gói cài chạy với quyền root, nên nó cũng đặt luôn chương trình phụ trợ cần quyền quản trị vào máy cho bạn.

Linux

Hoặc cài bằng mục Một lệnh ở trên.

.deb · .rpm · arm64: .deb, .rpm · headless: .deb, .rpm, arm64 .deb, .rpm

Mỗi họ bản phân phối có hai gói, gói nào cũng là một bản cài đầy đủ:

mixlab: MixLab và bốn chương trình dòng lệnh
mixengine-headless: chỉ bốn chương trình dòng lệnh, cho máy chủ hoặc máy không có màn hình

.deb dành cho Debian, Ubuntu và các bản phái sinh, .rpm dành cho Fedora, RHEL và openSUSE:

sudo apt install ./mixlab_*_amd64.deb
sudo dnf install ./mixlab-*.x86_64.rpm

Hai gói thay thế nhau: cài gói này thì gói kia bị gỡ.

Các bản phân phối khác không được hỗ trợ. Arch, NixOS, Gentoo và những bản còn lại không có gói ở đây; muốn dùng thì build từ mã nguồn (mục bên dưới).

Cửa sổ cần WebKitGTK 4.1 và glibc 2.35: Ubuntu 22.04, Debian 12, Fedora 38, openSUSE Leap 15.6 trở lên. MixLab là ứng dụng webview, và thư viện nó vẽ lên là thư viện của bản phân phối bạn đang dùng: libwebkit2gtk-4.1-0 trên Debian và Ubuntu, webkit2gtk4.1 trên Fedora và RHEL, libwebkit2gtk-4_1-0 trên openSUSE. Gói mixlab khai báo phụ thuộc này nên trình quản lý gói tự kéo về; gói đó cũng thêm một mục menu MixLab kèm icon.

Gói headless không cần gì trong số đó. Bốn chương trình dòng lệnh được build với glibc 2.28, nên chạy được trên các bản phân phối hỗ trợ dài hạn mà chúng nhắm tới, và không cần webview.

Bản cập nhật là gói tiếp theo. mix self-update tải gói về, kiểm tra với bản phát hành đã ký, rồi in lệnh cài nó: sudo apt install … hoặc sudo dnf install …. Trên máy có desktop, nó mở luôn gói đó trong trình quản lý phần mềm.

Bản aarch64 được phát hành bên cạnh bản x86_64.

Build từ mã nguồn

MixLab viết bằng Rust, và chỉ Rust:

git clone https://github.com/mixnz/mixlab.git
cd mixlab
cargo build --release

Các file thực thi nằm trong target/release/. MixLab được build riêng, vì nó là một workspace độc lập nằm dưới apps/desktop/. Build từ mã nguồn là thêm một cách cài chạy hoàn toàn dưới tài khoản của bạn. Cũng vì thế mà việc đặt chương trình phụ trợ cần quyền quản trị không bao giờ là việc của người đóng gói.

Kiểm tra file bạn vừa tải

Bên cạnh mỗi file phát hành có hai file đi kèm, và chúng trả lời hai câu hỏi khác nhau.

sha256sum -c mixlab_*_amd64.deb.sha256
minisign -Vm mixlab_*_amd64.deb -P <the key in packaging/updates.pub>

File .sha256 cho bạn biết hai lần tải cùng một file có ra đúng cùng một file hay không. Nó không phải chữ ký và cũng không được coi là chữ ký: ai thay được file phát hành thì cũng thay được checksum nằm cạnh nó. Các file không gắn số phiên bản mà những link ở trên trỏ tới cũng có .sha256 và .minisig riêng, đặt tên theo chính chúng chứ không theo file có số phiên bản mà chúng là bản sao. File .minisig mới là câu trả lời thật: đó là chữ ký Ed25519 do chính pipeline phát hành của MixLab tạo ra, ứng với khoá công khai được commit trong repo của dự án tại packaging/updates.pub và được biên dịch vào MixEngine. Đây cũng chính là khoá mà mix self-update kiểm tra trước khi thay bất cứ thứ gì.

Sau khi cài

Mở một cửa sổ terminal mới, vì bộ cài đã sửa PATH mà shell đang chạy sẵn thì chưa biết chuyện đó. Rồi gõ:

mix status

Lệnh mix đầu tiên sẽ khởi động daemon nếu nó chưa chạy. Kết quả bạn nên thấy là một daemon khoẻ mạnh, số phiên bản của nó, và chưa có gì đang được giám sát.

Tiếp theo, đưa các lệnh runtime vào PATH. Đây là một bước riêng vì chúng nằm ở một thư mục riêng:

mix path install

Lệnh này điền vào <root>/bin các shim, để php, node, python và ruby trỏ tới đúng phiên bản mà từng thư mục yêu cầu, thay vì một phiên bản chung cho cả máy. MixLab cũng làm được việc này ngay trên Dashboard, hoặc bằng công tắc Lệnh trong terminal trong Settings.

Nếu bạn có cài cửa sổ, hãy mở MixLab từ Start Menu, /Applications, menu ứng dụng của desktop, hoặc chạy mixlab. Nó hiển thị đúng daemon mà mix status vừa trả lời.

Những gì bộ cài không làm

Không đụng gì ngoài tài khoản của bạn, và không đụng gì tới phần còn lại của máy:

Không cài certificate authority nào. Việc đó diễn ra lần đầu bạn yêu cầu HTTPS.
Không sửa DNS hay file hosts. Việc đó diễn ra lần đầu bạn tạo site.
Không thêm rule firewall và không cấp quyền dùng cổng. Việc đó diễn ra khi một site cần.
Không tải runtime hay server nào. MixLab cài PHP, MariaDB và các thứ khác khi bạn yêu cầu, và chỉ những phiên bản bạn yêu cầu.
Không đăng ký chạy khi đăng nhập. Chỉ khi bạn chạy mix autostart enable thì điều đó mới xảy ra.

Từng mục trên đều được mô tả ở MixLab xin quyền để làm gì, kể cả việc mỗi hộp thoại sẽ thay đổi chính xác cái gì trước khi bạn đồng ý.

Sẵn sàng chưa? Site đầu tiên của bạn mất khoảng năm phút.

Trang này ở dạng Markdown: https://mixnz.github.io/mixlab/vi/install.md