Cài đặt

Nhấn Cmd+, (Ctrl+, trên Windows) hoặc bấm Cài đặt ở cuối thanh bên. Hộp thoại mở sẵn mục Appearance. Vài nút ở chỗ khác mở nó thẳng vào mục khác: liên kết cài đặt trong popover của Token Meter mở mục Token Meter, nút Nhập mã giấy phép trong lời nhắc nâng cấp mở mục License & Activation, và biểu tượng bánh răng trên header Machines cùng biểu tượng chìa khoá trên thanh tiêu đề (hiện khi mật khẩu truy cập đang bật) mở mục Remote Access & Devices. Đóng bằng Esc, nút ×, hoặc bấm ra ngoài hộp thoại.

Phần lớn tên mục hiển thị bằng tiếng Anh ở mọi ngôn ngữ giao diện. General, Agents, Account, My Devices, Privacy và Feedback có bản dịch riêng: giao diện tiếng Việt hiện Chung, Agents (giữ nguyên), Tài khoản, Máy của tôi, Quyền riêng tư và Góp ý.

Chỉ có một thiết lập: Mở cùng máy, để MXterm Pro tự chạy khi bạn đăng nhập vào máy. Công tắc này phản ánh đúng những gì hệ điều hành đang đăng ký, nên nếu bạn tắt ở nơi khác, ví dụ trong System Settings của macOS, thì công tắc ở đây cũng đổi theo.

Độ tương phản tối thiểu nâng những màu terminal quá sát màu nền; phần còn lại của bảng màu theme giữ nguyên. Màu pane đang chọn là màu của viền đánh dấu pane đang hoạt động, còn Làm mờ pane không chọn quyết định các pane còn lại lùi đi bao nhiêu; pane đứng một mình trong tab thì không bao giờ bị làm mờ. MXterm Black và MXterm Slate không làm các pane kia mờ dần sang màu xám: chúng làm tối pane bằng lớp đen, và cũng thanh trượt đó chỉnh mức. Cả mười theme đều là theme tối. Theme áp dụng cho thanh bên, dải tab và mọi pane terminal, và bạn tự chọn bằng tay.

Ngôn Ngữ Giao Diện / Language là một menu chọn: nó hiện ngôn ngữ đang dùng, và mở ra thì liệt kê đủ mười một ngôn ngữ. English, tiếng Indonesia, tiếng Việt và tiếng Trung đứng đầu, rồi đến tiếng Nhật, tiếng Hàn, tiếng Tây Ban Nha, tiếng Pháp, tiếng Thổ Nhĩ Kỳ, tiếng Bồ Đào Nha (Brazil) và tiếng Đức. Mỗi dòng ghi tên của chính ngôn ngữ đó, kèm tên tiếng Anh mờ bên cạnh khi hai tên khác nhau, và dấu tích đánh dấu ngôn ngữ đang dùng. Không có cờ. Tiếng Trung giản thể, tiếng Nhật, tiếng Hàn, tiếng Tây Ban Nha, tiếng Pháp và tiếng Thổ Nhĩ Kỳ được thêm ở bản 1.1.11, còn tiếng Indonesia, tiếng Bồ Đào Nha (Brazil) và tiếng Đức được thêm sau đó. Lựa chọn có tác dụng ngay.

Thiết lập chữ áp dụng ngay cho các terminal đang mở, và Đặt lại mặc định đưa chúng về mặc định. Trên macOS, font nào máy chưa có sẽ được đánh dấu chưa cài đặt trong danh sách. Trên Windows app không đọc được danh sách font đã cài, nên mỗi font có tên đều được đánh dấu không rõ tình trạng. Shell chỉ ảnh hưởng tới pane tạo sau khi đổi; terminal đang chạy giữ nguyên shell cũ.

Số cột tối thiểu giữ cho chương trình không bị ép hẹp. Pane hẹp hơn số cột đó sẽ hiện chữ nhỏ hơn, theo bước nửa pixel, để chương trình vẫn có đủ số cột; một chương trình toàn màn hình được báo pane chỉ có 13 cột sẽ ngắt dòng đầu ra theo độ rộng đó, và các chỗ ngắt này vẫn còn khi pane rộng ra lại. Chữ lớn trở lại khi pane đủ rộng, và không bao giờ vượt quá Cỡ chữ (hoặc mức zoom riêng của pane). Nếu muốn đủ số cột mà chữ phải nhỏ hơn 8 px, pane không bị thu nhỏ nữa và chương trình nhận số cột thật, như khi tắt cài đặt này. Mặc định bật ở mức 80 và áp dụng cho các pane trên máy này. Giảm theo bước 10 tới Tắt (0) để tắt. Reset to default đưa nó về 80.

Thư Mục Làm Việc Mặc Định SSH quyết định kết nối mở từ SSH & SFTP Manager bắt đầu ở đâu. Nếu chính host đã lưu thư mục mặc định thì thư mục đó được ưu tiên. Tuỳ chọn Ghi nhớ thư mục ở phiên gần nhất đã được bỏ ở bản 1.0.22: từ trước tới nay nó vẫn chạy y hệt Thư mục Home (~), vì app chưa bao giờ ghi lại thư mục cuối cùng. Xem thêm SSH và SFTP.

Khi bật Manage Claude Code's status line, app ghi một mục statusLine vào ~/.claude/settings.json, để pane Claude Code hiện Claude Code đã kết nối tới MCP server của MXterm Pro hay chưa và phiên đã dùng bao nhiêu context. Nếu bạn đã có status line tự cấu hình, app không đụng vào.

Khi bật Chế độ Chat (thử nghiệm), pane đang chạy Claude Code, Codex, omp hoặc Grok có thể chuyển giữa terminal và bản chat dễ đọc của cuộc trò chuyện, đọc từ file transcript của chính agent. Bạn chuyển từng pane bằng nút trên đầu pane hoặc phím Cmd+Shift+J (Ctrl+Shift+J trên Windows). Pane agent mới mở ở chế độ xem bạn chọn gần nhất, ban đầu là Chat cho tới khi bạn chọn Terminal, và mỗi pane giữ chế độ xem nó dùng lần cuối. Chat chỉ là một lớp phủ, nên việc chuyển không đụng tới chương trình đang chạy.

Agents có một dòng cho từng coding agent trong số 27 agent mà MXterm Pro chạy được, liệt kê ở trang Agent. Làm mới kiểm tra lại. Mỗi dòng cho biết:

• Đã cài hay Chưa cài đặt. MXterm Pro tìm file thực thi của agent ở đúng những chỗ mà form tạo workspace tìm. Nó chỉ nhìn tên file trong các thư mục đó và không bao giờ chạy chương trình. Với Cursor Agent, file đó là cursor-agent chứ không phải cursor, vốn là launcher của editor.
• Agent đã vào Control Room chưa: Chưa vào Control Room, N pane trong phòng · M đã kết nối (bản tiếng Anh: N panes in a room · M connected), hoặc Đã vào phòng nhưng chưa gọi MXterm lần nào. Pane được đếm theo agent mà nó được mở ra, nên một pane shell thường mà bạn tự gõ tên agent vào thì không được đếm.
• MXterm Pro có tự thiết lập công cụ MCP cho agent đó không: MXterm tự cài công cụ cho agent này (Claude Code, Codex, Gemini CLI, Grok và OMP) hoặc Chưa xác minh cách cài công cụ với các agent còn lại, vốn có thể cần thiết lập thủ công như mô tả ở Coding agent và Control Room.
• Cờ bỏ qua xác nhận mà Bypass Mode thêm vào, với các agent có cờ đó. Với Goose, vốn không có cờ, dòng này hiện biến môi trường GOOSE_MODE=auto.
• Với agent chưa cài, Cách cài mở lệnh cài kèm Chép lệnh và đường dẫn tới trang của hãng. MXterm Pro không bao giờ tự chạy lệnh cài cho bạn. Những agent mà hãng không đưa ra lệnh cài, như Amp, Cursor Agent, Antigravity và Aider, chỉ hiện đường dẫn tới trang của hãng.

Worktrees MXterm đã tạo là một thẻ trên màn hình Agents. Nó liệt kê các thư mục trong .worktrees/ mà MXterm tạo cho agent hoặc tab cô lập, tìm qua các thư mục gần đây của bạn. Bấm Hiện danh sách để tải: không có gì được quét ngầm, và không có gì bị xóa tự động. Mỗi hàng ghi nhánh, đường dẫn, dung lượng, thư mục thay đổi cách đây bao lâu và một nhãn: An toàn để xóa, Có thay đổi chưa commit, Chưa merge hoặc Đang dùng (có pane đang mở trong đó, hãy đóng pane trước). Xóa hỏi xác nhận, và hỏi lần thứ hai khi thay đổi chưa commit hoặc commit chưa merge sẽ mất; nhánh luôn được giữ lại. Dọn mục cũ hiện khi git còn liệt kê một worktree mà thư mục đã biến mất.

Hiện tài khoản đã đăng nhập mặc định tắt. Khi bật, MXterm Pro đọc email tài khoản từ file của chính từng agent (~/.claude.json, ~/.codex/auth.json, ~/.gemini/google_accounts.json và ~/.grok/auth.json; Claude Code và Codex theo CLAUDE_CONFIG_DIR và CODEX_HOME nếu có đặt) rồi hiện nó trên dòng của agent đó, hoặc Không thấy tài khoản. Chỉ email được đọc: không đọc token, không đụng Keychain. Tắt công tắc thì email bị xoá khỏi bộ nhớ ngay.

Danh sách theo agent chỉ có chín agent mà MXterm Pro đọc được trạng thái. Pane shell thường không gửi thông báo. Banner ghi gì và bấm vào thì đi đâu có ở Coding agent và Control Room.

Ghim lên đầu nằm đầu tiên. Đây là một menu chọn nhà cung cấp nào được popover Token Meter liệt kê trước: Claude Code, Codex, Gemini, Agent khác, DeepSeek, Moonshot, Kimi, MiniMax, OpenRouter hoặc Z.ai, hoặc Không ghim (thứ tự cố định). Claude Code được ghim mặc định. Popover vẫn liệt kê mọi nhà cung cấp bạn đã thiết lập, và con số trên thanh tiêu đề không theo mục ghim này: nó vẫn theo giới hạn gần hết nhất.

Dưới mục Giới hạn gói có hai công tắc, cả hai đều tắt mặc định.

• Hiện phần trăm giới hạn thật của Claude: app đọc thông tin đăng nhập Claude Code từ Keychain macOS qua công cụ security của hệ thống nên macOS không hỏi mỗi lần, rồi gọi api.anthropic.com để lấy mức dùng gói. Token chỉ nằm trong bộ nhớ, còn transcript không được gửi đi. Khi tắt, thanh đo hiện số token đã dùng thay cho phần trăm. Nếu macOS từ chối đọc, công tắc vẫn tắt cho tới khi bạn bật lại. Nếu Claude Code chưa đăng nhập trên máy này, chạy claude trong terminal để đăng nhập rồi thử lại. Chạy MXterm Pro với MXTERM_DISABLE_KEYCHAIN=1 sẽ chặn việc đọc dù công tắc thế nào, dành cho máy không cho đụng vào mục keychain của app khác. Chỉ chạy trên macOS. Công tắc vẫn hiện trên Windows, nhưng app không đọc được phần đăng nhập của Claude Code ở đó, nên luôn báo Claude Code chưa đăng nhập, dù thực tế có hay không.
• Hạn mức Codex trực tiếp: app đọc thông tin đăng nhập ChatGPT của chính Codex từ ~/.codex/auth.json và chỉ gửi nó tới chatgpt.com. App không bao giờ sửa hay làm mới thông tin đăng nhập đó, và thông tin Codex lưu trong keychain hệ thống thì không được đọc, nên hãy chạy codex login nếu panel báo là chưa có. Nếu để tắt, hạn mức của Codex vẫn hiện, đọc từ file phiên của Codex trên máy này, nên chỉ mới bằng lượt Codex gần nhất của bạn.

Bên dưới, mục Tài khoản nhà cung cấp nhận API key của DeepSeek, Moonshot, Kimi, MiniMax, OpenRouter và Z.ai, để thanh đo hiện được phần còn lại trong các tài khoản đó. Dán key vào rồi bấm Lưu; dòng đó sẽ hiện Đã lưu key · …abcd, tức bốn ký tự cuối, và Gỡ key xoá key đi. Moonshot, MiniMax và Z.ai còn có menu Khu vực: Quốc tế hoặc Trung Quốc với Moonshot, Toàn cầu hoặc Trung Quốc với MiniMax và Z.ai, lựa chọn đầu là mặc định. Với Z.ai, một key chỉ chạy trong đúng khu vực của nó. Nếu Kimi Code CLI đã đăng nhập sẵn trên máy này, dòng Kimi tự nhận phần đăng nhập đó từ ~/.kimi-code và ghi rõ như vậy; key bạn dán vào được ưu tiên. Panel ghi rõ key được cất ở đâu: Key được lưu trong macOS Keychain và chỉ gửi tới đúng nhà cung cấp đó. Trên Windows các key được lưu qua kho thông tin đăng nhập của hệ thống thay vì macOS Keychain, dù chữ trên panel vẫn ghi macOS Keychain.

Thanh đo hiển thị những gì được giải thích ở Token Meter.

Tài khoản là nơi bạn đăng nhập tài khoản MXterm. Khi chưa đăng nhập, thẻ ghi Tài khoản MXterm, kèm dòng mô tả và nút Đăng nhập bằng tài khoản MXterm. Nút này mở trình duyệt và hiện Đang chờ trình duyệt… cho tới khi bạn xong. Nếu lỗi, thẻ ghi Không đăng nhập được: kèm lý do. Khi đã đăng nhập, thẻ hiện Đã đăng nhập với kèm email của bạn và nút Đăng xuất.

Trong lúc đã đăng nhập, thẻ Thiết bị chờ duyệt liệt kê các thiết bị xin tham gia tài khoản này. Hãy kiểm tra mã khớp với mã thiết bị kia đang hiện, gõ 4 số cuối của nó rồi bấm Duyệt. Thẻ này ẩn khi không có gì đang chờ.

Đăng nhập là miễn phí. Đây cũng là điều cho phép bạn kích hoạt Pro bằng một ghế do team giao ở mục License & Activation, và Máy của tôi cần nó.

Pro được mở khoá theo từng máy, bằng cách kích hoạt mã license ở mục này, hoặc bằng tài khoản MXterm nếu bạn được giao một ghế trên license.

1. Mở Cài đặt và chọn License & Activation.
2. Dán mã trong email mua hàng (dạng MXTERM-XXXX-XXXX-XXXX-XXXX) vào ô dưới Kích hoạt mã bản quyền.
3. Bấm Activate.

Được team giao ghế? Dưới ô nhập mã, Đăng nhập tài khoản MXterm đăng nhập qua trình duyệt, rồi nút Kích hoạt với kèm email của bạn kích hoạt máy này bằng tài khoản, không cần mã. Nếu tài khoản có ghế trên nhiều license, panel yêu cầu bạn chọn một. Máy kích hoạt theo cách này không bao giờ hiện mã license cho bạn.

Kích hoạt liên lạc với mxterm.net. App gửi mã license, bản băm của mã phần cứng máy, tên máy, phiên bản app và hệ điều hành. Server tính máy này vào giới hạn số thiết bị của license và trả về một token license đã ký, app lưu token đó lại. Sau đó app kiểm tra lại license qua mạng mỗi lần mở app (tối đa mỗi giờ một lần) và cứ 24 giờ một lần khi đang chạy. Nếu không kết nối được mxterm.net thì không có gì thay đổi và Pro vẫn dùng được khi không có mạng. Pro chỉ bị gỡ khi server từ chối rõ ràng hai lần liên tiếp với cùng một lý do. Dán sai hoặc gõ nhầm mã không làm mất license hợp lệ mà máy này đang có: biểu mẫu chỉ hiện lỗi và license vẫn như cũ. Khi một license bị gỡ, do lần kiểm tra qua mạng, Huỷ kích hoạt thiết bị hoặc Vẫn gỡ khỏi thiết bị này, nó được gỡ ở mọi nơi trong app cùng lúc, không cần khởi động lại.

Sau khi kích hoạt, mục này hiện license ở trạng thái Active, kèm ngày kích hoạt và, ở phần Giới hạn thiết bị, số thiết bị đang dùng trên giới hạn của bạn. Khi server chưa báo giới hạn, panel hiện — chứ không bịa ra một con số. Chưa có mã? Bấm Mua MXterm Pro ngay trong mục này, hoặc xem Bảng giá.

Nếu một lần kiểm tra qua mạng gỡ Pro khỏi máy này, panel cho biết lý do: license đã được hoàn tiền, bị thu hồi, mã không còn hợp lệ, hoặc máy này bị gỡ khỏi license vì suất của nó đã chuyển sang máy khác. Hãy nhập lại mã để lấy lại một suất.

Huỷ kích hoạt thiết bị giải phóng suất của máy này để bạn dùng nó ở máy khác. Nút này hỏi trước (Huỷ kích hoạt thiết bị này? / Thao tác này giải phóng suất của thiết bị này trên giấy phép, để bạn kích hoạt trên máy khác. Tính năng Pro sẽ dừng trên thiết bị này.), và khi bạn xác nhận, nó hiện Đang giải phóng suất… trong lúc báo cho mxterm.net, rồi báo Đã giải phóng suất của thiết bị này. Bạn có thể kích hoạt giấy phép trên máy khác.

Mục này là phía host của Pane trên một MXterm khác: nó cho thiết bị khác xem, và nếu bạn cho phép thì gõ vào, những pane bạn chọn. Mục này chiếm cả hộp thoại Cài đặt thành một màn hình riêng có tiêu đề Truy cập từ xa & Thiết bị đã ghép, với một mũi tên quay lại và ba tab: Kết nối, Thiết bị và Nâng cao. Biểu tượng bánh răng trên header Machines ở thanh bên mở thẳng tới đây. Server tắt cho tới khi bạn bấm Bật server, trừ khi công tắc Tự chạy máy chủ host khi mở MXterm đang bật. Trong Nâng cao, Xoá ảnh nhận từ thiết bị khác sau xoá ảnh do điện thoại, iPad hoặc máy khác gửi tới Mac này, mặc định sau 7 ngày (Tắt, hoặc 1, 3, 7, 14 hay 30 ngày). Dọn ngay chạy ngay và hỏi trước khi cài đặt đang Tắt. Lịch sử Control Room và tệp đính kèm của bạn không bao giờ bị đụng tới, còn ảnh điện thoại dán vào một pane luôn bị xoá sau 24 giờ.

• Một huy hiệu cho biết server sẽ dùng mạng nào: Tailscale Mesh VPN (truy cập toàn cầu), Mạng Wi-Fi nội bộ (chỉ LAN) hoặc Chỉ máy này (không ra mạng). MXterm Pro chọn địa chỉ Tailscale nếu máy có. Một địa chỉ mạng nội bộ riêng (10.x, 172.16 tới 172.31.x hoặc 192.168.x) chỉ được dùng khi Cho phép thiết bị trong mạng nội bộ (không mã hoá) đang bật, và khi đó là dùng thêm bên cạnh Tailscale. Khi cả địa chỉ mạng nội bộ lẫn địa chỉ Tailscale đều trả lời, địa chỉ mạng nội bộ được liệt kê trước và dẫn đầu mã QR ghép nối. Công tắc đó tắt mặc định. Nếu không thì server ở lại 127.0.0.1, chỉ chính máy này vào được. Nếu địa chỉ duy nhất với tới được là địa chỉ mạng nội bộ mà công tắc đang tắt, Bật server từ chối và nói rõ lý do. Server không bao giờ phục vụ trên địa chỉ công khai.
• Bật server và Dừng server bật và tắt bộ lắng nghe, còn tiêu đề của thẻ cho biết mạng nào: Host server · Tailscale, Host server · Mạng nội bộ (local) hoặc Host server · Local. Khi đang chạy, panel ghi Đang bind kèm địa chỉ. Cổng là 6868. MXterm Pro thử trước cổng nó đã bind lần trước, rồi từ 6868 tới 6877, nên địa chỉ đã lưu vẫn dùng được trừ khi chương trình khác chiếm cổng đó. Nếu cả mười cổng đều bận thì panel báo như vậy.
• Dưới phần điều khiển server, Cho phép thiết bị trong mạng nội bộ (không mã hoá) tắt mặc định. Khi tắt, server chỉ nghe qua Tailscale, vốn có mã hoá. Khi bật, server nghe trên địa chỉ Tailscale của bạn và còn nghe thêm trên từng địa chỉ mạng nội bộ riêng của máy này, không mã hoá, nên ai trong Wi-Fi đó theo dõi được lưu lượng đều có thể lấy token của thiết bị đã ghép và mở các pane bạn chia sẻ. Bật nó sẽ hỏi xác nhận và không tự chạy server. Tắt nó sẽ dừng server đang nghe trên mạng nội bộ. Các bản trước tự dùng mạng nội bộ; giờ nó tắt cho tới khi bạn cho phép.
• Cho phép bỏ qua kiểm tra quyền từ xa, ngay cạnh đó, tắt mặc định. Khi tắt, thiết bị yêu cầu tạo phiên không bao giờ được bỏ qua kiểm tra quyền của agent, dù thiết bị đó có quyền tạo phiên. Khi bật, yêu cầu có xin bỏ qua sẽ được đáp ứng, và máy Mac này hiển thị phiên nào đã được mở theo cách đó.
• Thẻ ghép nối là một cột canh giữa. Trên cùng là mã ghép dài 6 ký tự, trong một khung cùng bộ đếm ngược (hết hạn sau 5 phút). Cuối khung có hai nút biểu tượng: chép, đưa mã vào clipboard, và Mã mới, biểu tượng làm mới, tạo mã khác. Khi chưa có mã còn hiệu lực, app tự tạo một mã. Khi host đang tắt, một dòng ngắn dưới công tắc gợi ý cách kết nối: qua mạng nội bộ khi bật công tắc, kèm địa chỉ của Mac này (hoặc lời nhắc bật Cho phép thiết bị trong mạng nội bộ), và Tailscale, nói là đã thấy hay cách có nó. Bên dưới mã có một dòng nhắc bấm Mã mới để hiện mã QR: mã QR chứa địa chỉ và mã ghép, để quét bằng app MXterm trên điện thoại, chỉ xuất hiện sau khi bạn bấm nút đó. Sau đó là từng địa chỉ cần mở trên thiết bị kia, mỗi địa chỉ kèm tên đường đi và một nút chép ở cuối dòng. Thiết bị đăng nhập cùng tài khoản MXterm còn có thể xin ghép mà không cần mã: Mac hiện hộp thoại Cho phép / Từ chối kèm dãy số để đối chiếu với dãy số thiết bị đó hiển thị, và bấm Cho phép là ghép xong. Yêu cầu hết hạn sau 90 giây, còn thiết bị của tài khoản khác bị từ chối.
• Trong mạng nội bộ, kết nối không được mã hóa, và panel cảnh báo rằng ai trong Wi-Fi đó lấy được token đều mở được các pane bạn chia sẻ. Hãy dùng mạng bạn tin cậy, hoặc Tailscale vì Tailscale có mã hóa. Khi chưa cài Tailscale, panel gợi ý Cài Tailscale giúp tôi; khi đã cài mà chưa kết nối, panel nhắc bạn đăng nhập. Dưới cả hai gợi ý này, liên kết Hướng dẫn dùng Tailscale với MXterm Pro mở bài hướng dẫn về việc host bind vào địa chỉ nào trên mxterm.net. Khi host chạy với quyền truy cập mạng nội bộ đang bật, MXterm Pro được thiết kế để tự thông báo qua Bonjour để điện thoại ở gần tìm thấy nó; thông báo này không mang token và không cấp quyền truy cập nào.
• Đang nối liệt kê từng thiết bị đang kết nối vào một pane được chia sẻ, kèm pane đó và thời điểm nối, cùng nút Ngắt. Ngắt chỉ kết thúc phiên của thiết bị đó trên pane đó và chặn nó cho tới khi bạn chia sẻ lại pane. Việc ghép nối vẫn giữ nguyên.
• Thiết bị từ xa đã cấp quyền liệt kê từng thiết bị đã ghép cùng loại của nó, Trình duyệt hoặc App MXterm, thời điểm ghép và lần thấy gần nhất. Thu hồi gỡ một thiết bị. Mỗi thiết bị có công tắc Có thể tạo phiên mới, tắt với mọi thiết bị mới ghép. Khi bật, thiết bị đó mở được pane mới trên máy này từ màn hình của chính nó. Mỗi thiết bị còn có công tắc Có thể quản lý Control Room, mặc định tắt: khi bật, app MXterm trên điện thoại hoặc máy tính đó tạo được Control Room, chọn người điều phối, thêm hoặc bỏ thành viên và xóa phòng (phòng chính của một tab thì không xóa được) ngay từ màn hình của nó. Giới hạn gói Free về phòng và thành viên áp dụng ở đó giống như trên máy này. Trước khi mở, app MXterm trên điện thoại cho thấy agent nào đã cài trên máy này, tìm bằng cùng cách quét với Settings → Agents; agent mà việc quét không kiểm tra được vẫn được đưa ra. Mỗi thiết bị còn có Ẩn mọi pane: khi bật, thiết bị đó không thấy pane nào của máy này và không mở hay gõ vào được pane nào. Dọn thiết bị không dùng trên 30 ngày gỡ các thiết bị cũ chỉ bằng một cú bấm. Thiết bị thuộc loại nào cũng vậy, không dùng trong 30 ngày sẽ tự hết hiệu lực, và mỗi lần dùng tính lại 30 ngày. App MXterm bạn đã ghép vẫn còn ghép khi host này khởi động lại: host chỉ giữ bản băm của token, không giữ token.

Quả cầu trên thanh tiêu đề mở cùng mã ghép, mã QR và các địa chỉ đó mà không cần vào Cài đặt. Các địa chỉ nằm trên cùng, mỗi địa chỉ kèm đường đi của nó (Mạng nội bộ hoặc Tailscale, mạng nội bộ đứng trước khi cả hai cùng trả lời) và một nút chép ở cuối dòng. Dưới các địa chỉ, mã ghép nằm giữa trong một khung cùng bộ đếm ngược, biểu tượng chép và nút biểu tượng Mã mới. Mã QR lúc đầu chưa hiện: một dòng dưới khung nhắc bấm Mã mới, và mã QR hiện ở dưới khung sau khi bạn bấm; app tự tạo mã khi chưa có. Mở menu bằng bàn phím rồi nhấn Enter không bật tắt công tắc chính; hãy di chuyển bằng phím mũi tên hoặc Tab trước. Bấm ra ngoài menu là đóng. Khi chưa có đường đi nào, menu đưa ra bước Tailscale kế tiếp: Tải Tailscale khi chưa cài, Mở Tailscale khi đã cài nhưng đang tắt, và liên kết Cách hoạt động. Khi Tailscale kết nối, menu báo vậy và, nếu chưa thấy thiết bị nào khác, nhắc bạn đăng nhập Tailscale trên điện thoại bằng cùng tài khoản. Thẻ Cloudflare WARP chỉ hiện trong menu khi WARP thật sự đang chặn Tailscale.

Có thể xuất hiện thêm một thẻ ở tab Cài đặt & Máy chủ. Thẻ Cloudflare WARP chỉ hiện khi máy có cài WARP (hoặc để cảnh báo khi một VPN khác đang mang toàn bộ lưu lượng). WARP có thể chặn Tailscale trong khi Tailscale vẫn báo Connected, và công tắc trên thẻ thêm các địa chỉ nó cần vào danh sách loại trừ của WARP, rồi gỡ đúng những gì nó đã thêm khi bạn tắt.

Mặc định không chia sẻ gì. Bạn chia sẻ một pane từ quả cầu trên header của nó. Chọn Điều khiển (thiết bị đã ghép xem và gõ được, mỗi lúc một thiết bị) hoặc Chỉ xem (không gõ được), rồi chọn thời gian: 30 phút, 1 giờ, 8 giờ hoặc đến khi bạn tắt. Muốn chia sẻ mọi pane của cửa sổ chính cùng lúc, bật Chia sẻ mọi pane ở quả cầu trên thanh tiêu đề, mục này hiện khi máy chủ host đang chạy. Chọn trước Điều khiển hoặc Xem ở công tắc hai phần của dòng đó và thời gian ở danh sách thả xuống (1 giờ, 4 giờ, 8 giờ hoặc Đến khi tắt); cả hai được nhớ. Lần đầu là Xem trong 1 giờ, còn Điều khiển chỉ cần một cú bấm, không hỏi xác nhận. Pane bạn mở khi công tắc đang bật cũng được chia sẻ, việc chia sẻ tự kết thúc khi hết hạn, và tắt công tắc chỉ ngừng chia sẻ những pane do nó chia sẻ. Khi công tắc bật, dòng đó hiện số pane đang được chia sẻ, tính cả pane bạn chia sẻ bằng tay. Giới hạn Free về số pane chia sẻ cùng lúc vẫn áp dụng, và menu cho biết có bao nhiêu pane không chia sẻ được.

Với gói Free, mặc định 1 máy tính khác được ghép để điều khiển máy này, và tối đa 5 pane được chia sẻ cùng lúc. App MXterm trên điện thoại (iPhone, iPad) không được tính vào giới hạn 1 máy tính khác điều khiển Mac này. Chỉ máy tính khác chạy MXterm mới được tính; trình duyệt thì không. Dưới mã ghép có một ghi chú, ví dụ Free: 1/1 máy tính khác được điều khiển máy này. Điện thoại và máy tính bảng không bị giới hạn., kèm nút nâng cấp khi đã chạm giới hạn. Máy tính mới vượt giới hạn bị từ chối khi ghép, và cho phép một máy từ yêu cầu ghép sẽ mở lời nhắc nâng cấp. Chia sẻ pane thứ sáu cũng mở lời nhắc nâng cấp. Cả hai giới hạn đều không gỡ một lần ghép hay một lần chia sẻ đã có. mxterm.net có thể đổi các con số này. Pro không giới hạn cả hai. Xem Bảng giá.

Host tự kết thúc phiên chia sẻ khi tới hạn, và đổi giữa hai chế độ thì thời gian còn lại giữ nguyên. Khi pane đang được chia sẻ, nút trên header của nó (là con mắt khi ở chế độ Chỉ xem) hiện thời gian còn lại, nếu phiên chia sẻ có hạn, và số thiết bị đang nối. MXterm Pro được thiết kế để khôi phục các lượt chia sẻ sau khi khởi động lại, khi từng pane chạy lại. Xem Pane trên một MXterm khác.

• Thông báo trên điện thoại chưa có. Mục này mô tả cách chúng được thiết kế, và khi ra mắt chỉ có trạng thái thay đổi.
• Phía Mac có một công tắc, Báo về điện thoại khi agent cần tôi hoặc làm xong, trong Settings → Remote Access & Devices → Advanced. Công tắc tắt mặc định và cần bạn đã đăng nhập tài khoản MXterm. Khi tắt, Mac không gửi gì. App iPhone chưa đăng ký nhận các thông báo này, nên hiện chưa có điện thoại nào nhận được gì.
• Bạn được báo khi agent cần bạn và khi agent đã xong.
• Khi bạn đang ở máy Mac, Mac không gửi gì. 2 phút không gõ phím hay di chuột thì tính là đã rời máy. Công tắc thứ hai bên dưới, Vẫn báo các thiết bị khác khi tôi đang ở máy này, tắt mặc định; bật lên để vẫn được báo, ví dụ khi kiểm thử. Nó chỉ dùng được khi công tắc thứ nhất đang bật.
• Thông báo chỉ có tên agent, thư mục, tên của pane cùng tab của nó và, khi agent làm xong, thời gian agent đã làm, không bao giờ có nội dung terminal, prompt, lệnh hay đường dẫn. Tên pane là tên bạn đã đặt, hoặc tên agent nếu bạn chưa đặt; tiêu đề do một chương trình đặt trong terminal thì không bao giờ được gửi. Nó còn có thể mang một dòng ngắn là câu hỏi mà agent đặt ra (chỉ câu hỏi thường, không bao giờ cho yêu cầu cấp quyền; tối đa 120 ký tự; liên kết, đường dẫn tệp, địa chỉ email và khóa được xóa trên máy Mac của bạn, và dòng nhắc tới mật khẩu, token hay bí mật thì không được gửi). Dòng này mặc định bật khi thông báo điện thoại đã bật; tắt trong Settings → Remote Access & Devices → Advanced, cạnh công tắc thông báo điện thoại. Các tên này và dòng đó đi qua máy chủ của MXterm và Apple để hiện trên màn hình khóa; MXterm không lưu chúng. Với câu hỏi thường (không bao giờ là câu hỏi cấp quyền), nó còn có thể mang một mã của câu hỏi đó để điện thoại trả lời được.
• Với yêu cầu cấp quyền, banner có thể hiện Duyệt và Từ chối, và điện thoại phải đang mở khóa. iOS hạn chế những gì chạy được khi app đã đóng, nên một thao tác có thể chờ đến khi bạn mở app.
• Bạn chọn sự kiện nào, máy tính nào và khung giờ yên tĩnh nào.
• Miễn phí ở mọi gói. Bắt đầu trên iPhone, và Apple Watch phản chiếu banner.
• Thông báo được gửi qua dịch vụ push của Apple. Về những gì mxterm.net lưu, xem chính sách quyền riêng tư.

Truy cập khi không có người ở máy là một thẻ trong Remote Access & Devices, để vào được máy này khi không có ai ngồi trước nó. Thẻ có hai công tắc, và dưới mỗi công tắc có một dòng cho biết hiện đang diễn ra chuyện gì.

• Tự chạy máy chủ host khi mở MXterm mặc định tắt. Khi bật, MXterm Pro tự chạy host server mỗi lần khởi động. Dùng cùng Mở cùng máy trong Chung, máy vào lại được sau khi khởi động lại. Các lượt chia sẻ được khôi phục khi từng pane chạy lại, nên việc khởi động lại tự nó không kết thúc một lượt chia sẻ.
• Giữ Mac thức khi có pane đang chia sẻ mặc định bật (trên Windows là Giữ máy thức khi có pane đang chia sẻ). Nó chặn ngủ do để không khi host server đang chạy và có ít nhất một pane được chia sẻ. Màn hình vẫn có thể tắt.

Nếu chưa có mạng khi MXterm mở, việc chạy sẽ thử lại sau 5 giây, rồi 10 giây, rồi cứ 15 giây một lần. Nó bỏ cuộc sau 5 phút nếu vẫn chưa có mạng hoặc việc chạy cứ lỗi, và thẻ ghi rõ lý do. Bấm Bật server hoặc Dừng server, hay tắt công tắc, là dừng việc thử lại.

Nếu lần chạy trước là trên Tailscale, nó đợi Tailscale trong 5 phút đó chứ không chạy ngay trên địa chỉ mạng nội bộ. Khi Cho phép thiết bị trong mạng nội bộ đang tắt, nó không bao giờ chạy trên mạng nội bộ: sau 5 phút không có Tailscale, thẻ ghi Không chạy máy chủ: sau 5 phút Tailscale vẫn chưa kết nối, và truy cập qua mạng nội bộ đang tắt. Khi công tắc bật, nó chỉ dùng địa chỉ mạng nội bộ lúc hết thời gian.

Máy chỉ được giữ thức khi cả ba điều kiện đều đúng: server đang chạy, có ít nhất một pane được chia sẻ, và công tắc đang bật. MXterm Pro kiểm tra lại mỗi 15 giây và mỗi khi một phiên chia sẻ, server hay công tắc đổi, nên pane bị đóng lúc đang chia sẻ sẽ cho máy ngủ lại trong khoảng 15 giây.

Cách này chỉ chặn ngủ do để không. Nó không chặn được giấc ngủ do chính bạn gây ra, như gập nắp laptop (Mac chạy pin vẫn ngủ khi bạn gập nắp). Nếu hệ thống từ chối, thẻ ghi Hệ thống không cho giữ máy thức: kèm lý do.

Thẻ Mật khẩu truy cập cho thiết bị mới ghép nối bằng mật khẩu thay vì đọc mã trên màn hình này. Thiết bị ghép theo cách này có token riêng, bạn thu hồi được ở Thiết bị từ xa đã cấp quyền, y như khi ghép bằng mã. Mật khẩu không mở được gì mà mã ghép không mở được. Mặc định nó tắt.

Mật khẩu được nhận qua Tailscale và, khi bạn cho phép, qua mạng nội bộ, nơi nó đi không mã hóa. Nó không bao giờ được nhận trên địa chỉ loopback của chính máy Mac này. Khi server đang dừng hoặc chỉ nghe trên 127.0.0.1, thẻ cho biết vì sao lúc này mật khẩu chưa ghép được thiết bị nào.

Gõ mật khẩu ít nhất 6 ký tự rồi bấm Lưu, nút nằm bên phải ô nhập, hoặc bấm nút xúc xắc bên cạnh (Tạo ngẫu nhiên) để có một cụm mật khẩu ngẫu nhiên. Khi mật khẩu đang bật, thẻ hiện huy hiệu Đang bật màu xanh lá, và Đổi mật khẩu mở lại cùng ô nhập với hai nút đó. Mật khẩu tạo ra chỉ hiện một lần và không xem lại được. Nó được lưu dưới dạng bản băm Argon2id trong kho thông tin xác thực của hệ thống (Keychain trên macOS), không bao giờ nằm trong file. Đổi mật khẩu không làm các thiết bị đã ghép bị đăng xuất.

Khi mật khẩu đang bật, một biểu tượng chìa khoá hiện trên thanh tiêu đề: xanh lá cho Tạm thời, rê chuột vào để xem thời gian còn lại, và màu hổ phách cho Thường trực và cho mật khẩu Tạm thời sắp hết hạn. Bấm vào để mở Remote Access & Devices. Khi mật khẩu tắt thì không hiện gì.

Host giới hạn việc đoán mật khẩu. Sau 3 lần đoán sai từ một địa chỉ, mỗi lần sai tiếp theo khóa địa chỉ đó lâu hơn, bắt đầu từ 5 giây và nhân đôi dần tới 15 phút. Host cũng chỉ cho tối đa 20 lần đoán sai mỗi 10 phút trên mọi địa chỉ cộng lại.

Ba thao tác dưới đây nằm trong mục Vùng nguy hiểm, một dòng tiêu đề bạn bấm để mở, canh giữa trong thẻ. Tắt (giữ các thiết bị) màu xanh lá: dừng việc dùng mật khẩu để ghép thiết bị mới, còn các thiết bị nó đã ghép vẫn còn ghép. Đăng xuất mọi thiết bị thu hồi mọi trình duyệt và app MXterm đã ghép, ngắt chúng khỏi mọi pane, và giữ nguyên mật khẩu. Tắt và đăng xuất mọi thiết bị làm cả hai. Các nút tắt chỉ hiện khi mật khẩu đang bật. Mỗi thao tác đều hỏi xác nhận.

Để ghép một MXterm khác bằng mật khẩu này, mở mục Machines của nó. Form thêm host và hộp thoại Ghép lại có hai lựa chọn Mã và Mật khẩu. Chọn Mật khẩu và dùng địa chỉ Tailscale của máy này (100.x.y.z) để ghép có mã hóa, với Tailscale chạy trên cả hai máy; địa chỉ mạng nội bộ cũng dùng được nhưng không mã hóa. Thông báo lỗi không cho biết mật khẩu sai hay host chưa bật mật khẩu.

Máy của tôi kết nối tới một máy Mac khác đã đăng nhập cùng tài khoản MXterm, không cần mã ghép và không cần mật khẩu. Mục này cần tài khoản đã đăng nhập và Pro. Khi chưa đăng nhập, nó yêu cầu bạn đăng nhập trước và có nút Tài khoản. Với gói Free, nó hiện Máy của tôi là tính năng Pro kèm nút nâng cấp.

Nếu không thì nó liệt kê các thiết bị đáng tin khác trên tài khoản của bạn, kèm nút làm mới. Mỗi dòng có tên thiết bị và huy hiệu Đã liên kết khi đã kết nối, công tắc Có thể tạo phiên mới, một ô địa chỉ và nút Kết nối, và nút Mở khi đã liên kết. Gõ địa chỉ host của máy Mac kia, ví dụ http://192.168.1.50:6868, rồi bấm Kết nối. Khi chưa có thiết bị nào khác, panel ghi Chưa có thiết bị tin cậy nào khác: hãy đăng nhập cùng tài khoản trên một Mac khác, nó sẽ hiện ra khi liên kết ngược lại với máy này.

Ở bản 1.0.22, phần gửi thống kê sử dụng được tách khỏi Updates & About thành mục Quyền riêng tư riêng, kèm một cách tạo file gửi cho bộ phận hỗ trợ.

Công tắc Chia sẻ dữ liệu sử dụng ẩn danh mặc định bật, và chỉ áp dụng cho bản phát hành chính thức. Mỗi lần mở app nó gửi đúng một sự kiện app_open tới Google Analytics kèm phiên bản app và hệ điều hành, và không gửi thêm gì tới Google Analytics trong phần còn lại của lần chạy đó: không có tín hiệu lặp lại. Mỗi ngày một lần nó gửi phiên bản, gói Free hay Pro, phiên bản hệ điều hành, loại CPU, số lần mở app, lần chạy trước có bị crash không, và số lần lời nhắc nâng cấp được hiện ra và được bấm. Khi có lỗi, nó gửi đó là lỗi nào trong danh sách cố định các lỗi đã biết, kèm mã lý do. Tất cả gắn với một mã ngẫu nhiên không liên kết với bạn. App không bao giờ gửi nội dung terminal, đường dẫn tệp, host hay tên đăng nhập SSH, hoặc license key. Tắt công tắc là ngừng gửi. Danh sách đầy đủ những gì được gửi có ở Telemetry.

Cùng công tắc này cũng điều khiển số đếm sử dụng: mỗi ngày một lần, cùng báo cáo hằng ngày, app gửi số đếm và khoảng giá trị về việc bạn dùng tính năng nào, không bao giờ gửi bạn đã gõ hay mở gì. Danh sách đầy đủ có ở Telemetry. Tắt công tắc là ngừng gửi báo cáo sử dụng mới, và số đếm sử dụng được giữ 400 ngày.

Bạn cũng tắt được từ bên ngoài app, tiện khi bạn cài máy giúp người khác. Hãy khởi động MXterm Pro với biến môi trường DO_NOT_TRACK hoặc MXTERM_TELEMETRY_DISABLED đặt thành một giá trị không rỗng bất kỳ, khác 0, false và no. Biến môi trường được ưu tiên hơn công tắc: khi đó công tắc bị làm mờ và ghi Đã bị tắt bởi …, nêu rõ tên biến.

Thẻ Tệp chẩn đoán cho bộ phận hỗ trợ tạo một file để gửi kèm khi bạn nhờ hỗ trợ: Thông tin app và lỗi gần đây, đã lọc thông tin nhạy cảm. Không tự tải lên cho tới khi bạn gửi: hãy xem ở đây trước. Từ MXterm Pro 1.1.74, Gửi cho MXterm mở Feedback dưới dạng báo lỗi với tệp này đã được tích sẵn; không có gì được gửi cho tới khi bạn bấm Send ở đó. Xem trước hiện nội dung file ngay trong panel, kèm nút Chép và Email bộ phận hỗ trợ, để bạn đọc trước khi lưu hay gửi bất cứ gì. Lưu tệp… mở hộp thoại lưu đề xuất tên mxterm-diagnostics-YYYY-MM-DD.json trên Desktop, rồi có Hiện trong Finder (Hiện trong File Explorer trên Windows) và Email bộ phận hỗ trợ.

• File chứa phiên bản app và cho biết đó là bản chính thức hay bản phát triển, thời gian chạy, gói bạn đang dùng, ngôn ngữ, hệ điều hành cùng phiên bản của nó và loại CPU, trạng thái telemetry, lần chạy trước có crash không, số host SSH đã lưu, số tab và số pane, các agent bạn dùng, các nhà cung cấp Token Meter đã thiết lập, cùng các lỗi gần đây lấy từ một danh sách cục bộ 14 ngày.
• Thư mục home của bạn được ghi thành ~, và mỗi lỗi chỉ giữ lại những giá trị có dạng mã định danh.
• File không bao giờ chứa nội dung terminal, câu lệnh, đường dẫn tệp, tên host, license key hay địa chỉ email.
• File hoàn chỉnh còn được kiểm tra trước khi ghi. Nếu có gì trong đó vướng quy tắc riêng tư, app không lưu gì cả và panel cho bạn biết quy tắc nào đã chặn.

Góp ý là nơi bạn gửi tin nhắn cho đội MXterm. Chọn đó là loại nào: Góp ý (một ý tưởng hoặc nhận xét), Cải thiện tính năng (tính năng dùng được nhưng nên tốt hơn) hoặc Báo lỗi. Rồi viết nội dung và bấm Send (các phiên bản cũ hơn hiện Soạn email; xem bên dưới).

Từ MXterm Pro 1.1.57 trên Mac (1.1.58 trên Windows và Linux), Send gửi tin nhắn tới mxterm.net: tên, email và nội dung của bạn, loại tin, phiên bản app, hệ điều hành và ngôn ngữ của app, cùng tệp chẩn đoán chỉ khi bạn tích chọn (giữ 90 ngày). Nhà cung cấp email của chúng tôi xử lý tin nhắn, và mỗi giờ gửi được tối đa 3 lần. Nếu gửi không được, app đề nghị mở app thư của bạn.

Ở các phiên bản cũ hơn, ứng dụng email của bạn mở ra với thư gửi tới support@mxterm.net. Tiêu đề ghi loại thư, chẳng hạn [MXterm 1.1.31] Bug report; hai loại còn lại là Suggestion và Feature improvement. Phần thân để trống phía trên một chân thư ngắn gồm phiên bản MXterm Pro, hệ điều hành và ngôn ngữ của app.

Ở các phiên bản đó, MXterm Pro không tự gửi gì: thư chỉ đi khi bạn bấm Gửi trong ứng dụng email. Dùng trang liên hệ trên web mở trang liên hệ trên mxterm.net. Với lỗi, panel gợi ý đính kèm tệp chẩn đoán, và Mở Quyền riêng tư đưa bạn tới Tệp chẩn đoán cho bộ phận hỗ trợ.

App kiểm tra phiên bản mới trên mxterm.net 5 giây sau khi mở, rồi cứ 4 giờ một lần.

Khi có bản cập nhật, nút Update to vX.Y.Z hiện ở cuối thanh bên, ngay dưới Cài đặt. Bấm để tải về. Nút hiện Downloading… kèm phần trăm, rồi đổi thành Restart to update. Nếu tải lỗi, nút đổi thành Retry update và lỗi nằm trong tooltip. Một thẻ nhỏ ở góc dưới bên trái cửa sổ cũng báo khi bản cập nhật đã sẵn sàng, bằng một ghi chú ngắn rằng tab và phiên chat sẽ được mở lại sau khi cập nhật. Nếu còn pane đang chạy, một dòng cho biết có bao nhiêu pane và gợi ý nên cập nhật khi chúng làm xong; khởi động lại thì lệnh đang chạy sẽ dừng. Đóng thẻ bằng nút × (không đóng được khi đang tải); thẻ hiện lại khi có bản mới hơn. Xem thử trong Updates & About hiện thẻ với một phiên bản mẫu: các nút chỉ giả lập, không tải gì và app không khởi động lại.

Muốn tự kiểm tra, bấm Kiểm tra cập nhật trong Updates & About, hoặc chọn Check for Updates… trong menu của biểu tượng MXterm Pro trên menu bar (khay hệ thống trên Windows). Mục này hiện phiên bản của bạn kèm số build, chẳng hạn v1.1.31 · build 2573, và bạn đã ở bản mới nhất chưa. Nếu việc kiểm tra lỗi, nó ghi Không kiểm tra được bản cập nhật: kèm lý do, và nếu tải lỗi thì ghi Tải bản cập nhật thất bại: kèm lý do, thay vì hiện như đã là bản mới nhất. Khi có bản mới, nó hiện release notes cùng nút Tải & cài đặt, tải xong thì có Khởi động lại để áp dụng. Xem nhật ký cập nhật cho xem trình cập nhật đã làm những gì.

Chỉ có một kênh phát hành và không đổi được. Mục này cũng chứa Giấy phép mã nguồn mở, danh sách các thư viện mà MXterm Pro được dựng lên từ đó.