⚡ OxideTerm

Không gian làm việc vận hành máy chủ từ xa có AI — ứng dụng gốc viết hoàn toàn bằng Rust
Terminal SSH, Telnet, nối tiếp, RDP/VNC, SFTP, chuyển tiếp cổng và chỉnh sửa nhẹ trong một không gian làm việc gốc.
Kết xuất GPU. Miễn phí. Không cần tài khoản.
Không dùng Electron. Không đóng gói WebView. Không thu thập dữ liệu đo từ xa. Không thuê bao. Ưu tiên BYOK. SSH thuần Rust không dùng OpenSSL/libssh2.

_{Mã nguồn mở, ưu tiên cục bộ và kết xuất GPU bằng GPUI.}

Tổng quan tính năng của OxideTerm

--- ## OxideTerm là gì OxideTerm là không gian làm việc mã nguồn mở cho SSH và vận hành từ xa. Terminal, tệp, chuyển tiếp cổng, công cụ máy chủ và màn hình từ xa được tập trung trong một nơi. **Bạn có thể làm gì:** - Quản lý SSH, Telnet, serial, RDP/VNC, SFTP, chuyển tiếp cổng, shell cục bộ và chỉnh sửa nhẹ trong một không gian làm việc - Duy trì công việc từ xa qua gián đoạn mạng ngắn bằng cơ chế kết nối lại Grace Period - Yêu cầu OxideSens kiểm tra phiên đang hoạt động và thực hiện các hành động đã được phê duyệt qua nhà cung cấp AI của bạn Kết nối và dữ liệu vận hành vẫn do bạn kiểm soát. OxideSens dùng nhà cung cấp AI của bạn và không yêu cầu tài khoản. --- ## Vì sao chọn OxideTerm? | Nếu bạn quan tâm đến… | OxideTerm cung cấp… | |---|---| | Một nút từ xa, nhiều công cụ | Terminal, SFTP, chuyển tiếp cổng, RDP/VNC, trzsz, IDE native, giám sát và OxideSens AI cùng thuộc một workspace | | Ứng dụng desktop không có Electron hoặc WebView đi kèm | GPUI vẽ giao diện trực tiếp trên bề mặt GPU mà không phân phối runtime trình duyệt | | Quy trình vận hành local-first | SSH, Telnet, SFTP, chuyển tiếp, RDP/VNC, shell cục bộ, terminal nối tiếp và cấu hình hoạt động không cần đăng ký | | OxideSens AI BYOK thay vì tín dụng nền tảng | OxideSens dùng endpoint OpenAI, Anthropic, Gemini, Ollama hoặc tương thích OpenAI của bạn, với MCP, RAG, điều khiển suy luận theo nhà cung cấp và các thao tác workspace đã được phê duyệt | | Độ ổn định khi kết nối lại | Grace Period thăm dò kết nối cũ trong 30 giây trước khi thay thế, để ứng dụng TUI vượt qua các gián đoạn mạng ngắn | | SSH Rust thuần và an toàn thông tin xác thực | Ngăn xếp SSH dùng `russh` + `ring` không cần OpenSSL/libssh2; thông tin xác thực đã lưu dùng móc khóa hệ thống và gói `.oxide` dùng ChaCha20-Poly1305 + Argon2id | --- ## Ảnh chụp màn hình Các ảnh dưới đây thể hiện quy trình terminal, tệp, chỉnh sửa và chuyển tiếp của OxideTerm.

Terminal SSH + OxideSens AI	Trình quản lý tệp SFTP
IDE tích hợp	Chuyển tiếp cổng thông minh

--- ## Thiết kế cho vận hành từ xa OxideTerm giữ kết nối, tệp, chuyển tiếp, công cụ máy chủ, tự động hóa và ngữ cảnh AI trong một không gian Rust. Các công cụ dùng chung danh tính máy chủ và vòng đời phiên. | Khía cạnh | Cách tiếp cận có trình duyệt đi kèm | OxideTerm | |---|---|---| | **Kết xuất** | Công cụ trình duyệt và bố cục web | GPUI trên bề mặt GPU | | **Luồng dữ liệu terminal** | WebSocket → vòng lặp sự kiện JS → xterm.js | Đầu vào Rust → thay đổi `TerminalState` → kết xuất GPUI | | **Vòng đời kết nối** | Tách giữa lớp frontend và backend | Một quy trình kết nối và kết nối lại trong cùng tiến trình | | **Ngữ cảnh AI** | Sao chép qua cầu nối ứng dụng | Tạo từ workspace đang hoạt động với phê duyệt của người dùng | | **Runtime plugin** | Môi trường script của trình duyệt | Đường chạy manifest-only, WASM giới hạn theo khả năng và process cần được tin cậy rõ ràng | | **CLI** | Cần ứng dụng desktop đang chạy | Binary độc lập, liên kết trực tiếp các crate | | **Ranh giới runtime** | Trình bao desktop cùng runtime trình duyệt | Tiến trình native không có runtime trình duyệt đi kèm | --- ## Tính năng | Danh mục | Tính năng | |---|---| | **Terminal và kết nối** | Shell cục bộ, SSH, Telnet, serial, khung chia, chế độ nhập tự do, gửi lệnh nâng cao đến nhiều mục tiêu, multi-hop và kết nối lại ổn định | | **Tệp và chỉnh sửa từ xa** | SFTP, hàng đợi truyền, dấu trang, ghi an toàn, cây dự án và chỉnh sửa theo tab | | **Chuyển tiếp và mạng** | Chuyển tiếp cục bộ, từ xa và SOCKS5 động, quy tắc đã lưu và gỡ lỗi socket | | **Vận hành máy chủ và màn hình từ xa** | Giám sát, tiến trình, dịch vụ, log, cổng, tác vụ, đĩa, gói, container, tmux, RDP và VNC | | **OxideSens và tự động hóa** | Nhà cung cấp AI riêng, MCP, RAG cục bộ, Agent Skills, hành động được duyệt, đồng bộ mã hóa và CLI | | **Mở rộng và cá nhân hóa** | Plugin manifest-only, WASM và process, tab tùy chỉnh, lệnh nhanh, chủ đề, hình nền, phím tắt và 11 ngôn ngữ | ---

OxideSens mở terminal bên trong OxideTerm

*OxideSens làm theo yêu cầu của người dùng và mở một terminal bên trong OxideTerm.*

--- ## Kiến trúc OxideTerm hợp nhất terminal, SSH, Telnet, RDP, VNC, SFTP, chuyển tiếp, IDE, AI, plugin và CLI trong một kiến trúc Rust. Chi tiết kỹ thuật được trình bày bên dưới.

Kiến trúc, nội bộ SSH, shell GPUI, kết nối lại, AI, plugins và hơn nữa

### Kiến trúc — lõi cùng tiến trình, không cầu nối WebView ```text GPUI Render Loop WorkspaceApp / bề mặt tab / khung nhìn GPUI │ trong tiến trình Arc<> / async Các crate miền NodeRouter → SshConnectionRegistry TerminalState ← SSH PTY channel SftpSession / ForwardingRuntime / IdeWorkspace Ai/ACP Entities / CloudSync / Plugin Runtimes ``` Không có ranh giới tuần tự hóa giữa giao diện và phần nền SSH/terminal. Dữ liệu terminal sửa `TerminalState` trực tiếp; GPUI đọc trạng thái và phát lệnh vẽ GPU. ### SSH Rust thuần — russh (ring) - **Ngăn xếp SSH không dùng OpenSSL/libssh2** — `ring` cung cấp mật mã SSH - SSH2 đầy đủ: trao đổi khóa, kênh, phân hệ SFTP, chuyển tiếp cổng - ChaCha20-Poly1305 / AES-GCM, khóa Ed25519/RSA/ECDSA - SSH Agent trên Unix (`SSH_AUTH_SOCK`) và Windows (`\\.\pipe\openssh-ssh-agent`) - ProxyJump nhiều bước nhảy với xác thực độc lập ở từng bước ### Kết nối lại thông minh với Grace Period 1. Phát hiện SSH keepalive timeout mà không bị JavaScript timer throttling 2. Chụp lại bảng terminal, truyền tải SFTP, chuyển tiếp và tệp IDE 3. Probe kết nối cũ trong 30 giây Grace Period để TUI apps có thể sống qua thay đổi mạng 4. Nếu không phục hồi được, kết nối lại, khôi phục chuyển tiếp, tiếp tục hoặc thử lại truyền tải theo chính sách và mở lại tệp IDE Pipeline: `queued → snapshot → grace-period → ssh-connect → await-terminal → restore-forwards → retry-or-resume-transfers → restore-ide → verify → done` ### SSH pool kết nối và node routing - Ở chế độ mặc định, một SSH connection vật lý có thể phục vụ terminal, SFTP, chuyển tiếp cổng và IDE; terminal có thể dùng connection riêng khi chính sách yêu cầu - Mỗi kết nối đi qua `connecting → active → idle → link_down → reconnecting` - UI gọi theo `nodeId`; `NodeRouter` resolve `connectionId` đang active một cách atomic - `NodeRuntimeStore` giữ trạng thái runtime của node và xuất topology snapshot; helper của workspace ghi snapshot vào `session_tree.json`, còn handle đang chạy được dựng lại khi khởi động - Lỗi máy chủ trung chuyển sẽ truyền trạng thái `link_down` tới các nút phía sau ### OxideSens AI OxideSens vẫn ưu tiên BYOK, với xây dựng ngữ cảnh chạy trong tiến trình: - Nhà cung cấp: OpenAI, Anthropic, Gemini, Ollama hoặc điểm truy cập OpenAI-compatible - MCP: truyền qua stdio và SSE, khám phá và gọi công cụ - RAG: tìm kiếm toàn văn BM25, chỉ mục vector HNSW, Reciprocal Rank Fusion và bộ tách từ bigram CJK - Thông điệp gửi tới nhà cung cấp được lọc mẫu thông tin xác thực; ngữ cảnh không gian làm việc và hành động vẫn do người dùng kiểm soát - Khóa API được lưu trong kho khóa hệ điều hành và chủ động loại khỏi nhật ký có cấu trúc cùng thông điệp của lõi desktop ### Giao diện desktop GPUI UI được vẽ trực tiếp bằng GPUI, không có DOM/CSS/JavaScript rendering pipeline: - Các loại tab trong không gian làm việc: terminal cục bộ, SSH, Telnet, nối tiếp, RDP, VNC, SFTP, IDE, Forwards, Settings, Plugin, Topology và hơn nữa - Binary pane tree với dividers kéo được, tối đa bốn panes mỗi terminal tab - Command palette, global key bindings và sidebars dùng GPUI primitives - Kết xuất chế độ tức thời phản ứng với trạng thái Rust mà không cần tuần tự hóa khứ hồi ### Trạng thái terminal và kết xuất Kết xuất terminal được mô hình hóa trước thành trạng thái Rust, rồi GPUI vẽ ra: - PTY output đi vào `TerminalState`; scrollback, cursor, selection, marks và search state đều ở trong Rust - Kết xuất policy có thể chuyển giữa Boost, Normal và Idle mà không cần browser event loop hợp tác - Sixel và Kitty graphics được theo dõi như terminal-owned assets, không phải DOM nodes hoặc canvas overlays - Các pane dùng chung mô hình trạng thái không gian làm việc, nên khôi phục tab và kết nối lại có thể snapshot topology terminal cùng nhau ### Không gian làm việc SFTP và IDE Tệp từ xa là một phần của cùng không gian làm việc của nút, không phải tính năng tách rời: - SFTP sessions được resolve qua `NodeRouter` cùng connection generation; khi kết nối lại có thể lấy lại session hợp lệ, nhưng thao tác của generation cũ không bao giờ bị âm thầm thay bằng connection mới - Hàng đợi truyền theo dõi hướng, tiến độ, trạng thái thử lại và giới hạn tốc độ độc lập với các khung tệp đang hiển thị - Tab IDE lưu cùng bộ đệm chưa lưu, đường dẫn từ xa, trạng thái xung đột và siêu dữ liệu khôi phục - Khi backend hỗ trợ, remote writes dùng staged/atomic behavior để tránh partial writes trong edit flow thông thường ### Plugin, CLI và chẩn đoán Nhánh gốc giữ phần mở rộng và bề mặt hỗ trợ trong ranh giới Rust gốc: - Plugin hỗ trợ đường chạy manifest-only, WASM và process thông thường. WASM dùng runtime Wasmtime/WASI tích hợp; process plugin là tiến trình cục bộ không có sandbox cấp hệ điều hành. - CLI link trực tiếp crate miền cho doctor, settings, connections, forwards, gói di động, backups và reports - Chẩn đoán ưu tiên số đếm, đường dẫn, cờ tính năng và gợi ý đã che thay vì payload thô có bí mật - CLI flows có thay đổi state dùng dry-run plans, `--yes` guards và rollback backups khi phù hợp ### Chuyển tiếp cổng — I/O không khóa - Local `-L`, Remote `-R`, Dynamic SOCKS5 `-D` - Một task `ssh_io` sở hữu mỗi SSH Channel, tránh `Arc>` - Reconnect auto-restore, báo cáo kết thúc và hết thời gian nhàn rỗi ### trzsz — truyền file in-band trzsz tiếp tục dùng terminal stream, không cần port phụ hoặc remote agent: - Upload/download qua terminal stream hiện có - Hoạt động xuyên qua ProxyJump chains - Native file pickers tránh giới hạn bộ nhớ của browser - Transfer hai chiều, hỗ trợ thư mục, limits có thể cấu hình ### Export `.oxide` mã hóa - **ChaCha20-Poly1305 AEAD** authenticated encryption - **Argon2id KDF**: 256 MB memory cost, 4 iterations, tăng chi phí GPU brute-force - Bao gồm connections, forwards, settings, quick commands, cài đặt plugin và portable bí mật

--- ## Chạy từ mã nguồn **Yêu cầu:** toolchain Rust (phiên bản 2024) và môi trường desktop có thể chạy GPUI. ```sh cargo run OXIDETERM_RENDER_PROFILE=compatibility cargo run ./scripts/build/build-cli.sh ./scripts/build/build-agent.sh ``` ## CLI CLI không giao diện `oxideterm` hoạt động mà không cần khởi chạy ứng dụng, hữu ích cho tự động hóa, CI và chẩn đoán. ```sh cargo run -p oxideterm-cli -- doctor --strict cargo run -p oxideterm-cli -- settings validate --strict --json cargo run -p oxideterm-cli -- connections search prod cargo run -p oxideterm-cli -- forwards list --format json cargo run -p oxideterm-cli -- cloud-sync push --dry-run --json cargo run -p oxideterm-cli -- oxide export ./profile.oxide --connection prod --password-stdin cargo run -p oxideterm-cli -- report --bundle ./oxideterm-report.zip cargo run -p oxideterm-cli -- completion install zsh --force ``` ## Ngăn xếp công nghệ | Lớp | Công nghệ | Ghi chú | |---|---|---| | Giao diện | GPUI (Zed) | Chế độ tức thời dùng GPU, thuần Rust | | Môi trường chạy | Tokio + DashMap | Xử lý bất đồng bộ và bản đồ đồng thời | | SSH | russh (`ring`) | Không dùng OpenSSL/libssh2 trong ngăn xếp SSH; hỗ trợ SSH Agent | | Terminal | portable-pty + alacritty_terminal | PTY cục bộ, mô phỏng terminal và đồ họa Sixel/Kitty | | Plugin | Wasmtime/WASI và process | Manifest-only, lời gọi host WASM được kiểm soát và process cục bộ cần được tin cậy rõ ràng | | AI và tìm kiếm | SSE + BM25 + HNSW | Truyền dữ liệu nhà cung cấp, bigram CJK và hợp nhất RRF | | Trình soạn thảo | tree-sitter (cú pháp), bộ đệm riêng | Đa ngôn ngữ, dựa trên SFTP | | Mã hóa | ChaCha20-Poly1305 + Argon2id | AEAD + KDF dùng nhiều bộ nhớ (256 MB) | | i18n | oxideterm-i18n | Bộ tải tích hợp, 11 ngôn ngữ phát hành | ## Bảo mật | Concern | Implementation | |---|---| | Thông tin xác thực đã lưu | macOS Keychain / Windows Credential Manager / libsecret | | Bí mật trong bộ nhớ | Kiểu dữ liệu chứa bí mật và bộ đệm tạm dùng `zeroize` / `Zeroizing` tại các ranh giới sở hữu được hỗ trợ | | Chẩn đoán | Báo cáo hỗ trợ ưu tiên siêu dữ liệu có cấu trúc và gợi ý đã che thay cho dữ liệu chứa bí mật | | Ngữ cảnh AI | Thông điệp gửi tới nhà cung cấp được lọc mẫu thông tin xác thực; ngữ cảnh workspace và hành động vẫn do người dùng kiểm soát | | `.oxide` | ChaCha20-Poly1305 + Argon2id | | Ghi bằng CLI | Kế hoạch chạy thử, bảo vệ `--yes`, bản sao lưu khôi phục | | Khóa máy chủ | TOFU với `~/.ssh/known_hosts`, từ chối thay đổi không mong đợi | | Plugin | manifest-only, API host WASM được kiểm soát và process cục bộ cần được tin cậy rõ ràng | ## Lưu ý về sử dụng hợp pháp OxideTerm được cấp phép theo GPL-3.0-only và không kèm hạn chế giấy phép bổ sung. Khi sử dụng, chỉ truy cập các hệ thống, mạng và thiết bị thuộc sở hữu của bạn hoặc bạn được cấp quyền rõ ràng, đồng thời tuân thủ pháp luật hiện hành. Không sử dụng OxideTerm để truy cập trái phép, gây gián đoạn dịch vụ hoặc vượt qua cơ chế kiểm soát truy cập. ## Đóng góp Chúng tôi hoan nghênh đóng góp về mã nguồn, tài liệu, bản dịch, plugin, kiểm thử và tái hiện lỗi. Hãy thảo luận thay đổi lớn hoặc bản sửa lỗi có phạm vi rõ ràng trong issue. ```sh cargo run -p oxideterm-cli -- report --bundle ./oxideterm-report.zip ``` --- ## Hỗ trợ và bảo trì Báo cáo lỗi và hồi quy có bước tái hiện cùng chẩn đoán đã che được ưu tiên. Yêu cầu tính năng được đánh giá theo phạm vi, an toàn và mức độ phù hợp với định hướng không gian làm việc máy chủ từ xa của OxideTerm.

Nếu OxideTerm hỗ trợ quy trình làm việc của bạn, một ngôi sao GitHub, báo cáo tái hiện lỗi, bản sửa dịch thuật hoặc plugin đều giúp dự án tiếp tục phát triển. --- ## Giấy phép **GPL-3.0-only**. Thông báo chi tiết về bên thứ ba nằm trong [`THIRD_PARTY_NOTICES.md`](../../THIRD_PARTY_NOTICES.md), cùng thông tin bổ sung trong [`NOTICE`](../../NOTICE). ## Lời cảm ơn Xin cảm ơn `russh`, `GPUI`, `alacritty_terminal`, `portable-pty`, `wasmtime` và `tree-sitter`.