Question 1

FileBrowser에서 로그인 화면을 비활성화하고 인증을 건너뛰는 방법은?

Accepted Answer

noauth 인증 방법을 사용하세요. `filebrowser config set --auth.method=noauth` 명령을 실행하거나 Docker에서 환경 변수 `FB_NOAUTH=noauth`를 설정하세요. ID가 1인 사용자가 기본값으로 사용됩니다.

Question 2

'import.meta.resolve not supported' 오류와 File Browser 로그인 페이지에서 파란색 점 3개가 멈춰 있는 문제를 해결하려면 어떻게 해야 하나요? nginx 리버스 프록시 뒤에 배포된 경우도 포함해서 알려주세요.

Accepted Answer

임시 해결 방법: File Browser 접속 URL에 `/login`을 수동으로 추가하세요. nginx 리버스 프록시 설정의 경우, `https://<your-filebrowser-domain>/login`으로 직접 이동하면 로그인 페이지를 즉시 로드할 수 있습니다. 영구적인 해결 방법: 이 프론트엔드 호환성 버그에 대한 공식 패치가 포함된 v2.63.5 이상으로 File Browser를 v2.63.4에서 업그레이드하세요. 오래된 브라우저(예: Firefox 50.0.3)를 사용하는 경우, 전체 기능 지원을 위해 최신 안정 버전 브라우저로도 업그레이드하세요.

Question 3

/login은 정상 작동하는 반면 루트 URL에서 File Browser 무한 로딩 스피너가 발생하는 문제를 해결하는 방법은?

Accepted Answer

이것은 영향을 받는 latest Docker 이미지에서 발생하는 클라이언트 측 라우팅 버그입니다. /를 열면 Uncaught TypeError: e.params.catchAll is not iterable 오류와 함께 실패할 수 있지만, /login은 정상적으로 로드됩니다. 해결 방법: https://your-host:8080/login으로 직접 이동하세요. 로그인 후에는 File Browser가 정상적으로 작동하며 인증된 세션을 /files로 리디렉션합니다. 영구적인 해결을 위해서는 docker compose pull && docker compose up -d를 실행하여 PR #5948이 포함된 이미지로 업그레이드하거나, 수정된 빌드가 게시된 후 docker pull filebrowser/filebrowser:latest를 사용하세요. 즉시 업그레이드할 수 없는 경우, latest 대신 이전 안정 버전 이미지로 컨테이너를 고정하세요.

Question 4

모바일 보기에서 정렬을 위해 파일 크기와 수정한 날짜 열을 표시하는 방법은 무엇인가요?

Accepted Answer

File Browser는 736px보다 좁은 화면에서 'size'와 'modified' 열을 숨깁니다. 이를 표시하려면 사용자 정의 CSS(예: 테마의 mobile.css)에 다음을 추가하세요:

@media (max-width: 736px) {
  #listing.list .item .size,
  #listing.list .item .modified {
    display: table-cell !important;
    width: auto; /* adjust width if needed */
  }
}

이 코드는 기본 display: none을 재정의합니다. 저장하면 모바일에서 열이 나타나며, 헤더를 탭하여 정렬할 수 있습니다. 여전히 헤더가 보이지 않는다면 요소를 검사하여 정확한 클래스(예: .sort-name, .sort-modified)를 찾아 규칙에 추가하세요. 참고: 완전한 내장 토글 기능은 아직 제공되지 않으며, 공식 저장소에서 업데이트를 확인하세요.

Question 5

config set 또는 config cat 명령어 실행 시 FileBrowser "Error: timeout" 오류를 해결하는 방법

Accepted Answer

"Error: timeout" 오류는 다른 FileBrowser 서버 프로세스가 이미 실행 중이어서 데이터베이스 파일(filebrowser.db)이 잠겼다는 의미입니다. FileBrowser의 내장 BoltDB 데이터베이스는 한 번에 하나의 프로세스만 접근할 수 있으므로, 서버가 실행 중인 동안에는 모든 CLI 명령(예: filebrowser config set port 8888 또는 filebrowser config cat)이 실패합니다. 해결 방법: 먼저 실행 중인 FileBrowser 인스턴스를 중지한 다음 config 명령을 실행하고, 그 후 서버를 다시 시작하세요. Docker/Podman의 경우: config 명령을 실행하기 전에 컨테이너를 중지(docker stop / podman stop )하거나, 메인 컨테이너가 중지된 상태에서 동일한 데이터베이스 볼륨을 마운트한 별도의 일회용 컨테이너에서 명령을 실행하세요. 또는 CLI 명령 대신 settings.json 설정 파일이나 환경 변수를 통해 FileBrowser를 구성하면 잠금 문제를 완전히 피할 수 있습니다.

filebrowser

주요 기능

할 수 없는 것

사용 사례

태그

시작하기

유사한 프로젝트