9Remote là gì? Phân tích decolua/9remote và cách dùng từ điện thoại

9Remote là gì? Phân tích repo decolua/9remote và hướng dẫn sử dụng dễ hiểu

Ảnh trích xuất từ GitHub Open Graph preview của repo decolua/9remote. Ảnh không phải SVG.¹

Tóm tắt nhanh

9Remote là công cụ giúp bạn điều khiển terminal, remote desktop và file explorer của máy Mac/Linux/Windows từ điện thoại hoặc trình duyệt. Repo chính thức mô tả 9Remote là “Terminal in Your Pocket”: truy cập terminal, desktop và file explorer của máy tính từ bất kỳ phone/browser nào, ở bất kỳ đâu.²

Nói dễ hiểu: bạn chạy 9remote trên máy dev chính, quét QR bằng điện thoại, rồi dùng terminal/desktop/file explorer ngay trên trình duyệt mobile. Bạn có thể mở Claude Code, Codex CLI, Cursor, OpenClaw hoặc bất kỳ CLI tool nào chạy trong terminal host, sau đó điều khiển từ điện thoại.³

9Remote khác 9Router. 9Router là AI provider router/proxy; 9Remote là remote access workspace. Kết hợp hai công cụ này thì bạn có thể: chạy AI coding tool trên máy dev, routing model qua 9Router, và điều khiển toàn bộ workflow từ điện thoại bằng 9Remote.

9Remote giải quyết vấn đề gì?

Remote access truyền thống thường vướng nhiều cấu hình: SSH key, firewall, port forwarding, VPN, IP whitelist, desktop remote app, mobile UX kém hoặc không có file explorer. README của 9Remote liệt kê các vấn đề này và định vị 9Remote là giải pháp “one command, scan QR, done”.⁴

Luồng cơ bản:

Máy dev Mac/Linux/Windows
  ↓ chạy 9remote
Cloudflare Quick Tunnel hoặc LAN
  ↓
Điện thoại / tablet / browser
  ↓
Terminal + Remote Desktop + File Explorer + Code Editor

Mục tiêu của 9Remote là biến điện thoại thành một “remote workspace” đủ dùng cho developer: sửa bug nhanh, chạy command, xem log, sửa config, commit/push, kiểm tra giao diện mobile hoặc điều khiển AI coding agent.

9Remote không phải là gì?

Điểm cuối cần ghi rõ: README GitHub nói source code chưa open-source và license hiện là Proprietary — All Rights Reserved, dù website có dòng “Open source · MIT License”. Vì nội dung repo là nguồn chính, bài này xem trạng thái hiện tại là npm package miễn phí trong giai đoạn phát triển, source chưa mở, MIT dự kiến khi đạt milestone.⁵⁶

Repo decolua/9remote có gì đáng chú ý?

Trang GitHub mô tả decolua/9remote là công cụ “Terminal in Your Pocket” để điều khiển Claude Code, Codex, Gemini CLI và máy Mac/Linux/Windows từ phone/browser; repo hiển thị khoảng 259 stars tại thời điểm tham khảo và chỉ có vài commit.⁷

README nêu:

• Cài bằng npm install -g 9remote.
• Chạy bằng 9remote.
• Quét QR để pair device.
• Không cần port forwarding, firewall rules hoặc signup.
• Dùng Cloudflare Quick Tunnel để kết nối outbound.
• Có terminal, remote desktop, file explorer, code editor, Git integration.
• Có local sites proxy để mở localhost:3000 hoặc localhost:5173 trên điện thoại.
• Có AI integration với Claude Code, Codex, Cursor, OpenClaw và bất kỳ CLI tool nào chạy trong terminal.⁸

Cài đặt nhanh

Theo Getting Started docs, yêu cầu là Node.js 18+ và hệ điều hành macOS, Linux hoặc Windows.⁹

Cài global:

npm install -g 9remote

Kiểm tra:

9remote --version

Chạy server:

9remote

Khi chạy, 9Remote sẽ:

1. Start local server trên port 2208.
2. Tạo Cloudflare tunnel.
3. Sinh QR code để kết nối nhanh từ điện thoại.¹⁰

Sau đó bạn quét QR bằng camera hoặc QR scanner. Trình duyệt sẽ mở trang kết nối và bạn vào workspace.¹¹

Kết nối bằng QR hoặc key

9Remote có hai cách kết nối:

Cách 1: Quét QR
Cách 2: Nhập key thủ công tại https://9remote.cc/login

README nói lần đầu chạy, 9Remote tạo hai loại key:

Repo cũng nói keys không được lưu trên server sau khi session kết thúc.¹²

Các tính năng chính

Remote Terminal

Terminal là chức năng cốt lõi. Docs nói 9Remote Terminal cho phép truy cập terminal đầy đủ từ browser, giống như đang ngồi trước máy tính.¹³

Tính năng đáng chú ý:

• nhiều terminal session song song;
• copy/paste giữa device và remote terminal;
• nhiều theme như Default, Light, Dracula, Monokai, Solarized;
• bàn phím mobile có Ctrl, Alt, Shift, Esc, arrow keys, Tab, F1–F12;
• session chạy nền khi đổi tab;
• phù hợp chạy shell, git, build, deploy, Claude Code, Codex CLI.

Ví dụ dùng trên phone:

cd ~/project
git status
npm test
claude
codex "fix the failing checkout test"

Docs khuyến nghị dùng tmux hoặc screen nếu muốn phiên lệnh bền hơn khi mất kết nối.¹⁴

Remote Desktop

Remote Desktop cho phép xem và điều khiển màn hình máy tính từ browser. Docs mô tả các chức năng: real-time screen streaming, tile-based rendering, quality adjustment, mouse control và keyboard input.¹⁵

Trên macOS, README nói remote desktop cần quyền:

System Settings → Privacy & Security → Screen Recording
System Settings → Privacy & Security → Accessibility

Sau đó bật:

TUI menu → Remote Desktop → Toggle ON

Remote Desktop phù hợp khi cần mở UI, kiểm tra app, xem browser, thay đổi setting hoặc thao tác không tiện bằng terminal.

Hạn chế theo docs:

• chưa hỗ trợ audio streaming;
• video playback có thể choppy;
• không phù hợp high-FPS gaming;
• multi-monitor chỉ hiển thị primary monitor;
• hiệu năng phụ thuộc network, CPU, resolution và số vùng màn hình thay đổi.¹⁶

File Explorer và Code Editor

Docs nói 9Remote File Explorer cho phép browse filesystem, edit code với syntax highlighting và thực hiện Git operations từ browser.¹⁷

Tính năng:

• duyệt thư mục;
• breadcrumb và recent workspaces;
• built-in editor có syntax highlighting cho 20+ ngôn ngữ;
• line numbers, auto indentation, find/replace;
• tạo, rename, delete, copy file/folder;
• xem Git status, diff, commit, push;
• search file theo tên.

Editor shortcut:

Ctrl+S  Save
Ctrl+F  Find
Ctrl+H  Find and replace
Ctrl+Z  Undo
Ctrl+Y  Redo
Tab     Indent
Shift+Tab Outdent

Hạn chế theo docs:

• chưa hỗ trợ binary files như images/videos;
• file rất lớn trên 10MB không phù hợp;
• upload/download file được ghi là coming soon;
• large folders có thể chậm.¹⁸

Local Sites Proxy

README nói 9Remote có thể auto-detect local dev servers và proxy chúng ra tunnel để mở trên điện thoại.¹⁹

Ví dụ:

http://localhost:3000  →  https://<tunnel>/proxy/3000/
http://localhost:5173  →  https://<tunnel>/proxy/5173/

Dùng khi:

• test responsive design trên điện thoại thật;
• kiểm tra UI mobile không cần USB;
• demo WIP build cho khách hàng/team;
• debug frontend đang chạy local.

AI coding từ điện thoại

README và FAQ nói 9Remote hoạt động với Claude Code, OpenAI Codex CLI, Cursor, OpenClaw và bất kỳ CLI tool nào chạy trong terminal.³

Ví dụ workflow:

cd ~/project
claude
# hoặc
codex "review this PR and suggest fixes"
# hoặc
cursor-agent

Điểm quan trọng: AI coding tool vẫn chạy trên máy host. Điện thoại chỉ là giao diện điều khiển. Nhờ đó, file hệ thống, repo, credential và runtime vẫn nằm trên máy dev.

9Remote và 9Router khác nhau thế nào?

Kết hợp:

Phone
  ↓ 9Remote
Máy dev chạy Claude Code/Codex
  ↓ API endpoint
9Router
  ↓
Provider/model thật

So sánh với SSH, VPN, TeamViewer, Chrome Remote Desktop

README có bảng so sánh 9Remote với Claude Remote, TeamViewer, Chrome Remote Desktop và Termius. Theo README, 9Remote nổi bật ở việc kết hợp terminal, remote desktop, file explorer, code editor, Git integration, QR login, auto tunnel, mobile optimization, AI integration và không cần account.²⁰

Cách hiểu thực tế:

Kiến trúc kỹ thuật

README liệt kê tech stack chính:²¹

Luồng đơn giản:

9remote CLI
  ↓
Local server :2208
  ↓
Cloudflare Quick Tunnel hoặc LAN
  ↓
Web/mobile client
  ↓
Terminal / desktop / file explorer

Docs cũng nói 9Remote có LocalFirstAdapter: nếu phone và host cùng Wi-Fi, hệ thống race LAN vs tunnel và dùng kết nối nhanh hơn; traffic có thể ở lại local nếu LAN nhanh hơn.²²

Nền tảng hỗ trợ

Theo README:

Host nơi chạy 9Remote agent:

• macOS Intel + Apple Silicon
• Linux x64, arm64
• Windows x64

Client nơi kết nối:

• Chrome, Safari, Firefox, Edge
• iOS 14+
• Android 8+
• Tauri desktop app cho macOS, Windows, Linux²³

Hướng dẫn dùng thực tế

1. Chạy 9Remote

npm install -g 9remote
9remote

2. Kết nối từ điện thoại

Quét QR trong terminal hoặc mở:

https://9remote.cc/login

rồi nhập access key.

3. Mở terminal

Chạy:

cd ~/project
git status
npm run dev

4. Mở local site trên phone

Nếu app chạy ở:

http://localhost:3000

9Remote có thể proxy sang:

https://<tunnel>/proxy/3000/

5. Dùng AI coding

claude
# hoặc
codex "fix auth bug and run tests"

6. Sửa file nhanh

Mở File Explorer, chọn project, sửa file, Ctrl+S, xem diff, commit và push.

Triển khai cho cá nhân

Thiết lập tối thiểu:

# Cài Node.js 18+
node -v

# Cài 9Remote
npm install -g 9remote

# Chạy
9remote

Khuyến nghị:

• Dùng trên máy cá nhân, không chạy bằng user root/admin nếu không cần.
• Tạo project folder rõ ràng.
• Dùng terminal-only nếu mạng chậm.
• Dùng LAN mode khi ở cùng Wi-Fi.
• Bật remote desktop chỉ khi cần.
• Dừng streaming desktop khi dùng xong.
• Nếu chạy AI coding tool, kiểm tra credential và permission của tool.

Triển khai cho team

Giai đoạn 1: dùng cá nhân

• Developer cài 9Remote trên máy riêng.
• Dùng để truy cập terminal, file explorer, local dev server.
• Chỉ pair device cá nhân.
• Không chia sẻ QR/key cho người khác.

Giai đoạn 2: on-call workflow

• Dùng cho tình huống khẩn cấp: xem log, restart service, kiểm tra dashboard.
• Kết hợp tmux để giữ session.
• Tạo checklist “lệnh được phép chạy từ phone”.
• Không dùng để deploy production nếu chưa có approval.

Giai đoạn 3: AI coding mobile

• Chạy Claude Code/Codex trên máy dev.
• Kết hợp 9Router nếu cần provider routing/fallback.
• Dùng 9Remote để prompt, review diff, run tests.
• Không để agent tự chạy destructive commands từ phone nếu chưa kiểm soát.

Giai đoạn 4: policy bảo mật

• Quy định ai được pair device.
• Revoke device khi mất điện thoại.
• Không mở remote desktop khi không cần.
• Không lưu key trong chat/public notes.
• Không chạy trên máy có dữ liệu nhạy cảm nếu chưa có policy.
• Kiểm soát quyền file của user chạy 9Remote.

Lưu ý bảo mật

9Remote là công cụ remote access. Khi bật, nó có thể cho device đã pair truy cập terminal, desktop và file system. Vì vậy cần coi nó như công cụ nhạy cảm.

Checklist:

• Chỉ pair thiết bị bạn kiểm soát.
• Không chụp/gửi QR code cho người khác.
• One-time key hết hạn sau 30 phút, nhưng vẫn nên regenerate nếu nghi ngờ lộ.
• Kiểm tra pending/rejected devices trong TUI menu.
• Không chạy 9Remote bằng user có quyền quá rộng nếu không cần.
• Tắt remote desktop khi không dùng.
• Không để điện thoại unlock khi đã pair.
• Nếu mất điện thoại, revoke device.
• Không dùng trên máy chứa secret production nếu chưa có chính sách.
• Nếu dùng Cloudflare tunnel, hiểu rằng traffic đi qua tunnel public URL, dù vẫn cần key/pairing.
• Với công ty, cần kiểm tra policy về remote access, tunnel và data exfiltration.

README nói 9Remote không mở port trên máy, dùng Cloudflare tunnel outbound-only, không thu terminal output/files/screen data, và keys không lưu trên server sau session.²⁴ Đây là mô hình thuận tiện, nhưng người vận hành vẫn phải quản trị thiết bị pair và quyền máy host.

Hạn chế cần biết

Từ README và docs:

• Source code chưa mở tại thời điểm viết, dù có kế hoạch MIT khi đạt milestone.⁵
• Remote desktop trên macOS cần Screen Recording và Accessibility permission.²⁵
• Remote desktop không phù hợp video playback, audio streaming, high-FPS gaming hoặc multi-monitor phức tạp.¹⁶
• File Explorer chưa phù hợp binary files, file rất lớn trên 10MB, multi-file selection, upload/download theo docs hiện tại.¹⁸
• Cloudflare tunnel cần internet; nếu tunnel lỗi cần kiểm tra kết nối hoặc cloudflared.²⁶
• Mobile editing phù hợp quick fix hơn là refactor lớn.
• Website và README có thông tin license/open-source chưa thống nhất; nên kiểm tra repo trước khi viết “open source”.⁵⁶

Khi nào nên dùng 9Remote?

Nên dùng nếu:

• bạn muốn truy cập máy dev từ điện thoại;
• cần chạy Claude Code/Codex/Cursor từ xa;
• cần fix bug khi không có laptop;
• cần kiểm tra local dev server trên phone;
• cần terminal + file explorer + desktop trong một tool;
• muốn tránh SSH/VPN/port forwarding;
• cần on-call quick access.

Không nên dùng nếu:

• môi trường công ty cấm tunnel hoặc remote access tool tự quản;
• bạn cần security audit/source code đầy đủ ngay bây giờ;
• bạn cần remote desktop chất lượng cao cho video/game;
• bạn cần quản lý server production theo chuẩn enterprise;
• bạn không kiểm soát được thiết bị client đã pair;
• bạn cần offline hoàn toàn nhưng không ở cùng LAN.

FAQ

9Remote là gì?

9Remote là công cụ remote access giúp điều khiển terminal, remote desktop và file explorer của máy Mac/Linux/Windows từ phone hoặc browser, có QR pairing và Cloudflare tunnel tự động.²²⁷

9Remote có phải open-source không?

Theo README GitHub, source code chưa open-source và license hiện là Proprietary; npm package miễn phí trong giai đoạn phát triển, và repo nói sẽ mở source dưới MIT khi đạt milestone cộng đồng.⁵ Website có dòng “Open source · MIT License”, nhưng bài này ưu tiên trạng thái ghi trong repo vì đó là nguồn mô tả license cụ thể.⁶

Có cần mở port hoặc cấu hình router không?

Không. README nói 9Remote dùng Cloudflare Quick Tunnel, outbound-only, hoạt động sau NAT, firewall, mobile hotspot và VPN.²⁸

Có dùng Claude Code hoặc Codex trên điện thoại được không?

Có. 9Remote không chạy AI trên điện thoại; nó cho bạn điều khiển terminal của máy host, nơi Claude Code, Codex CLI, Cursor hoặc OpenClaw đang chạy.³

Port mặc định là gì?

Docs nói 9Remote server start local trên port 2208; lệnh 9remote ui mở browser dashboard tại localhost:2208.¹⁰²⁹

9Remote có an toàn không?

README nói 9Remote dùng Pair Device approval, one-time QR key 30 phút, Cloudflare tunnel outbound-only và không thu terminal output/files/screen data.²⁴ Tuy nhiên, vì đây là remote access tool, bạn vẫn phải quản lý thiết bị pair, quyền user host, tunnel URL và policy bảo mật nội bộ.

Kết luận

decolua/9remote là một công cụ remote workspace hướng tới developer muốn “code từ bất cứ đâu”. Điểm mạnh của nó là kết hợp terminal, remote desktop, file explorer, code editor, Git integration, local sites proxy và AI coding workflow trong một trải nghiệm tối ưu cho phone/browser.

Với người mới, cách bắt đầu là npm install -g 9remote, chạy 9remote, quét QR và mở terminal. Với người dùng AI coding, 9Remote hữu ích vì bạn có thể chạy Claude Code/Codex/Cursor trên máy dev và điều khiển bằng điện thoại. Với team, cần thận trọng hơn: 9Remote là remote access tool, nên phải có policy pair device, revoke device, quyền user, tunnel usage và xử lý dữ liệu nhạy cảm rõ ràng.

Nguồn tham khảo

Footnotes

1. GitHub Open Graph preview image for decolua/9remote. https://opengraph.githubassets.com/9remote-guide/decolua/9remote ↩

2. 9Remote README, project overview. https://raw.githubusercontent.com/decolua/9remote/main/README.md ↩ ↩²

3. 9Remote README, AI coding tools FAQ. https://raw.githubusercontent.com/decolua/9remote/main/README.md ↩ ↩² ↩³

4. 9Remote README, “Why 9Remote?” https://raw.githubusercontent.com/decolua/9remote/main/README.md ↩

5. 9Remote README, License and development status. https://raw.githubusercontent.com/decolua/9remote/main/README.md ↩ ↩² ↩³ ↩⁴

6. 9Remote official website, footer/CTA text mentioning “Open source · MIT License.” https://9remote.cc/ ↩ ↩² ↩³

7. GitHub. decolua/9remote. https://github.com/decolua/9remote ↩

8. 9Remote README, Key Features. https://raw.githubusercontent.com/decolua/9remote/main/README.md ↩

9. 9Remote Docs, Getting Started requirements and setup. https://docs.9remote.cc/getting-started ↩

10. 9Remote Docs, Start Server. https://docs.9remote.cc/getting-started ↩ ↩²

11. 9Remote Docs, Connect section. https://docs.9remote.cc/getting-started ↩

12. 9Remote README, First Run & QR Login. https://raw.githubusercontent.com/decolua/9remote/main/README.md ↩

13. 9Remote Docs, Terminal. https://docs.9remote.cc/features/terminal ↩

14. 9Remote Docs, Terminal tips about tmux/screen. https://docs.9remote.cc/features/terminal ↩

15. 9Remote Docs, Remote Desktop. https://docs.9remote.cc/features/remote-desktop ↩

16. 9Remote Docs, Remote Desktop limitations. https://docs.9remote.cc/features/remote-desktop ↩ ↩²

17. 9Remote Docs, File Explorer. https://docs.9remote.cc/features/file-explorer ↩

18. 9Remote Docs, File Explorer limitations. https://docs.9remote.cc/features/file-explorer ↩ ↩²

19. 9Remote README, Local Sites Proxy. https://raw.githubusercontent.com/decolua/9remote/main/README.md ↩

20. 9Remote README, comparison table. https://raw.githubusercontent.com/decolua/9remote/main/README.md ↩

21. 9Remote README, Tech Stack. https://raw.githubusercontent.com/decolua/9remote/main/README.md ↩

22. 9Remote README, LocalFirstAdapter / LAN note. https://raw.githubusercontent.com/decolua/9remote/main/README.md ↩

23. 9Remote README, supported platforms. https://raw.githubusercontent.com/decolua/9remote/main/README.md ↩

24. 9Remote README, security FAQ. https://raw.githubusercontent.com/decolua/9remote/main/README.md ↩ ↩²

25. 9Remote README, Remote Desktop Setup on macOS. https://raw.githubusercontent.com/decolua/9remote/main/README.md ↩

26. 9Remote README, Troubleshooting. https://raw.githubusercontent.com/decolua/9remote/main/README.md ↩

27. 9Remote Docs, Introduction. https://docs.9remote.cc/ ↩

28. 9Remote README, Cloudflare Quick Tunnel / no port forwarding FAQ. https://raw.githubusercontent.com/decolua/9remote/main/README.md ↩

29. 9Remote README, CLI commands. https://raw.githubusercontent.com/decolua/9remote/main/README.md ↩