คู่มือติดตั้ง

ตั้งแต่เตรียมเครื่องจนลูกค้าสแกนจ่ายได้ ใช้เวลาประมาณ 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. ตั้งรหัสผู้ดูแล

  1. เปิดลิงก์หน้าตั้งค่าจากข้อ 2 ในเบราว์เซอร์ (เครื่องที่อยู่วงเดียวกัน) — ต่อจอกับเครื่องไว้ ลิงก์จะแสดงบนหน้าจอด้วย
  2. กรอก รหัสตั้งค่าครั้งแรก (กล่องสำเร็จรูป: ดูที่สติกเกอร์ใต้เครื่อง)
  3. ตั้ง 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 ขึ้นไป

  1. ใส่ IP ของ MikroTik (IP ที่ใช้เข้า Winbox) → สร้างสคริปต์
  2. กด คัดลอกสคริปต์ → เปิด Winbox → New Terminal → คลิกขวา Paste → Enter รอจนเสร็จ
  3. กลับมากด ทดสอบการเชื่อมต่อ — ผ่านแล้วไปขั้นถัดไปเอง

สคริปต์จะสำรองค่าเดิมของ MikroTik ไว้ก่อน สร้าง user สำหรับระบบ เปิด REST API และติดตั้งสคริปต์สำรองข้อมูล · เปลี่ยน port ของ www หรือจำกัด IP ได้ที่ “ตัวเลือกเพิ่มเติม”

ตั้งค่า MikroTik อัตโนมัติ

ดูรายการที่จะทำ แล้วกด ตั้งค่าให้อัตโนมัติ (ประมาณ 20 วินาที) — ระบบจะสร้าง user profile ความเร็ว, walled garden ให้ลูกค้าเปิดหน้าซื้อได้ก่อน login, จอง IP ของเครื่องนี้ใน DHCP และติดตั้งหน้า WiFi ใหม่

เลือก IP ใหม่ไว้? ขั้นนี้จะขึ้นหน้า “ย้ายไป IP ใหม่” ก่อน: รีสตาร์ทเครื่อง (หรือถอดสาย LAN 10 วินาทีแล้วเสียบใหม่) → รอ 1–2 นาที → เปิด http://IP-ใหม่:port/admin → เข้าสู่ระบบอีกครั้ง แล้วกดตั้งค่าอัตโนมัติ

อยากกลับไปใช้หน้า login เดิม: ตั้งค่า → ตั้งค่า MikroTik → ย้อนกลับ ได้ทุกเมื่อ

รับเงิน (Beam)

  1. เลือกโหมด ทดสอบก่อน (ยังไม่รับเงินจริง) หรือ ใช้งานจริง — คีย์สองโหมดเป็นคนละชุด
  2. ใส่ Merchant ID และ API Key จาก Beam Lighthouse → ทดสอบคีย์และไปต่อ
  3. ใช้โดเมน: หน้านี้จะแสดง Webhook URL (https://โดเมน/api/webhooks/beam) พร้อมปุ่มคัดลอก — นำไปเพิ่มใน Beam Lighthouse → Webhooks แล้วใส่ Webhook Key ที่ Beam ให้มา (ลูกค้าจ่ายแล้วเน็ตเปิดทันที)

ใช้ IP ในร้าน: ไม่ต้องตั้ง webhook — ระบบเช็กการจ่ายเงินกับ Beam เองทุก 5 วินาที

แพ็กเกจ

แก้ชื่อ ราคา และเวลา (นาที / ชั่วโมง / วัน หรือ ไม่มีวันหมดอายุ) ได้ทุกแพ็กเกจในหน้าเดียว — ติ๊กหน้าแพ็กเกจ = เปิดขาย · เพิ่มแพ็กเกจหรือตั้งความเร็วแยกได้ภายหลังที่เมนู แพ็กเกจ

ครบทุกขั้นจะขึ้น “พร้อมขายแล้ว!” พร้อมวิธีทดสอบด้วยมือถือ

5. ความเร็วและเน็ตฟรี (ไม่บังคับ)

  • ตั้งค่า → ความเร็วอินเทอร์เน็ต — ความเร็วตั้งต้น, ระหว่างจ่ายเงิน และทดลองฟรี (Mbps)
  • ตั้งค่า → เน็ตฟรี — ระหว่างจ่ายเงิน ให้ลูกค้าใช้ WiFi ร้านเปิดแอปธนาคาร · ทดลองใช้ฟรี กี่นาที กี่ครั้งต่อวัน

6. ทดสอบก่อนเปิดขาย

  1. ใช้มือถือต่อ WiFi ของร้าน — หน้าเลือกแพ็กเกจต้องขึ้นเอง
  2. กดซื้อแพ็กเกจถูกสุด → สแกน QR จ่าย (โหมดทดสอบของ Beam)
  3. จ่ายแล้วต้องใช้เน็ตได้ทันที และเห็นรายการในหน้า รายการ / รายงาน
  4. ทุกอย่างผ่าน → กลับไปขั้น รับเงิน เลือก ใช้งานจริง พร้อมคีย์จริง แล้วเปิดขายได้เลย

7. อัปเดตและสำรองข้อมูล

เมนู สำรองข้อมูล ในหน้าผู้ดูแล:

  • ดาวน์โหลดไฟล์สำรอง — ทั้งระบบ (.db) หรือเฉพาะการตั้งค่า (.json) · ระบบสำรองอัตโนมัติให้ทุกวัน เก็บ 7 วันล่าสุด
  • กู้คืนจากไฟล์ — ใช้ย้ายไปเครื่องใหม่ได้: ติดตั้งเครื่องใหม่ (ข้อ 2–3) แล้วเปิดเมนู สำรองข้อมูล กู้คืนไฟล์ .db ก่อนทำขั้นเริ่มต้นใช้งาน
  • MikroTik — สำรองค่าไว้บนตัว MikroTik และกู้คืนได้ (MikroTik จะรีบูต) · ดาวน์โหลดไฟล์ .backup เก็บไว้นอกเครื่องได้ · ถ้าขึ้นว่าต้องอัปเดตสคริปต์ ให้วางสคริปต์ขั้นเชื่อม MikroTik ใหม่อีกครั้ง
ย้ายเครื่อง: license ผูกกับเครื่องเดิม — กู้คืนไฟล์ .db จะใช้ต่อได้ หรือติดต่อเราเพื่อปลดเครื่อง

คำสั่งบนเครื่องที่ติดตั้ง:

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

ติดตรงไหน ติดต่อเรา พร้อมแคปหน้าจอ — เราช่วยตั้งค่าทางไกลให้ได้ · ยังไม่มี license? ดูราคา