Tham chiếu CLI
Một file binary duy nhất, addtothese, là tất cả những gì bạn cần: đăng nhập, mở tunnel và chuyển tiếp port TCP. Thông tin đăng nhập được lưu trong ~/.addtothese/config.yaml (%USERPROFILE%\.addtothese\config.yaml trên Windows).
addtothese login
addtothese login --token att_...
Lưu một token API. Nếu không có --token, lệnh sẽ hỏi token qua standard input. addtothese logout xóa token đã lưu.
addtothese http
addtothese http <port|host:port|url> [--subdomain name]
Public một dịch vụ HTTP local. Không có --subdomain, bạn nhận một endpoint ngẫu nhiên. Có tùy chọn này, tunnel dùng tên bạn đã đặt trước trong bảng điều khiển. CLI tự kết nối lại khi mạng bị ngắt và làm mới thông tin xác thực trước khi hết hạn.
| Flag | Mặc định | Ý nghĩa |
|---|---|---|
| --subdomain | ngẫu nhiên | Tên đặt trước cần dùng |
| --timeout | 10s | Thời gian chờ khi chuyển tiếp mỗi request tới dịch vụ của bạn |
| --access-log | true | In ra từng request được proxy |
| --log-level | warn | debug, info, warn hoặc error |
Bảo vệ URL bằng mã email
addtothese http 4321 --allowed-email ana@gmail.com --allowed-email '*@company.com'
Chỉ những người bạn liệt kê mới có thể mở URL. Khách truy cập nhập email; nếu email có trong danh sách, họ nhận được mã 6 chữ số có hiệu lực trong 10 phút và duy trì đăng nhập trong 24 giờ. *@company.com cho phép cả một tên miền. Lặp lại flag cho mỗi địa chỉ hoặc tên miền.
Dịch vụ của bạn nhận địa chỉ đã xác minh trong header X-AddToThese-Email. Mỗi lần chạy sẽ thay thế danh sách, vì vậy chạy mà không có --allowed-email sẽ khiến URL công khai trở lại. Bạn cũng có thể chỉnh sửa danh sách trên trang endpoint trong bảng điều khiển.
addtothese tcp
addtothese tcp 5432 --subdomain mydb
Public một port TCP thô như Postgres, SSH hoặc RDP. Người cần truy cập sẽ chạy forwarder ở phía họ, công cụ này mở một port local được kết nối tới dịch vụ của bạn:
addtothese forward tcp 5432 mydb --connect.url https://mydb.addtothese.com
Sau đó họ có thể kết nối tới localhost:5432 như thể cơ sở dữ liệu nằm trên máy của họ.
Biến môi trường
| Biến | Ý nghĩa |
|---|---|
| ADDTOTHESE_TOKEN | Token API, ghi đè token đã lưu |
| ADDTOTHESE_CONFIG | Đường dẫn tới file cấu hình thay thế |