Linux에서 NVMe SSD가 감지되지만 잘못된 ZimaCube 베이에 표시되거나 스토리지 UI에 올바르게 표시되지 않는다면, 문제는 SSD 자체가 아니라 ZimaOS 베이 매핑 메타데이터에 있을 수 있습니다. 먼저 PCIe 감지를 확인한 다음, IceWhale이 해당 하드웨어에 대해 문서화했거나 권장한 경우에만 local-storage.conf 재설정을 사용하세요.
원문 스레드에는 중요한 모델 적용 범위가 명시되어 있습니다. 삭제 NVME=... 줄을 입력하고 다시 시작하면 zimaos-local-storage.service 원래 ZimaCube 사례에서는 문제가 해결되었지만, IceWhale은 이후 이 방법이 ZimaCube에 적용되며 일반 Intel NUC에서는 동일한 방식으로 작동하지 않는다고 밝혔습니다.
1단계: PCIe 계층에서 NVMe가 존재하는지 확인
실행:
lspci | grep -i -E 'non-volatile|nvme'
lsblk -o NAME,SIZE,MODEL,SERIALSSD가 두 하드웨어 보기 중 어느 곳에도 나타나지 않는다면 문제는 단순히 ZimaOS 베이 그래픽에만 있는 것이 아닙니다.
스토리지 문제 해결 가이드는 웹 UI에서 잘못 표시된 경우가 아니라 하드웨어 계층에서 NVMe가 누락된 경우에 유용합니다.
2단계: ZimaCube 베이 매핑 확인
문제가 발생한 ZimaCube에서 IceWhale은 다음 정보를 요청했습니다.
sudo -i
cat /etc/casaos/local-storage.conf구성에는 명시적인 항목이 포함되어 있었습니다. NVME=... SSD 위치와 더 이상 일치하지 않는 매핑입니다.
3단계: 해당 모델에서만 재설정을 사용하세요
IceWhale은 ZimaCube 사용자에게 다음 항목을 삭제하라고 안내했습니다. NVME=... 줄을 입력한 다음 다음을 실행하세요:
systemctl restart zimaos-local-storage.service원래 사용자는 이 방법으로 UI 문제가 해결되었다고 확인했습니다.
SSD를 옮기면 문제가 다시 발생할 수 있는 이유
이후 한 사용자가 SSD를 다른 베이로 옮기자 잘못된 매핑이 다시 나타났습니다. 캐시된 사용자 지정 베이 맵이 새로운 물리적 슬롯과 더 이상 일치하지 않는다면 이는 자연스러운 결과입니다.
일반 하드웨어에는 이 방법을 무작정 적용하지 마세요
Intel NUC에서 한 사용자가 동일한 수정 작업을 시도했지만 NVMe 항목이 다시 나타났을 뿐 UI 문제는 해결되지 않았습니다. IceWhale은 이 방법이 ZimaCube에 적용되며, 다른 모델의 사용자 지정 드라이브 베이 동작은 아직 개발 중이라고 명시했습니다.
현재 스토리지 UI를 먼저 확인하세요
현재 ZimaOS 스토리지 설정 가이드에는 현재 디스크 감지 및 스토리지 설정 방법이 나와 있습니다. SSD가 일반 스토리지로 표시되지만 베이 그래픽이 잘못된 경우 표시 또는 매핑 문제로 간주하세요.
루트 권한을 신중하게 사용하세요
원본 스레드에서는 다음 파일을 편집하는 것도 명확히 설명했습니다. /etc/casaos/local-storage.conf 루트 권한이 필요합니다. 일반 사용자 세션에서 파일에 강제로 쓰지 마세요.
물리적 감지와 베이 표시를 구분하세요
ZimaCube의 스토리지 페이지는 감지된 NVMe 컨트롤러를 물리적 슬롯 레이블에 매핑하려고 합니다. 이 추가 표시 계층 때문에 Linux에서는 디스크가 완전히 정상적으로 표시되더라도 잘못된 문자 아래에 표시되거나 이상한 베이 그래픽으로 나타날 수 있습니다.
구성을 편집하기 전에 SSD 모델, PCI 주소 및 물리적 슬롯을 기록하세요. 이렇게 하면 변경 전후의 매핑을 비교할 수 있고 잘못된 장치를 “수정”할 가능성을 줄일 수 있습니다.
편집하기 전에 local-storage.conf 백업
IceWhale 지원팀에서 파일을 수정하라고 안내한 경우 먼저 복사본을 만드세요.
sudo -i
cp /etc/casaos/local-storage.conf /etc/casaos/local-storage.conf.bak그런 다음 요청된 변경만 수행하세요. 파일에는 NVMe 매핑 외에도 여러 설정이 있으므로 관련 없는 스토리지 설정을 다시 작성하지 마세요.
먼저 전체 서버가 아니라 스토리지 서비스를 다시 시작하세요
검증된 ZimaCube 해결 방법은 다음 서비스를 다시 시작하는 것이었습니다. zimaos-local-storage.service 오래된 매핑을 삭제한 후 수행하세요. 이는 NAS 전체를 재부팅하는 것보다 범위가 좁은 테스트이며, 로컬 스토리지 서비스가 베이 맵을 올바르게 다시 생성했는지 더 쉽게 확인할 수 있습니다.
매핑이 계속 되돌아오는 경우
매번 재시작할 때마다 오래된 매핑이 다시 나타나면 파일을 반복해서 수정하지 마세요. 생성된 구성을 캡처하고, lspci, lsblk물리적 슬롯과 현재 ZimaOS 버전을 지원팀에 전달하세요. 매핑이 계속 재생성된다면 다른 구성 요소가 매핑을 기록하고 있다는 뜻입니다.
스토리지 문제 해결 가이드는 보다 안전한 에스컬레이션 절차를 제공합니다.
FAQ
NVME 줄을 삭제하면 SSD가 지워지나요?
원본 해결 방법은 디스크 내용이 아니라 베이 매핑 구성을 변경했습니다. 그래도 시스템 수준의 스토리지 변경을 하기 전에 중요한 데이터를 백업하세요.
SSD가 lspci에는 표시되지만 UI에는 올바르게 표시되지 않는 이유는 무엇인가요?
이는 기본적인 PCIe 감지보다는 ZimaOS 스토리지 메타데이터 또는 베이 매핑 문제임을 나타냅니다.
이 해결 방법을 Intel NUC에서 사용할 수 있나요?
일반적인 규칙은 아닙니다. IceWhale은 이 해결 방법이 ZimaCube에 적용된다고 명시했습니다.
SSD가 lspci에 표시되지 않으면 어떻게 해야 하나요?
그런 다음 하드웨어 슬롯, SSD, BIOS/PCIe 설정 및 물리적 연결을 먼저 점검하세요.
