Bar Assistant

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. Nginx 설정의 SSL 경로 교체:

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. "Resource not found" 오류가 아니라 서버 버전이 담긴 JSON 응답을 받아야 합니다.