tunelo 1.6.2 → 1.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/README.md +25 -25
  2. package/cli.js +35433 -633
  3. package/cli.js.map +4 -4
  4. package/package.json +3 -3
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Tunelo CLI
2
2
 
3
- Expose dịch vụ local ra internet qua HTTPS wildcard subdomain — `https://<tên>.tunnel.inetdev.io.vn` chuyển tiếp về `localhost` của bạn.
3
+ Expose dịch vụ local ra internet qua HTTPS wildcard subdomain — `https://<tên>.tunnel.hoandat.com` chuyển tiếp về `localhost` của bạn. Đăng nhập bằng tài khoản hoandat (Google hoặc GitHub qua `auth.hoandat.com`); xem tunnel của tài khoản tại [tunnel.hoandat.com](https://tunnel.hoandat.com).
4
4
 
5
5
  ## Cài đặt
6
6
 
@@ -42,34 +42,32 @@ npm config delete "//gitlabs.inet.vn/api/v4/projects/343/packages/npm/:_authToke
42
42
  npm install -g tunelo
43
43
  ```
44
44
 
45
- ## Sử dụng nhanh
45
+ ### Từ 1.6.x lên 1.7.0
46
+
47
+ - Server mặc định đổi sang `tunnel.hoandat.com`. Cấu hình còn lưu `tunnel.inetdev.io.vn` được tự chuyển sang server mới ở lần chạy đầu.
48
+ - Đăng nhập bằng tài khoản thay cho trang Approve. Token ẩn danh cũ vẫn chạy, nhưng `tunelo whoami` nhắc đăng nhập; chạy `tunelo login` một lần để tunnel của máy gắn với tài khoản.
46
49
 
47
- ### Bước 1 — xác thực thiết bị
50
+ ## Sử dụng nhanh
48
51
 
49
- Chạy `tunelo login` → trình duyệt mở trang hiển thị **thiết bị của bạn** (tên máy) + nút **Approve**. Bấm Approve → trang báo thành công và CLI tự nhận token (lưu `~/.tunelo/config.json`):
52
+ ### Bước 1 — đăng nhập
50
53
 
51
54
  ```bash
52
55
  tunelo login
53
- # Opening browser to authorize this device...
54
- # Waiting for approval in the browser... ← bấm "Approve" trên trang
55
- # ✓ Device authorized & signed in.
56
+ # Sign in to Tunelo in your browser:
57
+ # https://auth.hoandat.com/device?user_code=...
58
+ # Confirm the code: ABCD-EFGH
59
+ # Waiting for approval...
56
60
  ```
57
61
 
58
- Đăng nhập lại trên cùng máy là **idempotent** — nếu token còn hạn, CLI báo "Already authorized" (dùng `--force` để làm lại). Mỗi máy giữ 1 token; login lại thu hồi token cũ của máy đó.
59
-
60
- Máy không có trình duyệt (CI/server)? Dùng access token trực tiếp:
61
-
62
- ```bash
63
- tunelo login --key tunelo_xxxxxxxx
64
- ```
62
+ Trình duyệt mở trang của `auth.hoandat.com`: đăng nhập bằng Google hoặc GitHub (đã có phiên thì bỏ qua), kiểm mã trùng với mã trên terminal, rồi bấm cho phép máy này. CLI lưu refresh token vào `~/.tunelo/config.json` (quyền 600) và tự làm mới token khi mở tunnel. Mỗi máy là một thiết bị riêng, xem và đăng xuất từng máy ở [auth.hoandat.com/account](https://auth.hoandat.com/account).
65
63
 
66
- > Không có tài khoản/đăng ký — xác thực thiết bị qua trình duyệt là đủ.
64
+ Đã đăng nhập rồi thì `tunelo login` báo và dừng (`--force` để làm lại). Máy không có trình duyệt (CI): `tunelo login --legacy-key <token>` hoặc biến `TUNELO_KEY` (token ẩn danh).
67
65
 
68
66
  ### Bước 2 — mở tunnel
69
67
 
70
68
  ```bash
71
69
  tunelo http 3000
72
- # => https://<random>.tunnel.inetdev.io.vn → http://localhost:3000
70
+ # => https://<random>.tunnel.hoandat.com → http://localhost:3000
73
71
  ```
74
72
 
75
73
  Nhấn `Ctrl+C` để dừng.
@@ -77,9 +75,9 @@ Nhấn `Ctrl+C` để dừng.
77
75
  Tùy chọn hay dùng:
78
76
 
79
77
  ```bash
80
- tunelo http 3000 -s myapp # subdomain cụ thể → https://myapp.tunnel.inetdev.io.vn
78
+ tunelo http 3000 -s myapp # subdomain cụ thể → https://myapp.tunnel.hoandat.com
79
+ tunelo http 3000:web 5000:api # nhiều tunnel, mỗi cổng một subdomain
81
80
  tunelo http 8080 -a user:pass # bảo vệ tunnel bằng Basic Auth
82
- tunelo http 3000 5000 # mở nhiều tunnel cùng lúc
83
81
  tunelo tcp 5432 # tunnel TCP (vd PostgreSQL)
84
82
  ```
85
83
 
@@ -87,13 +85,15 @@ tunelo tcp 5432 # tunnel TCP (vd PostgreSQL)
87
85
 
88
86
  | Lệnh | Việc |
89
87
  |------|------|
90
- | `tunelo keys list` | Liệt kê API key |
91
- | `tunelo keys create` | Tạo API key mới |
92
- | `tunelo keys revoke <keyId>` | Thu hồi API key |
93
- | `tunelo config --key <key>` | Đặt API key mặc định (thủ công) |
94
- | `tunelo config --server <url>` | Đổi server mặc định |
95
- | `tunelo config --show` | Xem cấu hình hiện tại |
96
- | `tunelo logout` | Xoá API key khỏi config |
88
+ | `tunelo whoami` | Máy này đang dùng tài khoản nào (hoặc token ẩn danh) |
89
+ | `tunelo logout` | Thu hồi đăng nhập của máy này và xoá token |
90
+ | `tunelo status` | Liệt kê tunnel đang chạy trên máy |
91
+ | `tunelo kill <pid\|subdomain\|all>` | Dừng tunnel đang chạy |
92
+ | `tunelo link <code>` | Cho Localman thấy tunnel của máy chưa đăng nhập (không cần tài khoản) |
93
+ | `tunelo links` / `tunelo links revoke <id>` | Xem hoặc thu hồi các liên kết của máy |
94
+ | `tunelo mcp` | Chạy MCP server (stdio) để agent AI mở tunnel |
95
+ | `tunelo update [--check]` | Cập nhật lên bản mới nhất |
96
+ | `tunelo config --server <url>` / `--key <token>` / `--show` | Đổi server mặc định, đặt token ẩn danh, xem cấu hình |
97
97
 
98
98
  Thứ tự ưu tiên cấu hình: cờ CLI (`--key`, `--server`) > biến môi trường (`TUNELO_KEY`, `TUNELO_SERVER`) > `~/.tunelo/config.json`.
99
99