디스코드 솔루션

CasaOS에 USB HDD 또는 SSD를 추가할 수 있나요?

A new CasaOS user asked whether a USB HDD or SSD could be added to the system and whether storage could also be used as an install target.

예: Linux에서 USB HDD와 SSD를 감지하고 마운트할 수 있다면 CasaOS에서 사용할 수 있습니다. 실제로 확인해야 할 사항은 파일 시스템, 안정적인 마운트 경로, 권한, 전원 공급, 그리고 각 Docker 앱에서 드라이브를 매핑하는 방식입니다.

Linux에서 디스크가 인식되는지 확인

lsblk -o NAME,SIZE,FSTYPE,LABEL,MOUNTPOINTS
sudo blkid

드라이브에 마운트 지점이 없다면 CasaOS 문제를 해결하기 전에 먼저 마운트해야 합니다.

CasaOS는 /DATA를 중심으로 스토리지를 구성합니다

현재 설치 프로그램은 CasaOS /DATA 마운트를 중심으로 이동식 미디어 처리를 구성합니다. /DATA 아래의 안정적인 경로는 데스크톱의 임시 마운트 위치보다 앱 바인드 마운트에서 재사용하기 쉽습니다.

용도에 맞는 파일 시스템 선택

파일 시스템 적합한 용도 절충점
ext4 항상 켜져 있는 Linux 서버 디스크 Windows에서 사용하기 어려움
NTFS Windows와 공유 Linux 권한 동작이 다름
exFAT 휴대용 파일 전송 디스크 앱 데이터베이스에는 적합하지 않음

각 앱에 드라이브 매핑

호스트에서 보이는 디스크가 모든 컨테이너 내부에서도 자동으로 보이는 것은 아닙니다. Docker에서는 명시적인 호스트 경로 마운트가 필요합니다.

USB 스토리지는 신중하게 사용

  • 3.5인치 HDD는 전용 케이스에서 충분한 전원을 공급하세요.
  • 데이터베이스에는 헐거운 케이블을 사용하지 마세요.
  • 쓰기 작업 중에는 마운트된 디스크를 분리하지 마세요.
  • 중요한 경로에는 UUID 기반의 영구 마운트를 사용하세요.
  • 백업을 유지하세요. 두 번째 디스크가 자동으로 백업이 되는 것은 아닙니다.

CasaOS 드라이브 관리에서 스토리지 모델을 확인할 수 있습니다. 셀프 호스팅 앱 카탈로그에서는 명시적인 데이터 경로가 필요한 앱을 확인할 수 있습니다.

USB 스토리지로 부족해진다면 ZimaBoard 2에서 네이티브 SATA 연결을 사용할 수 있습니다.

재부팅 후에도 마운트 유지

영구 데이터 디스크에는 /dev/sdb1과 같은 장치 이름에 의존하지 말고 파일 시스템 UUID와 같은 안정적인 식별자를 사용하세요. 장치 이름은 바뀔 수 있습니다. blkid로 UUID를 확인하고 사용 중인 Linux 배포판에 맞게 영구 마운트를 구성하세요.

미디어 디스크와 애플리케이션 데이터베이스 분리

USB HDD는 대용량 미디어 파일, 백업 또는 아카이브에 대체로 적합합니다. 데이터베이스와 자주 기록되는 앱 상태 데이터는 케이블 분리, USB 브리지 재설정, 과도한 디스크 절전의 영향을 더 크게 받습니다. /DATA/AppData는 안정적인 내부 스토리지에 두고 USB는 대용량 미디어에 사용하는 구성이 더 안전한 경우가 많습니다.

마운트 후 소유권 확인

stat -c '%u:%g %a %n' /DATA/YourDrive

컨테이너가 특정 PUID/PGID로 실행된다면 마운트된 폴더를 해당 사용자 및 그룹이 쓰기 가능하도록 설정하세요. NTFS/exFAT와 같은 파일 시스템은 일반적인 파일별 Unix 소유권 대신 마운트 옵션을 사용할 수 있으므로 ext4와는 다르게 문제를 해결해야 합니다.

전원 및 USB 브리지 동작 확인

무작위로 발생하는 애플리케이션 오류는 스토리지 전송 문제일 수 있습니다. 회전식 드라이브에는 충분한 전원을 공급하는 케이스를 사용하세요. 부하가 걸릴 때 디스크가 사라진다면 커널 로그를 확인하세요.

dmesg -T | tail -n 100

USB 재설정이나 I/O 오류가 반복된다면 CasaOS 권한 문제가 아니라 케이블, 브리지, 전원 또는 드라이브 상태 문제일 가능성이 높습니다.

데이터 드라이브 안전하게 제거

해당 경로를 사용하는 컨테이너를 중지하고 파일 시스템을 마운트 해제한 다음 분리하세요. Docker가 열린 파일을 사용 중인 상태에서 드라이브를 뽑으면 데이터베이스가 손상되거나 애플리케이션이 일관되지 않은 상태가 될 수 있습니다.

FAQ

CasaOS를 SSD에서 실행할 수 있나요?

CasaOS는 Linux 위에서 실행됩니다. 지원되는 Linux 시스템이 해당 SSD에 설치되어 있다면 CasaOS도 그곳에 설치할 수 있습니다.

Jellyfin에서 USB HDD를 사용할 수 있나요?

예. 마운트 경로를 안정적으로 유지하고 해당 폴더를 Jellyfin 컨테이너에 바인드 마운트하세요.