Bar Assistant'a erişim
- Web arayüzü:
https://<SERVER_IP> - REST API:
https://<SERVER_IP>/bar - Meilisearch:
https://<SERVER_IP>/search - Kendinden imzalı bir sertifika kullanıldığından, tarayıcıda bir SSL uyarısı beklenir.
İlk kurulum
1. Aşağıdaki URL'yi tarayıcınızda açın: https://<SERVER_IP>
2. Register'a tıklayın.
3. İlk kullanıcı hesabını oluşturun.
4. Kayıt tamamlandıktan sonra şunu düzenleyerek herkese açık kaydı devre dışı bırakın:
vim /root/barassistant/docker-compose.yml
Değiştirin ALLOW_REGISTRATION: "true" to ALLOW_REGISTRATION: "false".
Değişikliği uygulayın:
cd /root/barassistant
docker compose up -d
Önemli Dosyalar ve Dizinler
- Kurulum yolu:
/root/barassistant - Compose Dosyası:
/root/barassistant/docker-compose.yml - Ortam Dosyası:
/root/barassistant/.env - Nginx yapılandırması:
/etc/nginx/sites-available/barassistant - SSL sertifikası:
/etc/nginx/ssl/barassistant.crt - SSL Anahtarı:
/etc/nginx/ssl/barassistant.key - Bar veri dizini:
/var/lib/docker/volumes/barassistant_bar_data/_data - Meilisearch veri dizini:
/var/lib/docker/volumes/barassistant_meilisearch_data/_data
Bar Assistant yönetimi
Çalışan kapsayıcıları görüntüleyin:
docker compose -f /root/barassistant/docker-compose.yml ps
Tüm kapsayıcıları yeniden başlatın:
docker compose -f /root/barassistant/docker-compose.yml restart
Uygulama günlüklerini takip edin:
docker compose -f /root/barassistant/docker-compose.yml logs -f
Uygulamayı durdurun:
docker compose -f /root/barassistant/docker-compose.yml down
Uygulamayı başlatın:
docker compose -f /root/barassistant/docker-compose.yml up -d
Nginx Yönetimi
Durumu kontrol edin:
systemctl status nginx
Nginx'i yeniden başlatın:
systemctl restart nginx
Nginx'i yeniden yükleyin:
systemctl reload nginx
Yapılandırmayı doğrulayın:
nginx -t
Bir Alan Adı ile SSL Etkinleştirme
1. Alan adını sunucu IP'sine yönlendir.
2. Nginx config'i düzenle ve her ikisini de değiştir server_name _; alan adın ile (server_name <yourdomain.com>) hem HTTP (port 80) hem HTTPS (port 443) blokları için:
vim /etc/nginx/sites-available/barassistant
3. Certbot'u kur:
apt install -y certbot python3-certbot-nginx
4. Geçerli bir Let's Encrypt sertifikası oluşturmak için aşağıdaki komutu çalıştırın:
certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com
5. Nginx config'inde SSL yollarını değiştir:
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. Değişiklikleri uygulamak için Nginx'i yeniden yükleyin:
systemctl reload nginx
7. Düzenleyin /root/barassistant/.env ve şuradaki sunucu IP'sini değiştirin: API_URL ve MEILISEARCH_URL with your domain:
API_URL=https://yourdomain.com/bar
MEILISEARCH_URL=https://yourdomain.com/search
8. Servisleri yeniden oluşturun:
cd /root/barassistant
docker compose up -d
9. Tarayıcını aç ve şu adresi ziyaret et: https://yourdomain.com
Ters proxy'yi doğrulayın
- Açın
https://yourdomain.com/bar. Şunu görmelisiniz: "This is your Bar Assistant instance." - Açın
https://yourdomain.com/bar/docs. Swagger API belgelerini görmelisiniz. - Açın
https://yourdomain.com/bar/api/server/version. "Resource not found" hatası değil, sunucu sürümünü içeren bir JSON yanıtı almalısınız.
