คู่มือติดตั้ง
ตั้งแต่เตรียมเครื่องจนลูกค้าสแกนจ่ายได้ ใช้เวลาประมาณ 30–60 นาที · แบบกล่องสำเร็จรูปข้ามข้อ 2 ได้ (ลงระบบไว้ให้แล้ว) เริ่มที่ข้อ 3
1. สิ่งที่ต้องเตรียม
- MikroTik ที่ใช้ RouterOS 7.9 ขึ้นไป และเปิด Hotspot ไว้แล้ว (IP → Hotspot → Hotspot Setup)ดูเวอร์ชันใน Winbox มุมบนซ้าย — ต่ำกว่า 7.9 ให้อัปเดตที่ System → Packages → Check For Updates
- เครื่องสำหรับติดตั้งระบบ (PC / Mini PC / VM) Ubuntu หรือ Debian 64 บิต · CPU x86_64 หรือ arm64 · RAM 1 GB ขึ้นไป · พื้นที่ว่าง 10 GBต่อสาย LAN วงเดียวกับ MikroTik (ไม่ใช่วง hotspot ที่ลูกค้าใช้) ให้รับ IP จาก DHCP ตามปกติ — ไม่ต้องตั้ง IP คงที่เอง ระบบจะจอง IP ใน MikroTik ให้
- บัญชี Beam Checkout ของร้าน — ใช้ Merchant ID และ API Key (เงินลูกค้าเข้าบัญชีร้านโดยตรง)
- License key — ส่งไปที่อีเมลที่ยืนยันไว้ตอนซื้อ (ไม่เห็น ดูในกล่องจดหมายขยะ)
2. ติดตั้งระบบ (แบบติดตั้งเอง)
เข้าเครื่องที่เตรียมไว้ (หน้าจอ/คีย์บอร์ด หรือ SSH) แล้วรันคำสั่งเดียว:
curl -fsSL https://www.golden-wifi.dev/install.sh | sudo sh
สคริปต์จะติดตั้ง Docker (ถ้ายังไม่มี) ดาวน์โหลดระบบ แล้วเริ่มทำงาน เสร็จแล้วจะแสดง:
==> ติดตั้งเสร็จแล้ว เปิดหน้าตั้งค่า: http://192.168.88.10:3000/admin รหัสตั้งค่าครั้งแรก: 1a2b3c4d
จดลิงก์และรหัสไว้ — ดูรหัสอีกครั้งได้ด้วย sudo golden-wifi setup-code
3. ตั้งรหัสผู้ดูแล
- เปิดลิงก์หน้าตั้งค่าจากข้อ 2 ในเบราว์เซอร์ (เครื่องที่อยู่วงเดียวกัน) — ต่อจอกับเครื่องไว้ ลิงก์จะแสดงบนหน้าจอด้วย
- กรอก รหัสตั้งค่าครั้งแรก (กล่องสำเร็จรูป: ดูที่สติกเกอร์ใต้เครื่อง)
- ตั้ง Username และ Password ของคุณ (อย่างน้อย 8 ตัว) → เริ่มใช้งาน
ติดตั้งเป็นแอปบนมือถือได้: เปิดหน้า admin ใน Safari → แชร์ → เพิ่มไปยังหน้าจอโฮม
4. เริ่มต้นใช้งาน (ทีละขั้น)
ตั้งรหัสเสร็จ ระบบจะพาเข้าหน้า เริ่มต้นใช้งาน ทันที — ทำทีละขั้น หน้าละเรื่อง กดปุ่มใหญ่เพื่อไปต่อ ระบบตรวจให้ทุกขั้นก่อนผ่าน
License
วาง license key จากอีเมล (ขึ้นต้นด้วย WSL1.) → ตรวจสอบและไปต่อ
1 key ใช้ได้ 1 เครื่อง — ย้ายไปเครื่องใหม่ ติดต่อเราเพื่อปลดเครื่องเดิมก่อน
ร้านของคุณ
ใส่ ชื่อร้าน (แสดงบนหน้า WiFi ของลูกค้า) แล้วเลือกว่ามือถือลูกค้าจะเข้าระบบนี้ผ่านอะไร — port ระบบตั้งให้เอง:
| IP ปัจจุบัน | ง่ายที่สุด — เลือก IP ที่เครื่องได้ตอนนี้ ระบบจะจอง IP นี้ใน MikroTik ให้ (ได้ IP เดิมเสมอ) |
| IP ใหม่ | พิมพ์ IP ที่ต้องการ (วงเดียวกับที่ MikroTik แจก เช่น 192.168.88.10) — ต้องรีสตาร์ทเครื่อง 1 ครั้ง ดูขั้นตั้งค่า MikroTik |
| โดเมน | ใส่แค่ชื่อโดเมน เช่น wifi.myshop.com — โดเมนต้องชี้มาที่เครื่องนี้แบบ https แล้ว (เช่น Cloudflare Tunnel) · ใช้ webhook ของ Beam ได้ |
เชื่อม MikroTik
ก่อนเริ่ม: MikroTik ต้องเปิด Hotspot ไว้แล้ว และเป็น RouterOS 7.9 ขึ้นไป
- ใส่ IP ของ MikroTik (IP ที่ใช้เข้า Winbox) → สร้างสคริปต์
- กด คัดลอกสคริปต์ → เปิด Winbox → New Terminal → คลิกขวา Paste → Enter รอจนเสร็จ
- กลับมากด ทดสอบการเชื่อมต่อ — ผ่านแล้วไปขั้นถัดไปเอง
สคริปต์จะสำรองค่าเดิมของ MikroTik ไว้ก่อน สร้าง user สำหรับระบบ เปิด REST API และติดตั้งสคริปต์สำรองข้อมูล · เปลี่ยน port ของ www หรือจำกัด IP ได้ที่ “ตัวเลือกเพิ่มเติม”
ตั้งค่า MikroTik อัตโนมัติ
ดูรายการที่จะทำ แล้วกด ตั้งค่าให้อัตโนมัติ (ประมาณ 20 วินาที) — ระบบจะสร้าง user profile ความเร็ว, walled garden ให้ลูกค้าเปิดหน้าซื้อได้ก่อน login, จอง IP ของเครื่องนี้ใน DHCP และติดตั้งหน้า WiFi ใหม่
http://IP-ใหม่:port/admin → เข้าสู่ระบบอีกครั้ง แล้วกดตั้งค่าอัตโนมัติอยากกลับไปใช้หน้า login เดิม: ตั้งค่า → ตั้งค่า MikroTik → ย้อนกลับ ได้ทุกเมื่อ
รับเงิน (Beam)
- เลือกโหมด ทดสอบก่อน (ยังไม่รับเงินจริง) หรือ ใช้งานจริง — คีย์สองโหมดเป็นคนละชุด
- ใส่ Merchant ID และ API Key จาก Beam Lighthouse → ทดสอบคีย์และไปต่อ
- ใช้โดเมน: หน้านี้จะแสดง Webhook URL (
https://โดเมน/api/webhooks/beam) พร้อมปุ่มคัดลอก — นำไปเพิ่มใน Beam Lighthouse → Webhooks แล้วใส่ Webhook Key ที่ Beam ให้มา (ลูกค้าจ่ายแล้วเน็ตเปิดทันที)
ใช้ IP ในร้าน: ไม่ต้องตั้ง webhook — ระบบเช็กการจ่ายเงินกับ Beam เองทุก 5 วินาที
แพ็กเกจ
แก้ชื่อ ราคา และเวลา (นาที / ชั่วโมง / วัน หรือ ไม่มีวันหมดอายุ) ได้ทุกแพ็กเกจในหน้าเดียว — ติ๊กหน้าแพ็กเกจ = เปิดขาย · เพิ่มแพ็กเกจหรือตั้งความเร็วแยกได้ภายหลังที่เมนู แพ็กเกจ
ครบทุกขั้นจะขึ้น “พร้อมขายแล้ว!” พร้อมวิธีทดสอบด้วยมือถือ
5. ความเร็วและเน็ตฟรี (ไม่บังคับ)
- ตั้งค่า → ความเร็วอินเทอร์เน็ต — ความเร็วตั้งต้น, ระหว่างจ่ายเงิน และทดลองฟรี (Mbps)
- ตั้งค่า → เน็ตฟรี — ระหว่างจ่ายเงิน ให้ลูกค้าใช้ WiFi ร้านเปิดแอปธนาคาร · ทดลองใช้ฟรี กี่นาที กี่ครั้งต่อวัน
6. ทดสอบก่อนเปิดขาย
- ใช้มือถือต่อ WiFi ของร้าน — หน้าเลือกแพ็กเกจต้องขึ้นเอง
- กดซื้อแพ็กเกจถูกสุด → สแกน QR จ่าย (โหมดทดสอบของ Beam)
- จ่ายแล้วต้องใช้เน็ตได้ทันที และเห็นรายการในหน้า รายการ / รายงาน
- ทุกอย่างผ่าน → กลับไปขั้น รับเงิน เลือก ใช้งานจริง พร้อมคีย์จริง แล้วเปิดขายได้เลย
7. อัปเดตและสำรองข้อมูล
เมนู สำรองข้อมูล ในหน้าผู้ดูแล:
- ดาวน์โหลดไฟล์สำรอง — ทั้งระบบ (.db) หรือเฉพาะการตั้งค่า (.json) · ระบบสำรองอัตโนมัติให้ทุกวัน เก็บ 7 วันล่าสุด
- กู้คืนจากไฟล์ — ใช้ย้ายไปเครื่องใหม่ได้: ติดตั้งเครื่องใหม่ (ข้อ 2–3) แล้วเปิดเมนู สำรองข้อมูล กู้คืนไฟล์ .db ก่อนทำขั้นเริ่มต้นใช้งาน
- MikroTik — สำรองค่าไว้บนตัว MikroTik และกู้คืนได้ (MikroTik จะรีบูต) · ดาวน์โหลดไฟล์ .backup เก็บไว้นอกเครื่องได้ · ถ้าขึ้นว่าต้องอัปเดตสคริปต์ ให้วางสคริปต์ขั้นเชื่อม MikroTik ใหม่อีกครั้ง
คำสั่งบนเครื่องที่ติดตั้ง:
sudo golden-wifi update | อัปเดตเป็นเวอร์ชันล่าสุด (ข้อมูลเดิมอยู่ครบ) |
sudo golden-wifi backup | สำรองฐานข้อมูลไว้ที่ /opt/golden-wifi/data |
sudo golden-wifi status | ดูว่าระบบทำงานอยู่ไหม |
sudo golden-wifi logs | ดู log (กด Ctrl+C เพื่อออก) |
sudo golden-wifi setup-code | ดูรหัสตั้งค่าครั้งแรก |
ควรคัดลอกไฟล์สำรองออกไปเก็บนอกเครื่องเป็นระยะ
แก้ปัญหาที่พบบ่อย
มือถือต่อ WiFi แล้วหน้าเลือกแพ็กเกจไม่ขึ้น / กดซื้อแล้วค้าง
ตรวจที่อยู่ในขั้น ร้านของคุณ ว่าถูกต้อง แล้วทำขั้น เชื่อม MikroTik (วางสคริปต์ใหม่) และ ตั้งค่า MikroTik อีกครั้ง · เครื่องที่ติดตั้งระบบต้องไม่อยู่ในวง hotspot
ตรวจการเชื่อมต่อ MikroTik ไม่ผ่าน
หน้าจอจะบอกสาเหตุ: MikroTik ไม่ตอบ = IP ผิดหรือเครื่องอยู่คนละวง · รหัสไม่ตรง = ยังไม่ได้วางสคริปต์หรือวางไม่ครบ (คัดลอกใหม่แล้ววางอีกครั้ง) · ปิดบริการเว็บ = IP → Services ต้องเปิด www ที่ port ตามที่กรอก · RouterOS ต้อง 7.9 ขึ้นไป
วางสคริปต์แล้ว Terminal ขึ้นข้อความ WIFI-SHOP: สีแดง (เลือก IP ใหม่)
การย้าย IP ไม่สำเร็จ ส่วนอื่นของสคริปต์ทำงานครบแล้ว — is used by another device / reserved for another device = IP นี้มีเครื่องอื่นใช้หรือจองไว้ เลือก IP อื่น · is not in a DHCP network = IP อยู่นอกวงที่ MikroTik แจก · cannot find … in ARP = MikroTik มองไม่เห็นเครื่องนี้ ให้เลือก IP ปัจจุบัน แทน · แก้แล้วกลับไปขั้นร้านของคุณ และวางสคริปต์ใหม่
รีสตาร์ทแล้วเปิดที่อยู่ใหม่ไม่ได้
รออีก 1–2 นาที · ถ้ายังไม่ได้ เปิดด้วยที่อยู่เดิม (http://IP-เดิม:port/admin) แล้วเลือก IP ปัจจุบัน ในขั้นร้านของคุณ · ถ้าเคยตั้ง IP คงที่ไว้ในตัวเครื่องเอง เครื่องจะไม่รับ IP ใหม่จาก MikroTik
License ขึ้นว่า “ใช้กับเครื่องอื่นอยู่”
key นี้ผูกกับเครื่องเดิมแล้ว (เช่น ติดตั้งใหม่หรือเปลี่ยนเครื่อง) — ติดต่อเราเพื่อปลดเครื่องเดิม แล้วกดบันทึก key อีกครั้ง
ลูกค้าจ่ายแล้วแต่เน็ตยังไม่มา
ดูหน้า รายการ ในระบบ ถ้าสถานะ “จ่ายแล้ว” แต่ยังไม่สำเร็จ กด ลองใหม่ · ตรวจว่า Beam อยู่โหมดเดียวกับคีย์ที่ใส่ (ทดสอบ/ใช้งานจริง)
หน้าลูกค้าขึ้น “ยังไม่เปิดให้บริการ”
license ใช้ไม่ได้ (หมดอายุ / ถูกระงับ / เชื่อมต่อเว็บผู้ขายไม่ได้เกิน 14 วัน) — ดูรายละเอียดที่ ตั้งค่า → License