> ## Content Index
> Fetch the complete content index at: https://blog.fayedark.com/llms.txt
> Use this file to discover other available public pages before exploring further.

# devt-tunnel: lưu tunnel một lần, bật bằng một cú nhấp
- URL: https://blog.fayedark.com/devt-tunnel-luu-tunnel-mot-lan-bat-bang/
- Published: 2026-11-17T10:06:00.000Z
- Updated: 2026-11-17T16:42:52.000Z
- Description: 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.
- Author: Trieu
- Tags: Thủ thuật, Windows, Phần mềm, #blogger-author-quoctrieudev

# 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.

17/11/2026· Mã nguồn: [github.com/trieu04/devt-tunnel](https://github.com/trieu04/devt-tunnel?ref=blog.fayedark.com) 

## 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](https://blog.fayedark.com/content/images/2026/11/34aee909f23f5ede.png)](https://blog.fayedark.com/content/images/2026/11/34aee909f23f5ede.png) 

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](https://blog.fayedark.com/content/images/2026/11/39f03c31861114f8.png)](https://blog.fayedark.com/content/images/2026/11/39f03c31861114f8.png) 

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](https://blog.fayedark.com/content/images/2026/11/03111fe48f8d95c1.png)](https://blog.fayedark.com/content/images/2026/11/03111fe48f8d95c1.png) 

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](https://blog.fayedark.com/content/images/2026/11/6b459c551766786e.png)](https://blog.fayedark.com/content/images/2026/11/6b459c551766786e.png) 

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](https://blog.fayedark.com/content/images/2026/11/756e6e3f1d5d53c7.png)](https://blog.fayedark.com/content/images/2026/11/756e6e3f1d5d53c7.png) 

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](https://blog.fayedark.com/content/images/2026/11/32e32bc3dba07168.png)](https://blog.fayedark.com/content/images/2026/11/32e32bc3dba07168.png) 

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](https://blog.fayedark.com/content/images/2026/11/184113c1fddbe898.png)](https://blog.fayedark.com/content/images/2026/11/184113c1fddbe898.png) 

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](https://blog.fayedark.com/content/images/2026/11/896deacc882f0bd5.png)](https://blog.fayedark.com/content/images/2026/11/896deacc882f0bd5.png) 

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](https://github.com/trieu04/devt-tunnel/blob/main/CONTRIBUTING.md?ref=blog.fayedark.com).

## 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 ý.

- Mã nguồn và tài liệu: [github.com/trieu04/devt-tunnel](https://github.com/trieu04/devt-tunnel?ref=blog.fayedark.com)
- Lộ trình: [docs/roadmap.md](https://github.com/trieu04/devt-tunnel/blob/main/docs/roadmap.md?ref=blog.fayedark.com)

Giấy phép [Apache 2.0](https://github.com/trieu04/devt-tunnel/blob/main/LICENSE?ref=blog.fayedark.com).