원래 문제 해결 가이드가 유용한 이유는 CasaOS UI 아래 계층부터 시작하기 때문입니다. 드라이브, NIC, PCIe 카드 또는 USB 장치가 이상하게 동작할 때 가장 먼저 확인할 것은 기본 Linux 시스템이 하드웨어를 전혀 인식하는지 여부입니다.
2026년에 중요한 경계는 운영 체제 아키텍처입니다. 2023년 가이드는 일반적인 Debian/Ubuntu 스타일 Linux 설치에서 실행되는 CasaOS를 전제로 합니다. 현재 ZimaOS는 Buildroot 기반의 별도 어플라이언스 OS이며 시스템 대부분이 읽기 전용입니다. 읽기 전용 진단 명령은 여전히 유용하지만, 일반적인 Debian 가이드의 패키지 설치 및 호스트 수정 지침을 ZimaOS에 그대로 적용해서는 안 됩니다.
BIOS 및 보드 정보에는 dmidecode를 사용하세요
dmidecode 다음과 같은 SMBIOS/DMI 데이터를 읽습니다.
- BIOS 공급업체 및 버전;
- 출시일;
- 시스템/보드 식별자;
- 메모리 정보;
- UEFI와 같은 펌웨어 기능.
BIOS 업데이트와 하드웨어별 문제를 비교하거나 현재 실행 중인 보드 리비전을 정확히 확인할 때 유용합니다.
PCIe 하드웨어가 열거되었는지 확인하려면 lspci를 사용하세요
lspci PCI 하위 시스템이 감지한 장치를 나열합니다. GPU, SATA 컨트롤러, NVMe 어댑터, NIC, 캡처 카드 및 기타 확장 하드웨어가 포함됩니다.
새 PCIe NIC가 다음에 전혀 표시되지 않는다면 lspci문제가 Docker/CasaOS보다 하위 계층에 있다면, 애플리케이션 소프트웨어를 설치하기 전에 장착 상태, 전원, 펌웨어 설정, 레인 공유 및 하드웨어 호환성을 확인하세요.
USB 장치 식별에는 lsusb를 사용하세요
lsusb USB 공급업체/제품 ID를 보고합니다. 이러한 ID는 Wi-Fi 어댑터, Coral TPU 장치, USB 스토리지 브리지, Zigbee 코디네이터 및 동일한 제품명으로 여러 하드웨어 버전이 출시된 기타 주변 장치를 진단할 때 특히 유용합니다.
드라이버 및 부팅 시 하드웨어 메시지에는 dmesg를 사용하세요
dmesg 다음 정보를 표시할 수 있습니다.
- 커널 드라이버 바인딩;
- 펌웨어 로드 실패;
- USB 연결 해제/재연결 이벤트;
- 스토리지 I/O 오류;
- NIC 링크 변경;
- PCIe/AER 오류.
관련 섹션만 필터링하거나 캡처하고, 관련 없는 부팅 로그 수천 줄을 그대로 게시하지 마세요.
lsblk를 사용하여 “디스크가 감지되지 않음”과 “디스크가 마운트되지 않음”을 구분하세요
lsblk 디스크, 파티션, 파일 시스템 관계 및 마운트 지점을 표시합니다. 다음 위치에 있는 드라이브는 lsblk 하지만 CasaOS 파일 UI에 표시되지 않는 경우는 Linux에서 드라이브 자체가 누락된 경우와는 다른 문제입니다.
수리 명령보다 읽기 전용 장치 검색을 우선하세요
원래 Part 1은 관찰 방법을 알려 줄 때 가장 강력합니다. 다음과 같은 명령은 dmidecode, lspci, lsusb, dmesg, 그리고 lsblk 이를 통해 저장 장치나 패키지를 수정하지 않고도 문제 계층을 파악할 수 있습니다.
디스크를 다시 포맷하거나, 드라이버를 재설치하거나, 소유권을 재귀적으로 변경하거나, Docker를 다시 빌드하기 전에 이 작업을 수행하세요.
CasaOS와 ZimaOS에는 서로 다른 호스트 수정 규칙이 필요합니다.
CasaOS는 일반적으로 다음이 실행되는 범용 Linux 호스트에서 실행됩니다: apt 사용할 수 있습니다. ZimaOS는 Buildroot 기반이며, 현재 IceWhale CLI 지침에 따르면 root 권한이 있더라도 대부분의 시스템 폴더는 읽기 전용으로 유지됩니다.
동일한 하드웨어에서 ZimaOS를 실행하는 경우 현재 ZimaOS CLI 범위를 사용하세요.
하드웨어부터 상위 계층으로 진단
유용한 순서는 다음과 같습니다.
- BIOS/펌웨어가 하드웨어를 감지합니다.
- Linux 버스 열거에서 이를 인식합니다.
- 커널 드라이버가 연결됩니다.
- 운영 체제가 사용 가능한 인터페이스/블록 장치를 생성합니다.
- CasaOS/ZimaOS가 UI에 이를 표시합니다.
- Docker/애플리케이션이 장치/경로를 수신합니다.
여섯 번째 계층으로 바로 건너뛰면 많은 하드웨어 문제가 앱 버그처럼 보일 수 있습니다.
blkid를 사용하여 파일 시스템 유형 및 UUID 식별
원문 Part 1에서도 다음을 사용합니다. blkid 이후 lsblk. 이는 다른 질문에 답합니다. 파티션에 실제로 어떤 파일 시스템 또는 LVM 구성원 시그니처가 포함되어 있으며, 이를 식별하는 UUID/PARTUUID는 무엇인가?
디스크가 Linux에는 표시되지만 마운트 또는 저장소 관리자가 예상한 파일 시스템을 인식하지 못할 때 유용합니다. 무엇이든 다시 포맷하기 전에 출력을 기록하세요.
드라이버 또는 저장 장치를 변경하기 전에 하드웨어 증거 저장
재현 가능한 지원 보고서를 작성하려면 다음 정보와 함께 관련 명령의 출력을 수집하세요:
- 보드 모델 및 BIOS 버전
- 운영 체제 버전
- 장치 모델 및 PCI/USB ID
- 문제가 발생하기 직전에 변경한 사항
- 하드웨어가 BIOS, Linux 및 CasaOS/ZimaOS UI에 표시되는지 여부
이를 통해 드라이버 누락, 케이블 고장, 지원되지 않는 파일 시스템 또는 컨테이너 매핑 문제를 구분할 수 있습니다.
Linux 하드웨어 문제 해결 FAQ
알 수 없는 PCIe 카드를 확인할 때 가장 먼저 실행해야 하는 명령은 무엇인가요?
lspci 는 PCI 하위 시스템이 해당 장치를 인식하는지 가장 빠르게 읽기 전용으로 확인하는 방법입니다.
USB 공급업체/제품 ID를 확인하는 데 가장 유용한 명령은 무엇인가요?
lsusb.
가이드의 Debian 패키지 관련 가정을 ZimaOS에서도 사용할 수 있나요?
진단 개념은 유지하되, ZimaOS에 맞는 확장 기능 및 드라이버 규칙을 따르세요.
