Question 1

Koel 스캔이 데이터베이스에서 삭제된 곡을 제거하지 않는 문제를 어떻게 해결하나요?

Accepted Answer

이 문제는 필수 Laravel 환경 변수(특히 `QUEUE_CONNECTION`)가 누락되어 스캔 후 이벤트 리스너가 실행되지 않을 때 발생합니다. `.env` 파일을 `.env.example`과 비교하여 예제 파일 하단에 있는 Laravel 관련 변수들을 추가하세요. 별도의 큐 워커가 없는 표준 Koel/Docker 설정의 경우 `QUEUE_CONNECTION=sync`로 설정되어 있는지 확인하세요. 그런 다음 컨테이너를 재시작하고 다시 스캔하세요: ```bash docker restart docker exec -it php artisan koel:scan ``` 스캔이 완료되면 스토리지에서 파일이 삭제된 곡들은 `songs` 테이블에서 제거되고 웹 인터페이스에서도 사라집니다.

Question 2

Koel에 대용량 FLAC/오디오 파일을 업로드할 때 발생하는 'Server error' 오류 해결 방법 (50MB 제한)?

Accepted Answer

Koel의 기본 50MB 업로드 제한은 PHP의 `upload_max_filesize`와 `post_max_size` 설정에서 비롯됩니다. 이를 높이려면:

1. Koel 저장소 루트에 있는 `.htaccess.example` 파일을 `.htaccess`로 복사하세요 (아직 없는 경우).
2. 파일 하단의 값을 편집하여 `50M`을 원하는 제한 값으로 변경하세요. 예:
   ```
   php_value upload_max_filesize 800M
   php_value post_max_size 800M
   ```
3. 파일을 저장하세요 — Apache는 `.htaccess` 변경 사항을 즉시 적용하므로 재시작이 필요 없습니다.

참고: 공식 Koel Docker 이미지를 사용하는 경우, 번들로 포함된 `php.ini`에 이미 제한이 800M으로 설정되어 있으므로 `.htaccess`도 해당 값에 맞추세요. 또한 Cloudflare를 통해 프록시하는 경우, 무료 등급에서는 요청/응답 크기가 100MB로 제한되므로 이보다 큰 파일을 업로드할 때는 Cloudflare 프록시를 일시적으로 비활성화(DNS 전용 모드)하세요.

Koel

주요 기능

할 수 없는 것

사용 사례

상세 설명

문제 해결 & FAQ (2)

태그

시작하기

유사한 프로젝트