Hozzáférés a Bar Assistanthoz
- Webes felület:
https://<SERVER_IP> - REST API:
https://<SERVER_IP>/bar - Meilisearch:
https://<SERVER_IP>/search - A böngésző SSL-figyelmeztetése várható, mivel önaláírt tanúsítványt használunk.
Első beállítás
1. Nyissa meg a következő URL-t a böngészőjében: https://<SERVER_IP>
2. Kattintson a Register gombra.
3. Hozza létre az első felhasználói fiókot.
4. A regisztráció befejezése után tiltsa le a nyilvános regisztrációt a következő szerkesztésével:
vim /root/barassistant/docker-compose.yml
Módosítsa ALLOW_REGISTRATION: "true" to ALLOW_REGISTRATION: "false".
Alkalmazd a módosítást:
cd /root/barassistant
docker compose up -d
Fontos fájlok és könyvtárak
- Telepítési útvonal:
/root/barassistant - Compose fájl:
/root/barassistant/docker-compose.yml - Környezeti fájl:
/root/barassistant/.env - Nginx konfiguráció:
/etc/nginx/sites-available/barassistant - SSL-tanúsítvány:
/etc/nginx/ssl/barassistant.crt - SSL-kulcs:
/etc/nginx/ssl/barassistant.key - Bar adatkönyvtár:
/var/lib/docker/volumes/barassistant_bar_data/_data - Meilisearch adatkönyvtár:
/var/lib/docker/volumes/barassistant_meilisearch_data/_data
A Bar Assistant kezelése
Futó konténerek megtekintése:
docker compose -f /root/barassistant/docker-compose.yml ps
Az összes konténer újraindítása:
docker compose -f /root/barassistant/docker-compose.yml restart
Alkalmazásnaplók követése:
docker compose -f /root/barassistant/docker-compose.yml logs -f
Az alkalmazás leállítása:
docker compose -f /root/barassistant/docker-compose.yml down
Az alkalmazás indítása:
docker compose -f /root/barassistant/docker-compose.yml up -d
Nginx kezelése
Állapot ellenőrzése:
systemctl status nginx
Nginx újraindítása:
systemctl restart nginx
Nginx újratöltése:
systemctl reload nginx
A konfiguráció ellenőrzése:
nginx -t
SSL engedélyezése domainnel
1. Irányítsa a domainjét a szerver IP-jére.
2. Szerkessze az Nginx konfigurációt, és cserélje le mindkettőt server_name _; a domainjével (server_name <yourdomain.com>) mind a HTTP (80-as port), mind a HTTPS (443-as port) blokkokhoz:
vim /etc/nginx/sites-available/barassistant
3. Telepítse a Certbotot:
apt install -y certbot python3-certbot-nginx
4. Futtassa a következő parancsot egy érvényes Let's Encrypt tanúsítvány létrehozásához:
certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com
5. Cserélje le az SSL útvonalakat az Nginx konfigurációban:
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öltse újra a Nginx-et a változások érvényesítéséhez:
systemctl reload nginx
7. Szerkeszd a következőt: /root/barassistant/.env és cseréld le a szerver IP-jét ebben: API_URL és MEILISEARCH_URL with your domain:
API_URL=https://yourdomain.com/bar
MEILISEARCH_URL=https://yourdomain.com/search
8. Hozza létre újra a szolgáltatásokat:
cd /root/barassistant
docker compose up -d
9. Nyissa meg a böngészőjét és látogassa meg: https://yourdomain.com
A fordított proxy ellenőrzése
- Nyissa meg
https://yourdomain.com/bar. Ezt kell látnia: "This is your Bar Assistant instance." - Nyissa meg
https://yourdomain.com/bar/docs. A Swagger API dokumentációját kell látnia. - Nyissa meg
https://yourdomain.com/bar/api/server/version. A szerver verzióját tartalmazó JSON-választ kell kapnia, nem "Resource not found" hibát.
