Tài liệu VNTerm

Hướng dẫn ngắn gọn từ lúc cài đặt đến khi đồng bộ host giữa các máy.

Cài đặt ứng dụng

Tải bản cài đặt cho hệ điều hành của bạn ở trang Tải về.

macOS (11+, Apple Silicon & Intel)

Mở file VNTerm_<phiên bản>_aarch64.dmg và kéo VNTerm vào thư mục Applications.
Lần đầu mở, nếu macOS báo không xác minh được nhà phát triển: chuột phải vào ứng dụng → Open.

Ubuntu / Debian (22.04+, x86_64)

sudo apt install ./vnterm_*_amd64.deb

Hoặc dùng bản AppImage không cần cài đặt:

chmod +x VNTerm_*_amd64.AppImage && ./VNTerm_*_amd64.AppImage

Windows 10/11 (x64)

Chạy VNTerm_*_x64-setup.exe (hoặc VNTerm_*_x64_en-US.msi cho triển khai qua GPO/Intune). Nếu SmartScreen hiện cảnh báo, chọn More info → Run anyway.

Tạo tài khoản

Tài khoản dùng để đồng bộ vault giữa các thiết bị. Bạn có thể đăng ký ngay trong ứng dụng hoặc tại trang đăng ký.

Master password (tối thiểu 8 ký tự) mã hóa toàn bộ vault trên máy bạn. Nó không bao giờ được gửi lên server và chúng tôi không thể khôi phục nó.
Sau khi đăng ký, ứng dụng hiển thị khóa khôi phục đúng một lần — hãy lưu lại (xem Khóa khôi phục).
Đăng nhập cùng tài khoản trên máy khác để nhận toàn bộ host, key và snippet. Danh sách thiết bị và nút thu hồi nằm ở trang Tài khoản.

Thêm host

Trong mục Hosts, bấm New host.
Nhập Address (IP hoặc hostname), Label, chọn Parent Group và Tags nếu cần.
Đặt cổng SSH (mặc định 22), Username và Password hoặc gắn key / Identity từ Keychain.
Double-click thẻ host để kết nối. Lần đầu kết nối, ứng dụng hiện fingerprint của máy chủ để bạn xác nhận; fingerprint được lưu vào Known Hosts và bạn sẽ được cảnh báo nếu nó thay đổi.

Đã có sẵn cấu hình? Chọn New host → Import from ~/.ssh/config để nhập hàng loạt. Phần nâng cao của host có agent forwarding, startup snippet, host chaining (jump host), proxy SOCKS5/HTTP và theme terminal riêng.

Keychain & Identity

Tạo key: Keychain → Generate key, chọn ed25519 (khuyên dùng), ECDSA hoặc RSA, đặt passphrase nếu muốn.
Nhập key: dán hoặc chọn file private key có sẵn (OpenSSH / PEM).
Thêm public key vào ~/.ssh/authorized_keys trên máy chủ, sau đó gắn key vào host ở phần Credentials.
Identity gom username + password/key thành một bộ dùng lại cho nhiều host: đổi mật khẩu một lần, mọi host dùng Identity đó đều được cập nhật.

Quick connect: SSH, Mosh, Telnet

Gõ địa chỉ vào ô tìm kiếm ở trang Hosts rồi nhấn Enter hoặc Connect. Cú pháp:

[ssh|mosh|telnet] [user@]host[:port]
[email protected]
mosh [email protected]
telnet 10.0.0.5:23
[2001:db8::1]:2222

Nếu không ghi giao thức, ứng dụng hỏi bạn chọn SSH, Mosh hay Telnet rồi hỏi thông tin đăng nhập khi cần.

SSH — mặc định cổng 22, hỗ trợ password, key và agent.
Mosh — chạy client mosh của hệ thống trong một tab, giữ phiên khi mạng chập chờn hoặc đổi Wi-Fi. Cần cài mosh trên máy bạn và mosh-server trên máy chủ.
Telnet — mặc định cổng 23, dành cho thiết bị mạng cũ. Telnet không mã hóa, chỉ nên dùng trong mạng tin cậy.

SFTP

Mở tab SFTP: khung trái là máy của bạn, khung phải là host đã lưu. Bạn có thể duyệt thư mục, upload / download bằng menu chuột phải, tạo thư mục, đổi tên, xóa và đổi quyền (chmod). Giữ ⌘/Ctrl khi click để chọn nhiều file.

Port forwarding

Mục Port Forwarding lưu các rule cùng vault, bật / tắt từng rule độc lập.

Loại	Tương đương	Dùng khi
Local (L)	`ssh -L 5432:db.internal:5432 host`	Truy cập dịch vụ phía sau máy chủ qua cổng trên máy bạn, ví dụ database nội bộ.
Remote (R)	`ssh -R 8080:localhost:3000 host`	Cho máy chủ truy cập một dịch vụ đang chạy trên máy bạn.
Dynamic (D)	`ssh -D 1080 host`	Tạo proxy SOCKS5 cục bộ, mọi traffic đi qua máy chủ.

Cơ sở dữ liệu

Mục Databases kết nối tới MySQL, MariaDB, PostgreSQL và SQLite. Thông tin kết nối (kể cả mật khẩu) nằm trong vault và được mã hóa đầu-cuối như host. Chọn một host ở ô Kết nối qua một host SSH để đi qua tunnel SSH — không cần tạo rule port forwarding. Có trên cả desktop và điện thoại.

Cây bên trái — thư mục → kết nối → database → Bảng, View, Hàm, Sự kiện, Truy vấn. Mỗi mục mở trong một tab; chuột phải (hoặc nhấn giữ trên điện thoại) để mở menu.
Dữ liệu — bấm vào ô để sửa, rê chuột ra ngoài để lưu; chọn dòng bằng số thứ tự rồi ⌘/Ctrl+C, ⌘/Ctrl+V để thêm dòng mới. Có lọc, sắp xếp, xuất CSV / JSON / SQL và nhập CSV.
Thiết kế bảng — trường, chỉ mục, khóa ngoại, trigger, ràng buộc và tùy chọn; xem trước SQL trước khi lưu.
Chỉ đọc — truy vấn mặc định ở chế độ chỉ đọc; phải tắt công tắc mới ghi được.

Serial

Trang Hosts → Serial: chọn cổng (ví dụ /dev/ttyUSB0, COM3) và baud rate (300 – 921600, mặc định 9600). Phần Advanced chỉnh data bits, parity và stop bits. Trên Linux, tài khoản cần thuộc nhóm dialout để mở cổng serial.

Remote Desktop

Điều khiển máy Windows ngay trong một tab của ứng dụng desktop. Không cần cài hay cấu hình gì thêm trên Windows — chỉ cần Remote Desktop đang bật (Settings → System → Remote Desktop) và mạng tới được cổng 3389.

New host → chọn Remote Desktop, nhập địa chỉ, username (có thể kèm domain, ví dụ CORP\admin) và mật khẩu.
Double-click host để mở màn hình Windows. Khung tự đổi độ phân giải theo kích thước tab.
Thanh công cụ của tab: Chất lượng (Tự động theo tốc độ mạng, hoặc chọn cố định), GFX (đồ họa RDP 8+, bật mặc định), nút Ctrl + Alt + Del, chia màn hình, cửa sổ nổi và chia sẻ.

Sao chép / dán văn bản chạy hai chiều giữa máy bạn và Windows.
Phím tắt được gửi sang Windows. Trên Mac, ⌘ + C / V / X / Z / A / F / S thành Ctrl, các tổ hợp ⌘ khác thành phím Windows; ⌘ W vẫn đóng tab.
Mạng chậm: chế độ Tự động giảm chất lượng hình ảnh để giữ thao tác mượt, rồi tăng lại khi mạng tốt lên.

Tab & nhóm tab

Mỗi phiên là một tab; mở nhiều phiên tới cùng host sẽ được đánh số, ví dụ Onik (1), Onik (2).
Kéo một tab thả lên tab khác để gom chúng thành nhóm. Nhóm có thể bỏ gom hoặc đóng cả nhóm một lần.
Nút + trên thanh tab mở quick connect hoặc terminal cục bộ.

Cửa sổ nổi

Chuột phải vào tab → Float on top để tách terminal (hoặc màn hình Remote Desktop) ra một cửa sổ nhỏ luôn nằm trên cùng — tiện theo dõi log hay build trong lúc làm việc khác. Đóng cửa sổ nổi là phiên quay về tab.

Multiplayer

Chuột phải vào tab → Multiplayer để tạo liên kết chia sẻ. Người nhận mở liên kết trong trình duyệt, không cần tài khoản. Nội dung được mã hóa đầu-cuối, khóa nằm sau dấu # của liên kết nên server không đọc được. Bạn bật / tắt quyền gõ (hoặc điều khiển màn hình Remote Desktop) của người xem và dừng chia sẻ bất cứ lúc nào.

Theme & giao diện

Trong Settings chọn theme terminal mặc định, cỡ chữ và ngôn ngữ giao diện. Mỗi host có thể có theme riêng (trong panel chỉnh sửa host); host không đặt theme sẽ dùng theme mặc định của tài khoản. Cài đặt này được đồng bộ cùng vault.

Phím tắt

Thao tác	macOS	Linux / Windows
Mở terminal cục bộ	`⌘` `⇧` `T`	`Ctrl` `Shift` `T`
Sao chép trong terminal	`⌘` `C`	`Ctrl` `Shift` `C`
Dán vào terminal	`⌘` `V`	`Ctrl` `Shift` `V`
Quick connect từ ô tìm kiếm	`Enter`
Đóng panel / hộp thoại, hủy tìm kiếm	`Esc`
Chọn nhiều file trong SFTP	`⌘` + click	`Ctrl` + click

Đồng bộ & mã hóa đầu-cuối

VNTerm mã hóa vault ngay trên thiết bị: server chỉ lưu dữ liệu đã mã hóa và không bao giờ nhận master password. Khi bật đăng nhập nhanh bằng Google / Apple / Telegram (mặc định), server giữ thêm một bản khóa vault đã mã hóa để mở vault trên thiết bị mới — tắt trong ứng dụng: Cài đặt → Tài khoản.

Master password → PBKDF2-SHA256 (600 000 vòng) → master key. Từ đó sinh ra auth key (gửi lên server để đăng nhập, server lưu dạng Argon2id) và enc key (chỉ nằm trên máy bạn).
Mỗi host, key, snippet… được mã hóa AES-256-GCM bằng vault key ngẫu nhiên trước khi đồng bộ. Vault key được bọc bằng enc key.
Mọi request API còn được mã hóa thêm một lớp (X25519 + AES-256-GCM, gắn với endpoint và thời điểm, chống phát lại) bên trong HTTPS.
Đồng bộ theo revision: sửa cùng một mục trên hai máy cùng lúc sẽ được phát hiện là xung đột thay vì ghi đè im lặng.

Khóa khôi phục

Khóa khôi phục là cách duy nhất giữ lại dữ liệu vault khi bạn quên master password.

Lưu khóa (dạng XXXX-XXXX-…) ở nơi an toàn: trình quản lý mật khẩu hoặc bản in.
Khi quên mật khẩu: vào Quên mật khẩu, nhập mã 6 số gửi qua email, đặt mật khẩu mới và dán khóa khôi phục — vault được giữ nguyên.
Không có khóa khôi phục: vault cũ bị xóa, bạn nhận vault trống và một khóa khôi phục mới. Mọi thiết bị đều bị đăng xuất sau khi đặt lại mật khẩu.

Team vault

Nút Vaults ▾ trên thanh trên → Add vault: đặt tên và mời thành viên bằng email.
Menu của host → Move to vault để đưa host (và key / identity đi kèm) vào vault nhóm.
Trong menu Vaults ▾, bấm vào một vault để ẩn / hiện nó, hoặc only để chỉ xem vault đó. Lựa chọn này chỉ áp dụng cho máy hiện tại.
Manage vaults (Settings → Invite People) liệt kê thành viên, lời mời đang chờ; gỡ người là thu hồi quyền ngay.

Thành viên mới cần mở ứng dụng một lần để tạo cặp khóa; khi đó một thành viên đang có khóa sẽ tự niêm phong khóa vault cho họ.

Gói & thanh toán

Xem và mua gói ở trang Bảng giá. Thanh toán bằng thẻ (Stripe) hoặc PayPal, theo tháng hoặc theo năm; có thể nhập mã giảm giá. Gói trả trước, không tự trừ tiền — bạn nhận email nhắc trước khi hết hạn và gia hạn ở trang Tài khoản.

Tính năng mở khóa trong ứng dụng vài giây sau khi thanh toán (hoặc khi bạn quay lại ứng dụng).
Gói Team / Business tính theo ghế; thành viên trong team vault của bạn dùng tính năng của gói.
Khi gói hết hạn, dữ liệu không mất: bạn vẫn tải được vault về mọi thiết bị, chỉ các tính năng của gói bị khóa lại.

Còn thắc mắc? Báo lỗi hoặc đề xuất tính năng.