This thread changed topics over time. It began as a 2024 CasaOS BTOP installation tutorial, then became much more valuable in March 2025 when ZimaOS 1.3.3 added a built-in btop performance panel and several ZimaBoard/ZimaBlade users discovered that the new binary crashed with 잘못된 명령어(코어 덤프됨).
이 스레드는 시간이 지나면서 주제가 바뀌었습니다. 처음에는 2024년 CasaOS BTOP 설치 튜토리얼이었지만, 2025년 3월 ZimaOS 1.3.3에 내장 btop 성능 패널이 추가된 후 ZimaBoard 및 ZimaBlade 사용자 여러 명이 새 바이너리가 다음 오류와 함께 충돌한다는 사실을 발견하면서 훨씬 더 유용한 자료가 되었습니다.
최종 진단은 커뮤니티의 추측이 아니라 IceWhale에서 나왔습니다. Zima-Giorgio는 btop을 컴파일할 때 팀이 ZimaBoard CPU를 고려하지 못했으며, ZimaOS 1.4.0에서 문제가 해결될 것이라고 밝혔습니다. 따라서 이는 명확한 버전 경계를 가진 과거의 CPU 호환성 버그입니다.
ZimaOS 1.3.3에서 내장 btop 패널 도입
IceWhale의 1.3.3 릴리스 노트에서는 ZimaOS 대시보드의 새로운 성능 모니터링 패널로 btop이 도입되었습니다. 별도의 모니터링 스택을 설치하지 않고도 CPU, 메모리, 프로세스 및 시스템 활동을 확인할 수 있도록 하는 것이 목표였습니다.
소스 스레드를 확인할 때는 ZimaOS 1.3.3 기능 도입 시점을 기준으로 삼으세요.
영향을 받은 시스템에서는 바로 가기를 클릭하면 높은 번호의 임시 포트가 열리고 다시 연결하라는 메시지만 표시되었습니다.
btop을 직접 실행하자 잘못된 명령어가 발생함
핵심 진단 문구는 다음과 같았습니다.
btop
잘못된 명령어(코어 덤프됨)
이 메시지는 CPU가 바이너리를 빌드할 때 사용하도록 설정된 명령어를 실행하려 했지만 하드웨어가 이를 지원하지 않았다는 의미입니다. 이는 브라우저 캐시 문제나 WebSocket 시간 초과와는 전혀 다릅니다.
여러 브라우저에서 브라우저별 버그 가능성이 배제됨
사용자들은 Firefox, Chrome/Chromium, Safari, Brave, Opera, Edge와 일반 창 및 비공개/시크릿 모드에서 테스트했습니다. 동작은 동일했습니다.
이러한 부정 테스트는 첫 번째 IceWhale 문제 해결 질문이 브라우저별 문제일 가능성이 있는지 묻는 것이었기 때문에 유용했습니다.
DevTools에서 백엔드 종료 후 WebSocket 오류가 표시됨
영향받은 사용자들은 Intel Celeron N3450 세대 CPU를 사용했습니다
ZimaBoard 832 사용자 한 명과 ZimaBlade 사용자 한 명이 하드웨어를 비교한 결과, 두 제품이 Intel Celeron N3450급 CPU를 공유한다는 사실을 발견했습니다. 이들은 btop 바이너리가 더 최신인 ZimaCube CPU 명령어 집합을 대상으로 컴파일되었는지 물었습니다.
이 가설은 이후 IceWhale에 의해 확인되었습니다.
IceWhale은 컴파일 대상이 잘못되었음을 확인했습니다
3월 27일, Zima-Giorgio는 문제가 확인되었으며 원래 btop 빌드가 ZimaBoard의 CPU를 고려하지 않았기 때문에 ZimaOS 1.4.0에서 해결될 것이라고 밝혔습니다.
이는 가장 확실한 출처에 기반한 결론이며, 브라우저를 다시 설치하거나 변경 불가능한 ZimaOS 호스트에 다른 btop 바이너리를 수동으로 설치하는 등의 추측성 해결 방법을 대신해야 합니다.
변경되는 높은 포트는 의도된 동작이었습니다
IceWhale의 CorrectRoadH는 btop이 실행될 때마다 다른 높은 포트를 사용하는 것이 임시 모니터링 세션을 직접 재사용하기 어렵게 만들기 위한 보안 기능이라고 밝혔습니다.
따라서 포트가 변경되었다는 사실 자체는 오류의 증거가 아니었습니다.
1.3.3 버그만으로 현재 btop을 진단하지 마세요
현재 ZimaOS는 1.3.3/1.4.0보다 훨씬 최신 버전입니다. 오늘 btop이 작동하지 않는다면 현재 ZimaOS 버전, CPU 모델, 터미널에 표시되는 정확한 오류, 그리고 대시보드 바로 가기와 CLI 중 어느 쪽에서만 문제가 발생하는지를 기록하세요.
An 잘못된 명령어 최신 빌드에서도 CPU 호환성 문제를 나타낼 수 있지만, 이전 2025년 패키지라고 단정하기보다는 새로운 회귀 문제로 조사해야 합니다.
CPU 오류 후 WebSocket 오류가 나타난 이유
대시보드는 btop을 위한 대화형 터미널 형태의 세션을 실행합니다. btop 프로세스가 잘못된 CPU 명령어로 즉시 종료되면 프런트엔드는 통신해야 할 백엔드를 잃게 됩니다. 따라서 WebSocket 종료 및 연결 거부 메시지는 프로세스 충돌로 인한 2차적인 영향일 수 있습니다.
이는 유용한 일반 문제 해결 교훈입니다. 브라우저 콘솔의 첫 번째 오류가 항상 근본 원인은 아닙니다. 기반 명령어를 직접 실행했을 때의 동작과 비교해 보세요.
Network Manager 바로 가기도 실패한 것이 또 다른 단서가 되었습니다
한 사용자는 Resource Manager와 Network Manager 바로 가기 모두 동일한 재연결 동작을 일으켰지만 일반 웹 터미널 자체는 정상적으로 작동했다고 말했습니다. 이는 문제가 완전한 ttyd 중단이 아니라 바로 가기로 실행된 도구 환경과 관련되어 있음을 시사했습니다.
IceWhale은 여전히 직접적인 btop 충돌 정보와 N3450 하드웨어 정보를 공유하여 실제 컴파일 대상 문제를 파악했습니다.
동일한 1.3.3 빌드를 다시 설치해도 CPU 명령어는 변경되지 않습니다
IceWhale이 바이너리 자체가 ZimaBoard CPU를 고려하지 않고 컴파일되었다고 확인한 뒤에는 브라우저 재설치, 캐시 삭제, 동일한 시스템 버전 재설치로 실행 파일의 명령어 집합을 수정할 수 없었습니다.
근본적인 해결을 위해서는 새로 컴파일한 바이너리를 다음 ZimaOS 릴리스에서 제공해야 했습니다.
하드웨어 호환성에는 커널 드라이버뿐 아니라 사용자 공간 바이너리도 포함됩니다
호환성 논의는 주로 NIC, GPU 또는 스토리지 드라이버에 초점을 맞추는 경우가 많습니다. 하지만 이번 사례는 하드웨어가 구현하지 않는 명령어를 번들 애플리케이션이 사용하도록 컴파일되면 일반적인 x86 운영 체제도 구형 CPU에서 문제를 일으킬 수 있음을 보여줍니다.
타사 x86 시스템의 경우, 잘못된 명령어 따라서 이 메시지는 중요한 증거이며 지원 보고서에 그대로 포함해야 합니다.
btop 호환성 FAQ
소스 문제는 Firefox 또는 Chrome 때문에 발생했나요?
아니요. 사용자들은 여러 브라우저와 비공개 모드에서 이 문제를 재현했습니다.
IceWhale은 근본 원인이 무엇이라고 말했나요?
btop 바이너리는 ZimaBoard CPU의 명령어 집합을 고려하지 않고 컴파일되었습니다.
어떤 버전에서 이 문제가 해결될 예정이었나요?
Zima-Giorgio는 수정된 btop이 ZimaOS 1.4.0에 포함될 것이라고 말했습니다.
