Truy cập Bar Assistant
- Giao diện web:
https://<SERVER_IP> - REST API:
https://<SERVER_IP>/bar - Meilisearch:
https://<SERVER_IP>/search - Cảnh báo SSL của trình duyệt là điều bình thường vì chứng chỉ tự ký được sử dụng.
Thiết lập lần đầu
1. Mở URL sau trong trình duyệt của bạn: https://<SERVER_IP>
2. Nhấp vào Register.
3. Tạo tài khoản người dùng đầu tiên.
4. Sau khi đăng ký xong, hãy tắt đăng ký công khai bằng cách chỉnh sửa:
vim /root/barassistant/docker-compose.yml
Thay đổi ALLOW_REGISTRATION: "true" to ALLOW_REGISTRATION: "false".
Áp dụng thay đổi:
cd /root/barassistant
docker compose up -d
File và thư mục quan trọng
- Đường dẫn cài đặt:
/root/barassistant - Tệp Compose:
/root/barassistant/docker-compose.yml - Tệp môi trường:
/root/barassistant/.env - Cấu hình Nginx:
/etc/nginx/sites-available/barassistant - Chứng chỉ SSL:
/etc/nginx/ssl/barassistant.crt - Khóa SSL:
/etc/nginx/ssl/barassistant.key - Thư mục dữ liệu Bar:
/var/lib/docker/volumes/barassistant_bar_data/_data - Thư mục dữ liệu Meilisearch:
/var/lib/docker/volumes/barassistant_meilisearch_data/_data
Quản lý Bar Assistant
Xem các container đang chạy:
docker compose -f /root/barassistant/docker-compose.yml ps
Khởi động lại tất cả container:
docker compose -f /root/barassistant/docker-compose.yml restart
Theo dõi nhật ký ứng dụng:
docker compose -f /root/barassistant/docker-compose.yml logs -f
Dừng ứng dụng:
docker compose -f /root/barassistant/docker-compose.yml down
Khởi động ứng dụng:
docker compose -f /root/barassistant/docker-compose.yml up -d
Quản lý Nginx
Kiểm tra trạng thái:
systemctl status nginx
Khởi động lại Nginx:
systemctl restart nginx
Tải lại Nginx:
systemctl reload nginx
Xác thực cấu hình:
nginx -t
Kích hoạt SSL với một tên miền
1. Trỏ tên miền của bạn về IP máy chủ.
2. Sửa cấu hình Nginx và thay thế cả server_name _; với tên miền của bạn (server_name <yourdomain.com>) cho cả block HTTP (cổng 80) và HTTPS (cổng 443):
vim /etc/nginx/sites-available/barassistant
3. Cài đặt Certbot:
apt install -y certbot python3-certbot-nginx
4. Chạy lệnh sau để tạo chứng chỉ Let's Encrypt hợp lệ:
certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com
5. Thay thế các đường dẫn SSL trong cấu hình Nginx:
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. Tải lại Nginx để áp dụng các thay đổi:
systemctl reload nginx
7. Chỉnh sửa /root/barassistant/.env và thay thế IP máy chủ trong API_URL và MEILISEARCH_URL with your domain:
API_URL=https://yourdomain.com/bar
MEILISEARCH_URL=https://yourdomain.com/search
8. Tạo lại các dịch vụ:
cd /root/barassistant
docker compose up -d
9. Mở trình duyệt và truy cập: https://yourdomain.com
Kiểm tra reverse proxy
- Mở
https://yourdomain.com/bar. Bạn sẽ thấy: "This is your Bar Assistant instance." - Mở
https://yourdomain.com/bar/docs. Bạn sẽ thấy tài liệu Swagger API. - Mở
https://yourdomain.com/bar/api/server/version. Bạn sẽ nhận được phản hồi JSON chứa phiên bản máy chủ, không phải lỗi "Resource not found".
