SetFN
SetFNDocs2026년 10월 27일

문제 해결 가이드

SetFN을 설치하거나 사용할 때 자주 겪는 증상별로 확인할 항목과 해결 방법을 정리합니다.

설치 관련

Q: 설치 중 포트 충돌 오류가 발생하나요?

SetFN이 사용할 포트를 다른 프로그램이 이미 사용 중일 때 발생합니다.

  1. 해당 포트를 사용 중인 프로그램을 확인합니다
  2. 충돌하는 프로그램을 종료하거나, SetFN의 포트 설정을 변경합니다
  3. 설치를 다시 진행합니다

Q: 설치는 완료되었는데 서비스가 시작되지 않나요?

자동 시작(systemd)을 설정했다면 서비스 상태와 로그를 확인합니다.

  1. systemctl status setfn-spacebuilder로 실행 상태를 확인합니다
  2. 중지되어 있다면 sudo systemctl start setfn-spacebuilder로 시작합니다
  3. 시작되지 않으면 journalctl -u setfn-spacebuilder -n 100 --no-pager로 오류 메시지를 확인합니다
  4. 서비스 파일의 User와 ExecStart 값이 실제 사용자 이름과 실행 파일 경로와 같은지 확인합니다

자동 시작을 설정하지 않았다면 터미널에서 실행 파일을 다시 실행합니다. 자세한 내용은 Linux에 설치하기를 참고하세요.

Q: Docker로 설치할 수 있나요?

공식 Docker 이미지는 아직 제공되지 않습니다. 임의의 이미지 이름으로 docker pull이나 docker run을 실행하지 마세요.

  1. 현재는 Linux에 설치하기의 방법으로 설치합니다
  2. Docker 지원 상태는 Docker로 설치하기에서 확인합니다

접속 관련

Q: 브라우저에서 SetFN에 접속할 수 없나요?

네트워크 설정이나 서비스 상태를 확인합니다.

  1. SetFN 서비스가 실행 중인지 확인합니다
  2. 접속 주소(IP, 포트)가 올바른지 확인합니다
  3. 방화벽에서 해당 포트가 허용되어 있는지 확인합니다
  4. 같은 네트워크에 있는 다른 기기에서 접속을 시도합니다

Q: 로그인이 되지 않나요?

  1. 아이디와 비밀번호가 정확한지 확인합니다
  2. Caps Lock이 켜져 있지 않은지 확인합니다
  3. 비밀번호를 잊었다면 로그인 화면에서 비밀번호를 재설정합니다
  4. 관리자가 계정을 비활성화했을 수 있으므로 관리자에게 문의합니다

Q: 외부에서 접속이 안 되나요?

외부 접속 설정을 확인합니다.

  1. 같은 네트워크에서 내부망 주소로 접속되는지 먼저 확인합니다
  2. Cloudflare Tunnel 같은 외부 접속 연결이 실행 중인지 확인합니다
  3. 도메인이 올바르게 연결되어 있는지 확인합니다
  4. 차단 관리의 활성 차단 목록에서 접속하려는 IP가 차단되어 있지 않은지 확인합니다

Q: 특정 사용자만 접속이 안 되나요?

  1. 로그인 실패가 반복되면 IP가 자동으로 차단될 수 있습니다. 차단 관리의 활성 차단 목록에서 해당 사용자의 IP를 확인합니다
  2. 사용자 계정의 권한과 상태가 정상인지 확인합니다

Q: 관리자도 로그인할 수 없나요?

관리자 계정까지 차단되었거나 비밀번호를 몰라 관리자 페이지에 들어갈 수 없다면, 스페이스빌더가 설치된 컴퓨터의 터미널에서 명령어로 복구합니다.

  1. 로그인 차단은 unblock 명령으로 풉니다
  2. 관리자 비밀번호는 user password 명령으로 바꿉니다
  3. IP 접근 제한 때문에 관리자 페이지에 접속할 수 없다면 ip 명령으로 허용 목록을 고칩니다

자세한 방법은 명령어로 서버 관리하기를 참고하세요.

파일 관련

Q: 파일 업로드가 실패하나요?

  1. 업로드 대상 폴더에 쓰기 권한이 있는지 확인합니다
  2. 서버의 남은 디스크 용량을 확인합니다
  3. 파일 크기가 설정된 제한을 초과하지 않는지 확인합니다
  4. 네트워크 연결이 안정적인지 확인합니다

Q: 파일 다운로드 속도가 느린가요?

  1. 서버와 클라이언트가 같은 내부망에 있는지 확인합니다
  2. 네트워크 대역폭이 충분한지 확인합니다
  3. 서버의 CPU, 메모리 사용률이 과도하게 높지 않은지 확인합니다
  4. 동시 접속자가 많은 경우 서버 사양 업그레이드를 고려합니다

Q: 파일이 목록에 보이지 않나요?

  1. 현재 사용자의 레벨과 팀이 해당 폴더에 접근 가능한지 확인합니다
  2. 폴더 필터가 적용되어 파일이 숨겨져 있지 않은지 확인합니다
  3. 브라우저 캐시를 지우고 새로고침합니다

성능 관련

Q: SetFN 전체 동작이 느려졌나요?

서버 자원이 부족할 수 있습니다.

  1. 서버의 CPU, 메모리 사용률을 확인합니다
  2. 디스크 여유 공간을 확인합니다 (남은 공간이 10% 미만이면 성능이 떨어질 수 있습니다)
  3. 시스템 관리 > 백그라운드 서비스에서 AI, 인덱싱 같은 작업이 자원을 과도하게 쓰고 있지 않은지 확인합니다
  4. 서버를 다시 시작합니다

Q: 검색이 느리거나 결과가 나오지 않나요?

  1. 검색 인덱스가 정상적으로 구축되어 있는지 확인합니다
  2. 파일 수가 매우 많은 경우 검색 범위를 특정 폴더로 좁혀서 시도합니다
  3. 서버 재시작 후 인덱스가 다시 구축될 때까지 시간이 필요할 수 있습니다

기타

Q: 브라우저 호환 문제가 있나요?

최신 버전의 Chrome, Edge, Firefox, Safari를 사용하세요. Internet Explorer는 지원하지 않습니다.

화면이 정상적으로 표시되지 않으면 브라우저 캐시와 쿠키를 삭제한 뒤 다시 시도합니다.

Q: 위 방법으로 해결되지 않나요?

  1. 서버 로그에서 오류 메시지를 확인합니다. 자동 시작으로 실행 중이라면 journalctl -u setfn-spacebuilder -n 100 --no-pager를 사용합니다
  2. 시스템 관리 > 디바이스 정보에서 운영체제와 디스크 상태를 확인합니다
  3. 오류 메시지와 환경 정보를 정리해 SetFN 기술 지원팀에 문의합니다

관련 문서