Доступ до Bar Assistant
- Вебінтерфейс:
https://<SERVER_IP> - REST API:
https://<SERVER_IP>/bar - Meilisearch:
https://<SERVER_IP>/search - Попередження SSL у браузері є очікуваним, оскільки використовується самопідписаний сертифікат.
Початкове налаштування
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-адресу сервера.
2. Відредагуйте конфіг Nginx і замініть обидва server_name _; з вашим доменом (server_name <yourdomain.com>) для блоків HTTP (порт 80) і HTTPS (порт 443):
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 у конфігу 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. Перезавантажте 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. Відкрийте браузер і перейдіть за адресою: 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".
