devt-tunnel: lưu tunnel một lần, bật bằng một cú nhấp
Ứng dụng desktop để quản lý tunnel SSH, cloudflared, ngrok và lệnh tuỳ chỉnh bằng giao diện: tạo, lưu lại, rồi bật hoặc tắt bất cứ lúc nào mà không cần mở terminal hay nhớ flag.
· Mã nguồn: github.com/trieu04/devt-tunnel
Vấn đề: tunnel chỉ sống trong terminal
Nếu bạn hay phải vào database staging, gửi link demo hay nhận webhook trên máy local, chắc hẳn bạn quen với cảnh này:
- Mỗi sáng lại lục lịch sử shell để tìm đúng câu
ssh -N -L 5433:127.0.0.1:5432 server1. - Một tab cho
ngrok http 3000, một tab chocloudflared tunnel run ..., lỡ đóng nhầm tab là mất tunnel. - Laptop ngủ dậy, SSH đứt mà không ai báo. Mở lại thì cổng đã bị một tiến trình "mồ côi" chiếm.
- Không có chỗ nào cho biết trên máy đang có những tunnel nào, cái nào chạy, cái nào chết.
Tunnel là thứ bạn dùng đi dùng lại hằng ngày, vậy mà mỗi lần dùng lại phải gõ lại từ đầu.
devt-tunnel là gì?
devt-tunnel là một ứng dụng desktop mã nguồn mở (Apache 2.0) cho macOS, Windows và Linux. Ý tưởng rất đơn giản:
- Tạo tunnel trong giao diện, từ host trong
~/.ssh/config, từ một câu lệnh có sẵn, hoặc nhập tay. - Lưu lại thành một mục có tên trong danh sách.
- Bật, tắt bằng một cú nhấp, từ cửa sổ chính, khay hệ thống hoặc phím tắt toàn cục.
devt-tunnel không thay thế ssh, ngrok hay cloudflared. Nó điều khiển chính các công cụ đã cài sẵn trên máy bạn, chỉ là bạn không phải gõ lệnh nữa.
Tạo và lưu tunnel trong giao diện
Bấm New tunnel (⌘N) và chọn loại tunnel:
| Loại | Bạn điền trong form |
|---|---|
| SSH | Chọn host từ SSH config (hoặc nhập user, host, port, identity), thêm các forward -L, -R, -D, bật tắt các flag |
| Cloudflared | Named tunnel (tên, hostname, token) hoặc quick tunnel, cùng URL dịch vụ local |
| ngrok | Giao thức, địa chỉ local, domain, authtoken |
| Command | Một câu lệnh bất kỳ, thư mục làm việc, mẫu log báo "đã sẵn sàng" |
Đã có sẵn câu lệnh? Dán vào
Bấm ⌘⇧V để dán một câu lệnh ssh, ngrok hay cloudflared bạn đang dùng. devt-tunnel tự tách thành các trường trong form để bạn đặt tên và lưu lại. Đây là cách nhanh nhất để chuyển những câu lệnh trong lịch sử shell vào ứng dụng.
Thấy trước câu lệnh sẽ chạy
Khi bạn chỉnh form, trình soạn thảo luôn hiện chính xác câu lệnh sẽ được chạy và kiểm tra trước khi lưu:
- Binary được dùng là cái nào, có bị thiếu không (thiếu
cloudflaredthì có nút tải về ngay tại chỗ). - Host alias có trong SSH config không.
- Cổng local có bị tunnel hoặc tiến trình khác chiếm không.
- Flag SSH không an toàn, thiếu
-Nhay thiếu keepalive. - Secret cần dùng đã có trong Vault chưa.
Lưu lại
Bấm Save để lưu, hoặc Save & start để lưu và bật luôn. Trong form bạn cũng có thể:
- Đánh dấu Favorite để tunnel hiện ở đầu danh sách và trên khay hệ thống.
- Bật Start on launch để tunnel tự chạy khi mở ứng dụng.
- Bật Reconnect để tự kết nối lại khi bị đứt.
Muốn sửa thì chọn tunnel và bấm ⌘E; muốn tạo một tunnel tương tự thì dùng Duplicate.
Bật, tắt bằng một cú nhấp
Khi tunnel đã được lưu, bạn có nhiều cách để bật hoặc tắt nó, tuỳ đang làm gì:
Từ cửa sổ chính
Bấm nút bật/tắt ngay trên dòng của tunnel. Bảng chi tiết bên cạnh hiện câu lệnh, PID, thời gian chạy và log trực tiếp. Khi tunnel chạy, bạn copy địa chỉ bằng một cú nhấp.
Từ khay hệ thống
Tunnel đang chạy và tunnel yêu thích hiện trên menu bar (macOS) hoặc khay hệ thống (Windows, Linux). Bật tắt mà không cần mở cửa sổ. Đóng cửa sổ thì tunnel vẫn tiếp tục chạy.
Từ phím tắt toàn cục
Đang ở bất kỳ ứng dụng nào, bấm ⌥Space trên macOS (hoặc Ctrl+Alt+Space trên Windows, Linux), gõ tên, host hoặc cổng, rồi Enter để bật hoặc tắt. ⌘↵ vừa bật vừa copy địa chỉ.
Cả nhóm cùng lúc
Gom các tunnel hay dùng chung vào một Group, ví dụ "Backend stack" gồm database, Redis và hàng đợi. Bấm Start all là cả nhóm cùng chạy, Stop all là cả nhóm cùng dừng. Một tunnel có thể nằm trong nhiều group.
Luôn biết tunnel nào đang chạy
Mỗi tunnel có trạng thái rõ ràng ngay trên danh sách. devt-tunnel giám sát tiến trình cho bạn:
- Biết khi nào tunnel thực sự sẵn sàng, không chỉ là "đã chạy lệnh".
- Tự kết nối lại khi bị đứt, có backoff, và khôi phục sau khi máy ngủ dậy.
- Khi tắt thì dừng cả cây tiến trình, không để lại tiến trình mồ côi chiếm cổng.
- Passphrase, xác nhận host key hay mã OTP của SSH hiện thành hộp thoại trong ứng dụng, thay vì treo im lặng ở nền.
Sắp xếp khi có nhiều tunnel
- Favorites
- Những tunnel dùng nhiều nhất, hiện ở view riêng và trên khay hệ thống.
- Group
- Nhóm tunnel bật tắt cùng nhau, như đã nói ở trên.
- Profile
- Gom tunnel theo ngữ cảnh như Work, Home, Client ABC, mỗi profile có thể dùng một file SSH config riêng.
- Tìm kiếm
- Gõ tên, host hoặc cổng để lọc danh sách ngay lập tức.
Vault: secret không nằm trong file cấu hình
Authtoken ngrok, token cloudflared hay passphrase SSH được lưu trong màn hình Vault, thực chất là keychain của hệ điều hành (macOS Keychain, Windows Credential Manager, Linux Secret Service). Tunnel chỉ tham chiếu secret theo tên. Muốn xem lại giá trị phải xác thực bằng hệ điều hành.
Nếu tunnel cần một secret mà chưa có, nó hiện trạng thái Needs token. Bấm vào là mở Vault; thêm secret xong tunnel tự khởi động lại.
Tunnel được lưu ở đâu?
Các tunnel đã lưu nằm trong file tunnels.toml. File này chỉ chứa định nghĩa tunnel và tên secret, không chứa giá trị secret. Vì vậy bạn có thể sao lưu hoặc chia sẻ nó cho đồng đội (sau khi xem lại hostname, đường dẫn và lệnh tuỳ chỉnh); mỗi người tự thêm secret của mình vào Vault.
Ngoài giao diện
Giao diện là cách dùng chính, nhưng devt-tunnel còn có hai cách phụ, dùng chung một danh sách với ứng dụng:
- Dòng lệnh
devt-tunnel: cho ai thích terminal hoặc cần dùng trong script. Tunnel tạo bằng dòng lệnh cũng hiện ngay trong ứng dụng.devt-tunnel start db devt-tunnel stop db devt-tunnel ls - MCP: cho AI agent yêu cầu mở tunnel. Yêu cầu cần duyệt (ví dụ tunnel public) sẽ hiện trong ứng dụng để bạn đồng ý hoặc từ chối.
Câu hỏi thường gặp
Có cần cài ssh, ngrok, cloudflared riêng không?
Có, cài những cái bạn dùng. Ứng dụng tự tìm chúng trên máy, và bạn có thể chỉ định đường dẫn trong Settings. Riêng cloudflared có thể tải về ngay trong ứng dụng (bản đã ghim phiên bản, có kiểm tra checksum).
Đóng cửa sổ thì tunnel có tắt không?
Không, nếu hệ thống có khay: đóng cửa sổ chỉ ẩn ứng dụng, tunnel vẫn chạy. ⌘Q mới dừng tất cả và thoát. Nếu ứng dụng bị crash, tunnel vẫn chạy và mở lại ứng dụng là thấy lại ngay.
Sao không dùng luôn ssh -L hay autossh?
Với một forward dùng một lần, ssh là đủ. devt-tunnel dành cho những tunnel bạn dùng đi dùng lại: lưu một lần, bật bằng một cú nhấp, có trạng thái, log, tự kết nối lại và dừng sạch sẽ.
Nó có thay thế ssh, scp, rsync không?
Không. devt-tunnel chỉ lo tunnel. Phiên shell tương tác, scp và rsync bạn vẫn dùng như cũ.
Trạng thái hiện tại và cách thử
devt-tunnel vẫn đang ở giai đoạn đầu và chưa có bản phát hành công khai đã ký. Ứng dụng desktop đã được nghiệm thu thủ công trên macOS; Windows và Linux đã build được trên CI nhưng chưa chạy thử trên desktop thật.
Để build ứng dụng từ mã nguồn, bạn cần Go 1.27.3 trở lên, Node 22, pnpm, Wails CLI (và GTK, WebKitGTK trên Linux):
git clone https://github.com/trieu04/devt-tunnel.git
cd devt-tunnel
wails3 task build
Hướng dẫn chi tiết ở CONTRIBUTING.md.