การติดตั้ง CLI

การติดตั้ง TH-Tunnel Command-line Interface

การติดตั้ง CLI

TH-Tunnel CLI ช่วยให้คุณสร้าง Tunnel จากเครื่องของคุณ

ความต้องการ

  • Node.js 18 หรือสูงกว่า
  • npm หรือ yarn
  • การเชื่อมต่ออินเทอร์เน็ต

ตัวเลือกการติดตั้ง

ตัวเลือก 1: จาก Source

Clone และ Build จาก Repository:

# Clone Repository
git clone https://github.com/YOUR_ORG/th-tunnel.git
cd th-tunnel/agent-cli-v2

# ติดตั้ง Dependencies
npm install

# รันโดยตรง
node src/index.js --help

# หรือ Link แบบ Global
npm link
tunnel --help

ตัวเลือก 2: Binary ที่สร้างไว้แล้ว

TODO: ต้องยืนยันจาก owner - ลิงก์ดาวน์โหลด Binary

ถ้ามี Binary ให้ดาวน์โหลดสำหรับแพลตฟอร์มของคุณ:

  • Windows: tunnel-win.exe
  • macOS: tunnel-macos
  • Linux: tunnel-linux

การตั้งค่าเริ่มต้น

หลังการติดตั้ง ตั้งค่า CLI:

# ตั้ง URL เซิร์ฟเวอร์
tunnel config set-server https://api.your-domain.com

# เพิ่ม Token การยืนยันตัวตน
tunnel config add-authtoken YOUR_TOKEN_HERE

# ตรวจสอบการตั้งค่า
tunnel config show
ข้อมูล

รับ Token ของคุณจากแดชบอร์ดที่ Tokens > Create Token

ไฟล์การตั้งค่า

การตั้งค่าถูกบันทึกที่ ~/.th-tunnel/config.json:

{
  "apiUrl": "https://api.your-domain.com",
  "serverUrl": "https://api.your-domain.com",
  "token": "your-token-here"
}

Environment Variables

แทนที่ Config ด้วย Environment Variables:

Variableคำอธิบาย
TUNNEL_TOKENToken การยืนยันตัวตน
TUNNEL_SERVERURL เซิร์ฟเวอร์ API
DEBUGเปิดใช้ Debug Logging

การตรวจสอบการติดตั้ง

ทดสอบการติดตั้ง:

# ตรวจสอบเวอร์ชัน
tunnel --version

# ดูรายการ Node ที่มี
tunnel config nodes

# สร้าง Tunnel ทดสอบ
tunnel http 3000

การแก้ไขปัญหา

"command not found: tunnel"

ถ้าติดตั้งจาก Source โดยไม่ได้ใช้ npm link:

node src/index.js http 3000

หรือ Link แบบ Global:

npm link

"Server URL not configured"

รันคำสั่ง Config:

tunnel config set-server https://api.your-domain.com

"Authentication token not configured"

เพิ่ม Token ของคุณ:

tunnel config add-authtoken YOUR_TOKEN