ติดตั้งใหม่
เชื่อม LINE ทีละขั้น

เตรียมไฟล์และเลือกที่ติดตั้ง

• ไฟล์ ZIP ชุดติดตั้งเต็ม Japan Pocket v2.0.1
• บัญชี LINE ที่จะใช้เป็นเจ้าของแอพ
• อีเมลที่ปอเปิดอ่านได้ เพื่อรับข่าวและคำเชิญจาก LINE Developers
• ข้อมูลเข้า DirectAdmin/โฮส และโดเมนที่เปิดผ่าน HTTPS ได้
• ฐานข้อมูลใหม่ MySQL/MariaDB พร้อมชื่อผู้ใช้และรหัสผ่าน

เปิด START-HERE.txt แล้วอ่านรหัสจาก INSTALL-KEY.php

แตก ZIP บนเครื่อง แล้วเปิด START-HERE.txt ที่อยู่นอกโฟลเดอร์ japan เพื่ออ่านขั้นตอนเริ่มต้น รหัสจริงอยู่ในไฟล์ INSTALL-KEY.php แยกต่างหาก

1. เปิด INSTALL-KEY.php ด้วยโปรแกรมแก้ข้อความ เช่น Notepad หรือใช้ File Manager → Edit ของ Hostatom
2. หาแถวที่ระบุ INSTALL_KEY = … แล้วคัดลอกเฉพาะค่ารหัสหลังเครื่องหมาย = ไม่ต้องคัดลอกชื่อช่องหรือข้อความคำอธิบาย
3. ใช้รหัสนี้กรอกช่องรหัสติดตั้งใน install.php

อย่าเปิด INSTALL-KEY.php เป็นหน้าเว็บเพื่ออ่านรหัส ไฟล์ตั้งใจตอบ 403 โดยไม่แสดงรหัสเมื่อเรียกผ่านเบราว์เซอร์ ทางเลือกคือเปิดไฟล์ japan/config.php ด้วยโปรแกรมแก้ข้อความ หรือเปิด config.php ในโฟลเดอร์แอพผ่าน File Manager → Edit แล้วอ่านค่า setup_key ซึ่งเป็นรหัสเดียวกัน

อัปโหลดเฉพาะไฟล์ภายในโฟลเดอร์ japan ไปยังโฟลเดอร์แอพบนโฮส เก็บ START-HERE.txt และ INSTALL-KEY.php ไว้บนเครื่องของปอ ไม่ต้องนำไฟล์นอกโฟลเดอร์ japan ขึ้นพื้นที่แอพ

กำหนด URL แอพหนึ่งชุดให้ชัด

ถ้าใช้โดเมนหรือพาธอื่น ให้แทนตัวอย่างทุกแห่ง เช่น https://YOURDOMAIN/PATH/ โดยรักษาเครื่องหมาย / ท้าย URL แอพไว้

สมัคร LINE Developers

1. เปิด developers.line.biz/console ผ่าน Chrome/Safari หรือคอมพิวเตอร์ หากเริ่มจากหน้า LINE Developers ให้กด Log in to Console
2. เลือกเข้าด้วย LINE account ของปอ บนมือถืออาจมีปุ่มยืนยันบัญชี บนคอมพิวเตอร์เลือกสแกน QR ด้วยแอพ LINE ได้ ถ้าหน้าจอให้ยืนยันรหัส ให้ทำตามข้อความบนอุปกรณ์
3. ถ้าเป็นครั้งแรก จะมีหน้าเปิดบัญชีนักพัฒนา กรอก Developer name เป็นชื่อเจ้าของหรือชื่อที่ใช้ดูแลบริการ และ Your email เป็นอีเมลที่ติดต่อได้
4. อ่าน LINE Developers Agreement แล้วเลือกยอมรับเมื่อเห็นด้วย จากนั้นกด Create my account
5. เมื่อสร้างบัญชีแล้ว จะเข้าสู่ Console ที่มีรายการ Providers

หากเคยใช้บัญชีนักพัฒนานี้แล้ว จะข้ามหน้าสมัครได้ อีเมลของนักพัฒนาเป็นข้อมูลติดต่อผู้ดูแล ไม่ใช่การขออีเมลของผู้ใช้แอพ

สร้าง Provider ของบริการ

Provider คือผู้ให้บริการที่แสดงต่อผู้ใช้ตอนขอสิทธิ์เข้าสู่ระบบ ส่วน channel คือช่องเชื่อมแอพภายใต้ผู้ให้บริการนั้น

1. ที่หน้ารายการ Providers กด Create
2. กรอก Provider name เป็นชื่อผู้ให้บริการที่ต้องการใช้ระยะยาว เช่น DRAFX หรือชื่อเจ้าของบริการจริง หากให้บริการในนามบริษัท ให้ใช้ชื่อบริษัท/องค์กรนั้น
3. กด Create แล้วเปิด Provider ที่สร้าง

เลือก Provider ให้ถูกก่อนสร้าง channel
เมื่อสร้าง channel แล้ว ย้ายไป Provider อื่นภายหลังไม่ได้ LINE จะแยกรหัสผู้ใช้ตาม Provider หากจะเพิ่มบอท Messaging API ของ Japan Pocket ภายหลัง ให้สร้างภายใต้ Provider เดียวกับ LINE Login ของบริการนี้

ไม่จำเป็นต้องสร้าง Provider ใหม่ ถ้าปอมี Provider ของผู้ให้บริการเดียวกันอยู่แล้ว และต้องการดูแล Japan Pocket ใต้นั้น หลีกเลี่ยงใช้ Provider ของคนอื่นที่ปอไม่มีสิทธิ์ดูแลระยะยาว

สร้าง LINE Login channel

1. เปิด Provider ที่เลือก แล้วไปแท็บ Channels
2. กด Create a new channel หรือช่องสร้าง channel ที่หน้าจอแสดง
3. เลือกชนิด LINE Login อย่าเลือก Messaging API หรือ LINE MINI App สำหรับการติดตั้งขั้นนี้
4. กรอกแบบฟอร์มตามตารางด้านล่าง แล้วตรวจทานก่อนกด Create

ชื่อและตำแหน่งปุ่มอาจเปลี่ยนตามภาษา/หน้าตา Console ให้ยึดชื่อฟังก์ชันและชนิด channel เป็นหลัก ขั้นนี้ไม่ต้องสร้าง LINE Official Account และไม่ต้องซื้อแพ็กเกจส่งข้อความ

หา Channel ID และ Channel secret

1. เปิด channel Japan Pocket ที่เพิ่งสร้าง
2. ไปแท็บ Basic settings
3. หา Channel ID แล้วคัดลอกตัวเลขทั้งชุด เก็บไว้กรอกตัวติดตั้ง ช่องนี้ไม่ใช่ Provider ID
4. เลื่อนหา Channel secret คัดลอกค่าที่หน้าจอแสดงหรือเปิดแสดงตามปุ่มของ Console เก็บไว้กรอกตัวติดตั้ง
5. ตรวจ App types ว่าเป็น Web app

Channel secret ใช้เฉพาะฝั่งโฮส วางลงช่องตัวติดตั้งบน HTTPS ของปอ ไม่ต้องส่งในแชทหรือใส่ลงไฟล์ JavaScript ช่อง Your user ID และ Channel access token ไม่ใช่ค่าที่ตัวติดตั้งรุ่นนี้ต้องการ

เตรียม MySQL/MariaDB บน Hostatom

ข้อกำหนดโฮส

• PHP 7.4 ขึ้นไป ชุดใหม่แนะนำ PHP 8.2 หรือใหม่กว่าที่โฮสรองรับ
• ส่วนขยาย PDO MySQL และ ctype
• เชื่อมต่อ LINE ผ่าน HTTPS ขาออกได้ด้วย cURL หรือ OpenSSL ร่วมกับ allow_url_fopen
• โดเมนมี SSL ที่เบราว์เซอร์เชื่อถือ และโฟลเดอร์แอพ/โฟลเดอร์ storage เขียนไฟล์ได้โดยผู้ใช้ PHP ของโฮส

สร้างฐานข้อมูลใหม่

1. เข้า DirectAdmin จากลิงก์ที่ Hostatom ให้ และเลือกบัญชี/โดเมนที่จะติดตั้ง
2. เปิด Account Manager → Databases บางหน้าตาอาจชื่อ MySQL Management
3. สร้างฐานข้อมูลใหม่ เช่นชื่อท้าย jpocket แล้วกด Create ระบบอาจสร้างผู้ใช้และรหัสผ่านให้พร้อมกัน
4. ถ้าต้องการกำหนดผู้ใช้เอง ให้เปิด Advanced mode แล้วใส่ชื่อผู้ใช้และรหัสผ่าน จากนั้นสร้าง
5. เก็บค่าที่โฮสแสดงหลังสร้าง: Hostname, Database, Username, Password ชื่อจริงอาจเป็น ชื่อบัญชี_jpocket ต้องใช้ชื่อเต็มพร้อมคำนำหน้า
6. หากแยกสร้างผู้ใช้ภายหลัง ให้เปิด Manage ของฐานข้อมูล ไปส่วน User Access เลือกผู้ใช้ใน Grant access for additional user แล้วให้สิทธิ์ Grant full access เฉพาะฐานข้อมูลใหม่นี้

ใช้ฐานข้อมูลว่างใหม่ ไม่เลือกฐานข้อมูลเว็บแม่หรือระบบอื่น ตัวติดตั้งจะสร้างตารางเอง ไม่ต้องนำเข้าไฟล์ SQL ด้วยมือ

อัปโหลดไฟล์และเปิด install.php

1. เปิด File Manager ของโฮส เข้า document root ของโดเมน store.drafx.app ที่จะใช้ ตำแหน่งจริงอาจต่างกันตามการตั้งค่า subdomain
2. สร้างโฟลเดอร์ว่างใหม่ชื่อ japan-pocket หรือชื่อที่เลือกในขั้นแรก
3. นำไฟล์ภายในโฟลเดอร์ japan ของ ZIP มาวางในโฟลเดอร์ใหม่นี้ เช่น index.php, install.php, assets, storage และไฟล์ .htaccess ที่มาพร้อมชุด
4. ตรวจว่า install.php อยู่ชั้นเดียวกับ index.php ไม่ซ้อนเป็น /japan-pocket/japan/install.php โดยไม่ตั้งใจ
5. เปิด https://store.drafx.app/japan-pocket/install.php ผ่านเบราว์เซอร์ ถ้าเปิด URL แอพก่อนติดตั้ง ระบบจะพาเข้าตัวติดตั้ง

สิทธิ์ไฟล์และโฟลเดอร์

เริ่มด้วยไฟล์ 644 และโฟลเดอร์ 755 ซึ่งเป็นค่าทั่วไปของโฮส หากตัวติดตั้งแจ้งเขียนไม่ได้ ให้ตรวจเจ้าของไฟล์และผู้ใช้ PHP กับโฮสก่อน โฟลเดอร์ storage อาจใช้ 775 เมื่อรูปแบบเจ้าของ/กลุ่มบนโฮสรองรับ ไม่ต้องเปิด 777

ใน File Manager ของ DirectAdmin ใช้คลิกขวา → Set Permissions ชื่อเมนูอาจต่างกันตามธีมแผงควบคุม

ใส่ Callback URL ให้ตรงกัน

Callback URL คือหน้าที่ LINE จะส่งผู้ใช้กลับมาหลังยืนยันบัญชี ชุดนี้ใช้ไฟล์ account.php พร้อมคำสั่ง ?action=callback

1. ที่ตัวติดตั้ง ตรวจช่อง URL แอพ ค่าเดาอัตโนมัติอาจต้องแก้ถ้าระบบโฮสมี proxy หรือเปลี่ยนพาธ
2. ตั้งเป็น URL ที่ใช้งานจริง เช่น https://store.drafx.app/japan-pocket/
3. กด คัดลอก Callback URL ที่ตัวติดตั้งแสดง ค่าในช่องจะปรับตาม URL แอพที่กรอก
4. กลับไป LINE Developers → Provider → channel Japan Pocket → แท็บ LINE Login
5. หา Callback URL กด Edit วาง URL แล้วกด Update หรือปุ่มบันทึกที่หน้าจอแสดง

• เป็น https://
• โดเมนตรงกัน รวมการใช้หรือไม่ใช้ www
• ชื่อโฟลเดอร์และตัวพิมพ์เล็กใหญ่ตรงกัน
• ลงท้าย account.php?action=callback ครบ ไม่ตัดข้อความหลัง ?

ถ้าทดลองหลาย URL ใน channel เดียว LINE รองรับ Callback URL หลายบรรทัด แต่ URL ที่แอพส่งต้องตรงกับ URL ที่ลงทะเบียนไว้ สำหรับเริ่มต้นหนึ่งพาธ ใช้รายการเดียวให้ตรวจง่าย

กรอกตัวติดตั้งและเปิดทริปแรก

1. กรอกข้อมูลครบ ตรวจว่ามาจาก LINE Login channel เดียวกัน แล้วกดปุ่มติดตั้งตามหน้าจอ
2. ตัวติดตั้งตรวจเงื่อนไขโฮส เชื่อม MySQL สร้างตาราง และเขียนค่าฝั่งเซิร์ฟเวอร์ การบันทึกตัวติดตั้งยังไม่เท่ากับการทดสอบล็อกอินกับ LINE สำเร็จ
3. เมื่อสำเร็จ จะมีปุ่ม เปิดทริปแรกด้วย LINE และลิงก์เจ้าของแบบใช้ครั้งเดียว ให้เก็บลิงก์นี้ไว้เป็นส่วนตัวก่อนปิดหน้า
4. ปอกดปุ่มนั้น เข้าสู่ระบบด้วย LINE ของตัวเอง ตรวจชื่อผู้ให้บริการ/แอพในหน้าขอสิทธิ์ แล้วอนุญาตหากต้องการใช้งาน
5. เมื่อกลับมาถึง Japan Pocket ควรเห็นกลุ่มส่วนตัวพร้อมรายการว่าง ตรวจในหน้าตั้งค่าว่าชื่อบัญชีเป็นของปอ

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

หากการติดตั้งยังไม่ผ่าน ให้แก้ตามข้อความที่หน้า install.php แสดงก่อนเข้าสู่ระบบ อย่าทำไฟล์ตั้งค่าใหม่ทับฐานข้อมูลที่ใช้งานแล้วเพียงเพื่อให้ปุ่มติดตั้งกลับมา

ทดสอบกลุ่มและเชิญผู้ร่วมทริป

ปอสร้างและตั้งกลุ่ม

1. เปิด ตั้งค่า → บัญชีและกลุ่ม
2. เลือกกลุ่มที่ต้องการ ถ้าต้องการแยกทริปเพิ่ม เปิด สร้างกลุ่ม แล้วตั้งชื่อ เช่น ญี่ปุ่น พ.ย. 2569
3. เจ้าของเปิด จัดการกลุ่ม เพื่อเปลี่ยนชื่อ สร้างคำเชิญ และดูสมาชิก

ส่งคำเชิญให้เม

1. เลือกสิทธิ์ เพิ่มและแก้รายจ่ายได้ หรือ ดูรายจ่ายอย่างเดียว
2. กด สร้างลิงก์เชิญ คัดลอกและส่งให้เมผ่าน LINE หรือช่องทางที่ต้องการ
3. เมเปิดลิงก์ เข้าสู่ระบบด้วย LINE ของเมเอง แล้วกด เข้าร่วมกลุ่ม ภายในแอพ
4. เพิ่มรายจ่ายทดสอบหนึ่งรายการบนเครื่องปอ แล้วกดซิงก์บนทั้งสองเครื่อง ตรวจว่าเมเห็นรายการในกลุ่มที่เชิญ

คำเชิญใช้ได้ครั้งเดียว อายุ 7 วัน ถ้าเชิญหลายคนให้สร้างแยกแต่ละคน เจ้าของยกเลิกลิงก์ที่ยังไม่ได้ใช้หรือนำสมาชิกออกได้

กลุ่มทริปนี้อยู่ใน Japan Pocket
การเชิญไม่ได้สร้างกลุ่มแชท LINE และไม่ได้เชิญบอทเข้า LINE กลุ่ม รุ่นนี้เน้น LINE Login และข้อมูลร่วมกัน ยังไม่มีจดผ่านแชทหรือ AI อ่านใบเสร็จ

จากทดสอบส่วนตัวสู่ผู้ใช้ทั่วไป

ทดสอบก่อน โดยคงสถานะ Developing

LINE Login channel ใหม่เริ่มที่ Developing บัญชีที่เป็น Admin หรือ Tester ของ channel จึงจะลองล็อกอินได้ การเป็นสมาชิกกลุ่มในแอพอย่างเดียวไม่ข้ามข้อจำกัดนี้

1. ใน channel เปิดแท็บ Roles
2. ใช้คำสั่งเชิญผู้ทดสอบที่หน้าจอแสดง เช่น Invite by email กรอกอีเมลบัญชีนักพัฒนาของผู้ทดสอบ เลือก Tester แล้วส่งคำเชิญ
3. ให้ผู้ทดสอบยอมรับคำเชิญ LINE Developers ตามลิงก์ที่ได้รับ และตรวจว่าบัญชีนักพัฒนาผูกกับ LINE ที่จะใช้ทดสอบแล้ว
4. ทดสอบเปิดแอพผ่าน LINE account นั้น

เมื่อพร้อมเปิดให้คนอื่นใช้

1. แก้ แม่แบบนโยบายข้อมูล ให้ระบุชื่อผู้ดูแล ช่องทางติดต่อ ระยะเวลาเก็บ และผู้ให้บริการที่ใช้จริง
2. ตรวจโดเมน HTTPS, Callback URL, สำรองฐานข้อมูล และทดลองสิทธิ์สมาชิก/ดูอย่างเดียว
3. กลับ channel ใน LINE Developers กดสถานะ Developing บริเวณด้านบน แล้วดำเนินการเผยแพร่เป็น Published ตามหน้าจอ
4. ให้บัญชีที่ไม่ได้เป็นผู้ทดสอบลองเข้าหน้าแอพตามปกติ จะได้กลุ่มส่วนตัวของตัวเอง ไม่เห็นรายจ่ายของปอ จนกว่าจะเข้าร่วมกลุ่มด้วยคำเชิญ

Published เปลี่ยนกลับเป็น Developing ไม่ได้
จึงควรทดสอบและตรวจข้อมูลบริการให้พร้อมก่อนกดยืนยัน การเผยแพร่ channel ไม่ได้ย้ายระบบไปโฮสของ LINE ข้อมูลแอพยังอยู่บนโฮสของปอ

ติดตั้งบนมือถือและใช้ออฟไลน์

1. เปิด URL แอพผ่าน Chrome บน Android หรือ Safari บน iPhone เข้าสู่ระบบ LINE และเลือกกลุ่มขณะมีอินเทอร์เน็ต
2. Android ใช้เมนูติดตั้งแอพ/เพิ่มลงหน้าจอหลักของ Chrome ส่วน iPhone ใช้แชร์ → เพิ่มไปยังหน้าจอโฮม
3. กดซิงก์และรอให้เตรียมออฟไลน์เสร็จ ก่อนลองปิดอินเทอร์เน็ต
4. เปิดจากไอคอนแอพ เพิ่มรายการทดสอบ แล้วตรวจว่ายังอยู่หลังปิดเปิดแอพ เมื่อกลับมาออนไลน์ให้รอซิงก์คิวหมด

การเข้า LINE ครั้งแรก รับคำเชิญ สร้าง/เปลี่ยนกลุ่ม และจัดการสมาชิกต้องใช้อินเทอร์เน็ต ก่อนเปลี่ยนกลุ่มหรือออกจากระบบต้องซิงก์รายการค้างให้หมด เพื่อไม่ให้ข้อมูลไปผิดกลุ่ม

รุ่นบัญชีนี้ใช้ LINE Login เมื่อเปิดออนไลน์ ข้อมูลที่เตรียมไว้บนเครื่องเปิดออฟไลน์ได้โดยไม่ถาม PIN เพิ่ม หากออกจากระบบแล้วต้องเข้า LINE ใหม่เมื่อมีเน็ต

ใช้แอพที่ติดตั้งหรือเบราว์เซอร์หลักเป็นช่องทางออฟไลน์ ไม่พึ่งการเปิดใน LIFF ภายใน LINE ซึ่งมีข้อจำกัด Service Worker และการดาวน์โหลดไฟล์

แก้ปัญหาที่พบบ่อย

รายการตรวจหลังติดตั้ง

• ปอล็อกอินด้วย LINE และเห็นชื่อบัญชีถูกคน
• ติดตั้งใหม่เริ่มด้วยรายการว่าง ไม่กระทบเว็บเดิม
• ผู้ใช้ที่ยังไม่รับเชิญไม่เห็นทริปของปอ
• สมาชิกที่รับคำเชิญเห็นข้อมูลกลุ่มเดียวกันหลังซิงก์
• สิทธิ์ดูอย่างเดียวแก้รายการไม่ได้
• เพิ่มรายจ่ายออฟไลน์แล้วกลับมาซิงก์ได้
• เก็บข้อมูลติดตั้งและข้อมูลเข้าฐานข้อมูลไว้เป็นส่วนตัว
• แก้แม่แบบ Privacy ก่อนเปิดให้ผู้ใช้ทั่วไป

เอกสารอ้างอิงทางการ

ตรวจข้อมูลวันที่ 1 พฤศจิกายน 2569 หน้าตาของ LINE Developers และ DirectAdmin อาจเปลี่ยนได้ คู่มือนี้ใช้ชื่อฟังก์ชันตามเอกสารขณะจัดทำ

• LINE Developers — เข้าระบบและสร้างบัญชีนักพัฒนา
• LINE Developers — Provider และ Channel
• LINE Developers — ฟิลด์ LINE Login, Developing และ Published
• LINE Developers — Callback URL และการเชื่อมเว็บแอพ
• LINE Developers — สิทธิ์และการเชิญผู้ทดสอบ
• Hostatom — สร้างฐานข้อมูลใน DirectAdmin
• Hostatom — เพิ่มสิทธิ์ผู้ใช้ฐานข้อมูล
• Hostatom — กำหนดสิทธิ์ไฟล์และโฟลเดอร์
• LINE Developers — ข้อจำกัดของ LIFF browser