การเข้าถึง Bar Assistant
- อินเทอร์เฟซเว็บ:
https://<SERVER_IP> - REST API:
https://<SERVER_IP>/bar - Meilisearch:
https://<SERVER_IP>/search - คำเตือน SSL ในเบราว์เซอร์เป็นเรื่องปกติ เพราะมีการใช้ใบรับรองแบบ self-signed
การตั้งค่าครั้งแรก
1. เปิด URL ต่อไปนี้ในเบราว์เซอร์ของคุณ: https://<SERVER_IP>
2. คลิก Register
3. สร้างบัญชีผู้ใช้บัญชีแรก
4. เมื่อลงทะเบียนเสร็จแล้ว ให้ปิดการลงทะเบียนสาธารณะโดยแก้ไข:
vim /root/barassistant/docker-compose.yml
เปลี่ยน ALLOW_REGISTRATION: "true" to ALLOW_REGISTRATION: "false".
นำการเปลี่ยนแปลงไปใช้:
cd /root/barassistant
docker compose up -d
ไฟล์และไดเรกทอรีที่สำคัญ
- เส้นทางการติดตั้ง:
/root/barassistant - ไฟล์ Compose:
/root/barassistant/docker-compose.yml - ไฟล์สภาพแวดล้อม:
/root/barassistant/.env - การตั้งค่า Nginx:
/etc/nginx/sites-available/barassistant - ใบรับรอง SSL:
/etc/nginx/ssl/barassistant.crt - คีย์ SSL:
/etc/nginx/ssl/barassistant.key - ไดเรกทอรีข้อมูล Bar:
/var/lib/docker/volumes/barassistant_bar_data/_data - ไดเรกทอรีข้อมูล Meilisearch:
/var/lib/docker/volumes/barassistant_meilisearch_data/_data
การจัดการ Bar Assistant
ดูคอนเทนเนอร์ที่กำลังทำงาน:
docker compose -f /root/barassistant/docker-compose.yml ps
รีสตาร์ตคอนเทนเนอร์ทั้งหมด:
docker compose -f /root/barassistant/docker-compose.yml restart
ติดตามล็อกของแอปพลิเคชัน:
docker compose -f /root/barassistant/docker-compose.yml logs -f
หยุดแอปพลิเคชัน:
docker compose -f /root/barassistant/docker-compose.yml down
เริ่มแอปพลิเคชัน:
docker compose -f /root/barassistant/docker-compose.yml up -d
การจัดการ Nginx
ตรวจสอบสถานะ:
systemctl status nginx
รีสตาร์ต Nginx:
systemctl restart nginx
รีโหลด Nginx:
systemctl reload nginx
ตรวจสอบความถูกต้องของการกำหนดค่า:
nginx -t
เปิดใช้งาน SSL กับโดเมน
1. ชี้โดเมนของคุณไปยัง IP ของ server
2. แก้ไข config ของ Nginx และเปลี่ยนทั้งคู่ server_name _; กับโดเมนของคุณ (server_name <yourdomain.com>) สำหรับทั้ง HTTP (port 80) และ HTTPS (port 443) blocks:
vim /etc/nginx/sites-available/barassistant
3. ติดตั้ง Certbot:
apt install -y certbot python3-certbot-nginx
4. รันคำสั่งต่อไปนี้เพื่อสร้างใบรับรอง Let's Encrypt ที่ถูกต้อง:
certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com
5. แทนที่ SSL paths ใน Nginx config:
vim /etc/nginx/sites-available/barassistant
# Before:
# ssl_certificate /etc/nginx/ssl/barassistant.crt;
# ssl_certificate_key /etc/nginx/ssl/barassistant.key;
# After:
# ssl_certificate /etc/letsencrypt/live/yourdomain.com/fullchain.pem;
# ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;
6. โหลด Nginx ใหม่เพื่อใช้การเปลี่ยนแปลง:
systemctl reload nginx
7. แก้ไข /root/barassistant/.env และแทนที่ IP ของเซิร์ฟเวอร์ใน API_URL และ MEILISEARCH_URL with your domain:
API_URL=https://yourdomain.com/bar
MEILISEARCH_URL=https://yourdomain.com/search
8. สร้างบริการใหม่:
cd /root/barassistant
docker compose up -d
9. เปิด browser และไปที่: https://yourdomain.com
ตรวจสอบรีเวิร์สพรอกซี
- เปิด
https://yourdomain.com/bar. คุณควรเห็น: "This is your Bar Assistant instance." - เปิด
https://yourdomain.com/bar/docs. คุณควรเห็นเอกสาร Swagger API - เปิด
https://yourdomain.com/bar/api/server/version. คุณควรได้รับการตอบกลับ JSON ที่มีเวอร์ชันของเซิร์ฟเวอร์ ไม่ใช่ข้อผิดพลาด "Resource not found"
