커뮤니티 솔루션

ZimaOS 설치 후 로컬 계정 생성 실패: 해결 방법

A ZimaOS 1.2.0 beta install failed at first-account creation; IceWhale recommended the latest build, and 1.2.3 later documented a user-creation fix.

설치 직후 ZimaOS에서 “로컬 계정 생성(Create Local account)”이 실패한다면, 더 복잡한 비밀번호를 만들기 전에 설치된 ZimaOS 버전을 확인하세요. 원래 사례의 버전은 ZimaOS 1.2.0 베타였으며, IceWhale은 사용자에게 최신 버전을 설치하라고 안내했습니다. 이후 v1.2.3에서 사용자를 생성할 수 없던 버그가 명시적으로 수정되었습니다.

현재 설치 버전에서는 첫 번째 계정이 기본 소유자/관리자 계정이며, 이메일 주소 없이 로컬에서 생성해야 합니다. 최신 빌드에서도 계속 실패한다면 재설치하기 전에 설치 이미지, 브라우저/세션 상태, 시스템 디스크 상태, 사용자 데이터베이스를 확인하세요.

실패 알림이 표시된 ZimaOS 최초 실행 로컬 계정 생성 화면
이전 1.2.0 베타 설치에서 첫 번째 로컬 계정을 생성하는 동안 오류가 발생했습니다. 출처: IceWhale 커뮤니티 포럼.

원래 버그는 이전 베타 버전에 있었습니다

사용자는 여러 비밀번호를 시도했지만 항상 일반적인 실패 알림을 받았습니다. 버전이 1.2.0으로 확인되자 IceWhale은 최신 빌드로 업데이트하고 설치 미디어 제작에 Balena Etcher를 사용하라고 안내했습니다.

ZimaOS 1.2.3에서 사용자 생성 실패가 수정되었습니다

v1.2.3 릴리스 노트에는 SSH 및 시스템 디스크 표시 수정과 함께 사용자를 생성할 수 없던 문제가 수정되었다고 명시되어 있습니다.

현재 제공되는 ZimaOS 1.2.3 릴리스 노트에서 해당 버전 기준을 확인할 수 있습니다.

1단계: 최신 안정 버전의 ZimaOS 설치

이전 설치 이미지로 테스트 중이라면 최신 릴리스로 교체하세요. 현재 ZimaOS 설치 가이드에서는 Balena Etcher로 최신 이미지를 플래시할 것을 권장합니다.

2단계: 시스템 디스크가 정상이고 쓰기 가능한지 확인

쓰기 가능한 시스템 영역이 손상되었거나 가득 차 있으면 사용자 데이터베이스를 안정적으로 생성할 수 없습니다. 다음을 확인하세요.

df -h
lsblk -f

읽기 전용 squashfs 시스템 이미지가 사용량 100%로 표시되는 것과 쓰기 가능한 데이터/overlay 영역이 가득 찬 것을 혼동하지 마세요.

3단계: 새 브라우저 세션으로 시도

시크릿 창에서 직접 LAN IP를 사용하고, 로컬 ZimaOS 페이지에 대해 과도한 스크립트/콘텐츠 차단을 비활성화하세요. 한 브라우저에서는 실패하고 다른 브라우저에서는 성공한다면 서버 측 계정 시스템이 근본 원인일 가능성은 낮습니다.

4단계: 새로 설치한 시스템에서 사용자 데이터베이스를 수동으로 수정하지 않기

시스템을 새로 설치한 상태이므로 /etc/passwd 또는 ZimaOS 데이터베이스를 반복해서 수정하면 변수가 더 늘어납니다. 최신 안정 빌드에서도 초기 계정을 생성할 수 없고 보존할 데이터가 없다면, 깨끗하게 다시 플래시하거나 재설치하는 편이 더 빠르고 안전한 경우가 많습니다.

새로 설치한 것이 아니라면 계정을 초기화하기 전에 백업

ZimaOS에는 로컬 사용자 데이터베이스를 삭제하고 계정 설정을 다시 초기화하는 비밀번호 복구 절차도 문서화되어 있습니다. 이는 복구 작업이지, 정상적인 최신 시스템에서 새 계정 생성 오류가 발생했을 때 가장 먼저 시도할 해결책은 아닙니다.

로컬 계정 사용—클라우드 계정은 필요하지 않음

현재 ZimaOS 문서에 따르면 ZimaOS는 전적으로 로컬 계정으로 작동하며, 일반적인 OS 사용에 이메일이나 전화번호가 필요하지 않습니다.

설치 문제 해결 가이드에서 더 폭넓은 복구 절차를 확인할 수 있습니다.

비밀번호뿐 아니라 사용자 이름도 확인

백엔드에서 비밀번호 강도를 평가하기 전에 잘못된 입력으로 인해 첫 계정 생성이 실패할 수 있습니다. 문제를 해결하는 동안에는 특수 구두점이 없는 간단한 ASCII 사용자 이름을 사용한 다음, 현재 UI 요구 사항을 충족하는 강력한 비밀번호를 선택하세요.

최신 빌드에서 기본적인 사용자 이름/비밀번호 조합도 계속 실패한다면, 문제는 비밀번호 복잡성보다는 시스템 상태나 계정 서비스에 있을 가능성이 높습니다.

시간 및 브라우저 상태 확인

시스템 시계가 잘못 설정되어 있으면 ZimaOS의 웹 세션과 TLS에 의존하는 다른 서비스가 정상적으로 작동하지 않을 수 있습니다. 표시된 시간을 정확한 것으로 알려진 장치와 비교하고, 오래된 캐시 호스트 이름 대신 직접 LAN IP를 통해 설정 화면을 테스트하세요.

다시 설치하기 전에 증거 수집

최신 릴리스에서도 계속 실패한다면 정확한 ZimaOS 버전, 설치 이미지 출처, 대상 디스크, 브라우저, 실패 화면의 스크린샷 및 관련 로그를 수집하세요. 이렇게 하면 일반적인 “실패” 메시지를 재현 가능한 지원 사례로 전환할 수 있습니다.

FAQ

ZimaOS 1.2.0에서는 왜 모든 비밀번호가 실패했나요?

이전 베타 버전에 사용자 생성 버그가 있었으며, 이 문제는 v1.2.3에서 명시적으로 수정되었습니다.

Rufus와 Balena Etcher 중 무엇을 사용해야 하나요?

IceWhale은 원래 문의 스레드에서 Balena Etcher를 권장했으며, 현재 설치 문서에서도 여전히 이를 사용합니다.

첫 번째 ZimaOS 계정에 이메일이 필요한가요?

아니요. 현재 ZimaOS는 일반적인 작동에 로컬 계정을 사용합니다.

계정 생성에 실패하면 user.db를 삭제해야 하나요?

첫 단계로는 권장하지 않습니다. 이는 복구/초기화 작업입니다. 새로 설치한 시스템이 정상적으로 작동하지 않는 경우 먼저 최신 이미지를 사용하고 쓰기 가능한 저장 공간이 있는지 확인하세요.