ติดตั้งแบบซื้อขาดทีละขั้น

ตั้งแต่เตรียมเครื่อง ต่อสาย ติดตั้งโปรแกรม ซื้อและใส่ License จนแขกเห็นหน้าล็อกอิน รวมถึงเครื่องที่ไม่มีอินเทอร์เน็ต

1. เตรียมเครื่อง

  • เครื่อง PC, Mini PC หรือ Server ที่ติดตั้ง Debian 12 หรือ Ubuntu 24.04 (amd64 หรือ arm64) ใช้ kernel ของระบบเอง และเข้าใช้สิทธิ์ root (sudo) ได้
  • พอร์ตสาย LAN 2 พอร์ต แบบ Gateway ใช้พอร์ตเดียวได้ถ้าแขกอยู่บน VLAN ผ่าน Managed switch ส่วนแบบ Transparent ต้องมี 2 พอร์ตเสมอ
  • ดิสก์ว่างพอเก็บ log อย่างน้อย 90 วัน และควรมีที่สำรอง log ไว้นอกเครื่อง
  • ใช้ Virtual Machine ได้ แต่ห้าม clone เครื่องที่ติดตั้งแล้ว เพราะ Hardware ID จะเปลี่ยนและ License ใช้ไม่ได้ ติดตั้งใน container ไม่ได้
  • แบบ Gateway: ปิดโปรแกรม DHCP หรือ DNS อื่นบนเครื่อง (เช่น dnsmasq) เพราะเครื่องจะแจก IP ให้แขกเอง

2. ต่อสาย

พอร์ตแรก (WAN)พอร์ตที่สอง (LAN)ใครแจก IP ให้แขก
Gatewayสายอินเทอร์เน็ต หรือวง LAN ของสำนักงานAccess Point หรือสวิตช์ของ Wi-Fi แขกเครื่องนี้ (ค่าเริ่มต้น 10.77.0.0/22 เครื่องอยู่ที่ 10.77.0.1)
Transparentเราเตอร์หรือสวิตช์เดิมAccess Point หรือสวิตช์เราเตอร์เดิม

แบบ Gateway ต่อสายพอร์ตแรกให้ได้อินเทอร์เน็ตก่อนติดตั้ง คำสั่งติดตั้งจะเลือกพอร์ตที่มีเส้นทางออกอินเทอร์เน็ตเป็น WAN และพอร์ตสาย LAN อีกพอร์ตเป็น LAN เอง ความต่างของสองแบบดูที่ ติดตั้งอุปกรณ์

3. ติดตั้งโปรแกรม

ที่ Console › Wi-Fi Hotspot › แบบซื้อขาด คัดลอกคำสั่งในส่วน เริ่มต้นใช้งาน ไปรันบนเครื่อง:

Shell
curl -fsSL https://console.thailandhosting.com/install/thwifi.sh | sudo bash -s -- --onprem

คำสั่งจะติดตั้งโปรแกรม thwifi เป็น service ของระบบ แล้วแสดง Hardware ID ของเครื่อง (XXXX-XXXX-XXXX-XXXX) จดไว้ใช้ซื้อ License ดูอีกครั้งได้ด้วย sudo thwifi hwid ต่อท้ายคำสั่งด้วยตัวเลือกเหล่านี้ได้:

ตัวเลือกใช้เมื่อ
--transparentวางแบบ Transparent เครื่องจะไม่แจก IP ทับเราเตอร์เดิม
--wan eth0 --lan eth1เลือกพอร์ตเอง เมื่อเครื่องเลือกผิด หรือมีมากกว่า 2 พอร์ต
--vlan 20Gateway: วงแขกอยู่บน VLAN นี้ของพอร์ต LAN ใส่ซ้ำได้หลายวง Transparent: VLAN ที่ให้เครื่องดูแลนอกจากวงที่ไม่ติด VLAN
--address 192.168.50.1/24 --dhcp-from 192.168.50.20 --dhcp-to 192.168.50.250Gateway: ใช้วง IP ของแขกเองแทน 10.77.0.0/22
--license FILE.licมีไฟล์ License ของเครื่องนี้อยู่แล้ว เช่น ติดตั้งระบบใหม่บนเครื่องเดิม
--binary FILE --manifest FILEเครื่องไม่มีอินเทอร์เน็ต (ดูด้านล่าง)

ตั้งค่าเครือข่ายทั้งหมดนี้เปลี่ยนภายหลังได้ที่หน้าผู้ดูแล เมนู เครือข่าย ไม่ต้องติดตั้งใหม่

4. ซื้อ License

  1. ที่ Console › Wi-Fi Hotspot › แบบซื้อขาด กด ซื้อ License
  2. เลือก จำนวนอุปกรณ์พร้อมกัน (30 ถึง 5,000) ใส่ Hardware ID ของเครื่อง และชื่อเรียกถ้าต้องการ ติ๊กยอมรับเงื่อนไข แล้วกด ซื้อ ค่า License หักจาก Wallet ของ Project
  3. ที่ License ที่ซื้อ กด ไฟล์ License เพื่อดาวน์โหลดไฟล์ .lic แล้วคัดลอกไปไว้บนเครื่อง เช่นด้วย scp หรือ USB

5. เปิดใช้งาน

Shell
sudo thwifi license FILE.lic
sudo thwifi admin-password
sudo systemctl restart thwifi

คำสั่งแรกตรวจและเก็บ License คำสั่งที่สองตั้งรหัสผ่านผู้ดูแล (ชื่อผู้ใช้ตั้งเองได้ด้วย sudo thwifi admin-password ชื่อ) แล้วเริ่มระบบใหม่ ดูสถานะได้ด้วย sudo thwifi status

6. เข้าหน้าผู้ดูแลครั้งแรก

  1. จากคอมพิวเตอร์ในวงของพอร์ต WAN (เช่น วงสำนักงาน) เปิด https://<IP ของเครื่องฝั่ง WAN>:8443 ผู้ใช้ Wi-Fi แขกเข้าหน้านี้ไม่ได้
  2. เบราว์เซอร์จะเตือนเรื่องใบรับรองในครั้งแรก เพราะเครื่องใช้ใบรับรองของตัวเอง เทียบลายนิ้วมือที่หน้าเตือนกับ certificateSha256 จาก sudo thwifi status ถ้าตรงกันจึงกดเข้าต่อ
  3. ล็อกอินด้วยชื่อและรหัสผ่านผู้ดูแลที่ตั้งไว้
  4. ที่เมนู ระบบ ใส่ IP ที่เข้าหน้าผู้ดูแลได้ เช่น วงของฝ่ายไอที โดยเฉพาะแบบ Transparent ที่แขกอยู่วงเดียวกับเครื่อง

7. ตั้งค่าให้พร้อมใช้

  • หน้าเข้าสู่ระบบ: ชื่อสถานที่ ข้อความต้อนรับ สี พื้นหลัง เงื่อนไขการใช้งาน ช่องทางติดต่อ และใบรับรอง HTTPS ของหน้าล็อกอินถ้ามี
  • รหัส Wi-Fi: สร้างและพิมพ์รหัสให้แขก
  • ผู้ใช้: เพิ่มพนักงานทีละคนหรือนำเข้า CSV พร้อมกลุ่ม จำนวนอุปกรณ์ และความเร็ว
  • Active Directory: ให้พนักงานเข้าด้วยบัญชีของบริษัท ใส่ Domain Controller (เครื่องต้องต่อถึงที่พอร์ต 636 LDAPS หรือ 389 StartTLS) Domain, Base DN และกลุ่มที่เข้าได้ แล้วกด ทดสอบ ก่อนเปิดใช้
  • 802.1X: Wi-Fi องค์กรแบบ WPA2/WPA3-Enterprise ให้พนักงานต่อด้วยบัญชีหรือใบรับรองของตัวเอง ดู เชื่อมต่อ WPA2/WPA3-Enterprise (802.1X)
  • อุปกรณ์ที่ออนไลน์: ใส่ MAC ของเครื่องพิมพ์ เครื่อง POS หรืออุปกรณ์ที่ต้องเข้าโดยไม่ล็อกอิน (นับรวมในจำนวนของ License)
  • เครือข่าย: VLAN หลายสายอินเทอร์เน็ต จอง IP และ DNS หลังบันทึกต้องกด ยืนยัน ภายใน 5 นาที (ถ้าที่อยู่เครื่องเปลี่ยน ให้เปิดจากที่อยู่ใหม่) ไม่อย่างนั้นเครื่องย้อนกลับค่าเดิมเอง
  • Log การใช้งาน: ตั้งระยะเก็บ log (อย่างน้อย 90 วัน) ค้น ส่งออก และตรวจว่าไม่มีไฟล์ถูกแก้ ส่วนเมนู ระบบ มี License การอัปเดต การถามหาอัปเดตวันละครั้ง และเปลี่ยนรหัสผ่านผู้ดูแล

8. ตรวจว่าใช้ได้

  1. ต่อมือถือกับ Wi-Fi ที่ Access Point ปล่อย หน้าล็อกอินควรเปิดขึ้นเอง (หรือเปิดเว็บใดก็ได้ที่เป็น http)
  2. ล็อกอินด้วยรหัส Wi-Fi หรือผู้ใช้ที่สร้างไว้ แล้วลองเปิดเว็บ
  3. ที่หน้าผู้ดูแล เมนู อุปกรณ์ที่ออนไลน์ ควรเห็นมือถือเครื่องนั้น และเมนู Log การใช้งาน ควรมีรายการเชื่อมต่อ

เครื่องที่ไม่มีอินเทอร์เน็ต

  1. จากเครื่องอื่น ดาวน์โหลดสคริปต์ติดตั้ง ไฟล์โปรแกรมตามชนิดเครื่อง (amd64 หรือ arm64) และไฟล์ manifest ของรุ่นเดียวกัน จากส่วน เครื่องไม่มีอินเทอร์เน็ต? ในหน้าแบบซื้อขาด
  2. คัดลอกทั้งสามไฟล์ไปที่เครื่อง แล้วรันสคริปต์ด้วย sudo bash thwifi.sh --onprem --binary thwifi-linux-amd64 --manifest thwifi-linux-amd64.manifest (เปลี่ยนชื่อไฟล์ให้ตรงกับที่ดาวน์โหลด)
  3. ซื้อ License ด้วย Hardware ID ที่แสดง แล้วนำไฟล์ License มาใส่ตามขั้นที่ 5 ไฟล์อัปเดต (.thpkg) ในภายหลังก็นำมาอัปโหลดที่เมนู ระบบ ได้เช่นกัน

เครื่องที่ไม่มีอินเทอร์เน็ตต้องมีแพ็กเกจ nftables, conntrack และ iproute2 อยู่แล้ว (Debian และ Ubuntu แบบ server ส่วนใหญ่มีมาให้) ถ้าขาด สคริปต์จะบอกชื่อที่ต้องติดตั้ง

ถ้าเจอปัญหา

ขึ้นว่า “no default route” หรือ “found no second network port”

พอร์ต WAN ยังไม่ได้อินเทอร์เน็ต หรือเครื่องหาพอร์ตที่สองไม่เจอ ต่อสายให้ถูกแล้วรันใหม่ หรือระบุพอร์ตเองด้วย --wan และ --lan (ดูชื่อพอร์ตด้วย ip link)

ขึ้นว่ามี DNS หรือ DHCP server อื่นทำงานอยู่

แบบ Gateway เครื่องต้องแจก IP เอง หยุดโปรแกรมนั้นก่อน เช่น sudo systemctl disable --now dnsmasq แล้วเริ่ม thwifi ใหม่

แบบ Transparent ขึ้นว่าไม่มี nftables bridge filtering

kernel ของเครื่องไม่รองรับ ใช้ Debian 12 หรือ Ubuntu 24.04 กับ kernel มาตรฐานของระบบ (WSL และ kernel ที่ปรับแต่งเองใช้ไม่ได้)

แขกเห็นข้อความว่า Wi-Fi ใช้ไม่ได้ ให้ติดต่อพนักงาน

ยังไม่มี License หรือ License ไม่ตรงกับเครื่องนี้ ดูที่หน้าผู้ดูแล เมนู ระบบ หรือ sudo thwifi status แล้วใส่ไฟล์ License ที่ซื้อด้วย Hardware ID ของเครื่องนี้

เข้าหน้าผู้ดูแลไม่ได้หลังเปลี่ยนเครือข่าย

รัน sudo thwifi network reset แล้ว sudo systemctl restart thwifi เครื่องจะกลับไปใช้ค่าตอนติดตั้ง ถ้าตั้ง IP ที่เข้าหน้าผู้ดูแลได้ไว้ ต้องเปิดจาก IP ในรายการ

ลืมรหัสผ่านผู้ดูแล

รัน sudo thwifi admin-password บนเครื่องเพื่อตั้งรหัสใหม่

หน้าล็อกอินไม่ขึ้นเอง

ตรวจว่า Access Point ต่อกับพอร์ต LAN และไม่ได้แจก IP เอง (ปิด DHCP ใน Access Point หรือตั้งเป็นโหมด Access Point/Bridge) แล้วลองเปิดเว็บที่ขึ้นต้นด้วย http://

ยังแก้ไม่ได้? ให้ทีมงานช่วย

เปิด ticket จากหน้าจัดการ บอกชื่อเว็บหรือบริการ สิ่งที่ทำ และข้อความที่เห็นบนจอ ทีมงานจะตอบกลับในเรื่องเดียวกัน ติดตามได้ในที่เดียว

เปิด ticket ถึงทีมงาน คู่มือทั้งหมด