devt-tunnel: lưu tunnel một lần, bật bằng một cú nhấp

App GUI desktop mã nguồn mở để dễ dàng tạo tunnel, lưu và bật/tắt tunnel với SSH, cloudflared, ngrok.

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 cho cloudflared 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.

So sánh: trước đây nhiều tab terminal rời rạc, với devt-tunnel mọi tunnel nằm trong một danh sách trong ứng dụng
Từ nhiều tab terminal rời rạc đến một danh sách tunnel đã lưu trong ứng dụng.

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:

  1. 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.
  2. Lưu lại thành một mục có tên trong danh sách.
  3. 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.

Quy trình: tạo tunnel trong giao diện, lưu vào danh sách, bật hoặc tắt bằng một cú nhấp
Tạo một lần, lưu lại, dùng mãi.
Màn hình chính của devt-tunnel với sidebar, danh sách tunnel đã lưu và bảng chi tiết
Màn hình chính: sidebar (All, Running, Favorites, Groups), danh sách tunnel đã lưu kèm các forward, và bảng chi tiết.

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 cloudflared thì 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 -N hay thiếu keepalive.
  • Secret cần dùng đã có trong Vault chưa.
Trình soạn thảo tunnel với form, phần xem trước câu lệnh và danh sách kiểm tra
Trình soạn thảo: form bên trái, câu lệnh và các kiểm tra cập nhật trực tiếp.

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.

Menu khay hệ thống liệt kê tunnel đang chạy và tunnel yêu thích
Menu khay hệ thống: tunnel đang chạy và tunnel yêu thích.

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ửa sổ quick launch đang tìm kiếm tunnel theo tên
Quick launch: tìm tunnel đã lưu và bật tắt chỉ bằng bàn phím.

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.

Màn hình Groups với nút Start all và Stop all
Group: bật cả một môi trường làm việc bằng một nút.

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ơ đồ trạng thái tunnel: Stopped, Starting, Running, Reconnecting, Failed, Needs token
Các trạng thái bạn thấy trên danh sách tunnel.

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.

Lời kết

devt-tunnel ra đời từ một nhu cầu rất đời thường: những tunnel dùng hằng ngày thì nên được lưu lại và bật bằng một cú nhấp, thay vì gõ lại từ đầu mỗi sáng. Nếu bạn cũng mệt với một rừng tab terminal, hãy thử và góp ý.

Giấy phép Apache 2.0.

Getting Info...

About the Author

ntdm | @ntdm11

Đăng nhận xét

Cookie Consent
We serve cookies on this site to analyze traffic, remember your preferences, and optimize your experience.