Dostęp do Bar Assistant
- Interfejs webowy:
https://<SERVER_IP> - REST API:
https://<SERVER_IP>/bar - Meilisearch:
https://<SERVER_IP>/search - Ostrzeżenie SSL w przeglądarce jest normalne, ponieważ używany jest certyfikat samopodpisany.
Pierwsza konfiguracja
1. Otwórz w przeglądarce następujący adres URL: https://<SERVER_IP>
2. Kliknij Register.
3. Utwórz pierwsze konto użytkownika.
4. Po zakończeniu rejestracji wyłącz rejestrację publiczną, edytując:
vim /root/barassistant/docker-compose.yml
Zmień ALLOW_REGISTRATION: "true" to ALLOW_REGISTRATION: "false".
Zastosuj zmianę:
cd /root/barassistant
docker compose up -d
Ważne pliki i katalogi
- Ścieżka instalacji:
/root/barassistant - Plik Compose:
/root/barassistant/docker-compose.yml - Plik środowiskowy:
/root/barassistant/.env - Konfiguracja Nginx:
/etc/nginx/sites-available/barassistant - Certyfikat SSL:
/etc/nginx/ssl/barassistant.crt - Klucz SSL:
/etc/nginx/ssl/barassistant.key - Katalog danych Bar:
/var/lib/docker/volumes/barassistant_bar_data/_data - Katalog danych Meilisearch:
/var/lib/docker/volumes/barassistant_meilisearch_data/_data
Zarządzanie Bar Assistant
Wyświetl działające kontenery:
docker compose -f /root/barassistant/docker-compose.yml ps
Uruchom ponownie wszystkie kontenery:
docker compose -f /root/barassistant/docker-compose.yml restart
Śledź logi aplikacji:
docker compose -f /root/barassistant/docker-compose.yml logs -f
Zatrzymaj aplikację:
docker compose -f /root/barassistant/docker-compose.yml down
Uruchom aplikację:
docker compose -f /root/barassistant/docker-compose.yml up -d
Zarządzanie Nginx
Sprawdź stan:
systemctl status nginx
Uruchom ponownie Nginx:
systemctl restart nginx
Przeładuj Nginx:
systemctl reload nginx
Zweryfikuj konfigurację:
nginx -t
Włączanie SSL z domeną
1. Skieruj swoją domenę na IP serwera.
2. Edytuj konfigurację Nginx i zamień oba server_name _; z Twoją domeną (server_name <yourdomain.com>) dla bloków HTTP (port 80) i HTTPS (port 443):
vim /etc/nginx/sites-available/barassistant
3. Zainstaluj Certbot:
apt install -y certbot python3-certbot-nginx
4. Uruchom następujące polecenie, aby wygenerować ważny certyfikat Let's Encrypt:
certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com
5. Zamień ścieżki SSL w konfiguracji 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. Przeładuj Nginx, aby zastosować zmiany:
systemctl reload nginx
7. Edytuj /root/barassistant/.env i zastąp IP serwera w API_URL oraz MEILISEARCH_URL with your domain:
API_URL=https://yourdomain.com/bar
MEILISEARCH_URL=https://yourdomain.com/search
8. Utwórz ponownie usługi:
cd /root/barassistant
docker compose up -d
9. Otwórz przeglądarkę i odwiedź: https://yourdomain.com
Weryfikacja reverse proxy
- Otwórz
https://yourdomain.com/bar. Powinieneś zobaczyć: "This is your Bar Assistant instance." - Otwórz
https://yourdomain.com/bar/docs. Powinieneś zobaczyć dokumentację API Swagger. - Otwórz
https://yourdomain.com/bar/api/server/version. Powinieneś otrzymać odpowiedź JSON z wersją serwera, a nie błąd "Resource not found".
