커뮤니티 솔루션

ZimaOS 앱 스토어가 설정 양식을 건너뛰고 바인드 경로 누락으로 실패한 이유: 2025년 스레드가 입증한 사실

A November 2025 thread where App Store installs skipped the settings/configuration form and failed with Docker bind-source-path-does-not-exist errors. Community replies first blamed stale AppData, but the original poster later said deleting AppData no longer helped and even first-time app installs were affected, while YAML installations still worked. The thread ended without an IceWhale-confirmed root cause.

소스 글은 처음에는 오래된 AppData에 대한 그럴듯한 가설로 시작했지만, 마지막 게시글을 보면 그 설명만으로는 충분하지 않습니다. 이전에 제거된 앱들이 설정 양식을 건너뛰고 존재하지 않는 바인드 경로를 재사용하려고 하면서 bind source path does not exist와 같은 Docker 오류가 발생했습니다. 커뮤니티의 한 답변에서는 기존 AppData 폴더를 삭제하거나 이름을 변경하여 ZimaOS가 해당 앱을 새 앱으로 인식하게 하라고 제안했습니다.

이후 원글 작성자는 이 방법이 한 번은 효과가 있었지만 더 이상 도움이 되지 않는다고 밝혔습니다. 더 중요한 점은 처음 설치하는 새 앱에서도 설정 양식을 건너뛰고 100%에서 멈추기 시작했다는 것이며, YAML을 통해 앱을 설치하는 것은 여전히 작동했다는 사실입니다. 따라서 가장 유력한 의심 대상은 특정 앱의 잘못된 디렉터리 하나가 아니라, 과거의 App Store UI/구성 경로 자체로 바뀝니다.

Docker 오류는 실제였지만 근본 원인은 아니었습니다

화면에 표시된 오류는 다음과 비슷했습니다.

Error response from daemon:
invalid mount config for type "bind":
bind source path does not exist: [EXPECTED PATH]

호스트 측 소스 디렉터리가 존재하지 않는 바인드 마운트를 Docker가 올바르게 거부한 것입니다. 해결되지 않은 문제는 App Store가 사용자가 경로를 선택하거나 생성할 수 있게 해 주는 설정 양식을 표시하지 않은 채, 왜 해당 경로를 생성하거나 재사용했는가였습니다.

오래된 AppData는 커뮤니티의 가설이었습니다

gelbuilding은 스토어가 설치를 새 설치로 인식하도록 /DATA/AppData/<app-name>을 삭제하거나 이름을 변경해 보라고 제안했습니다. 다른 커뮤니티 구성원도 같은 방법을 사용했다고 말했습니다.

이는 IceWhale 직원의 공식 진단이 아니었으며, 원글 작성자의 이후 테스트 결과는 이 방법만으로는 더 광범위한 문제를 해결할 수 없음을 보여 주었습니다.

처음 설치하는 앱도 양식을 건너뛰면서 진단이 달라졌습니다

기존 로컬 AppData가 없는 새 앱에서도 설정을 건너뛰기 시작했다면, 오래된 폴더를 계속 삭제하는 것은 잘못된 문제 해결 과정이 됩니다. 사용자는 재시작 + 폴더 삭제 + 재설치를 수행해도 같은 상황이 반복되었다고 분명히 밝혔습니다.

YAML 설치가 작동했다는 점은 중요한 증거였습니다

사용자는 YAML로는 여전히 앱을 설치할 수 있다고 말했습니다. 이는 Docker 자체가 완전히 고장 난 것은 아니라는 뜻이며, 문제의 범위를 스토어의 앱 정의/구성/렌더링 작업 흐름 쪽으로 좁혀 줍니다.

ZimaOS 1.7에서는 App Store 아키텍처가 재구축되었습니다

ZimaOS 1.7.0에는 새롭게 설계된 탐색/관리 UI와 네이티브 YAML 편집 및 파싱 기능을 포함한 App Store 2.0이 도입되었습니다. 이후 ZimaOS 1.7.1에서는 Docker/AppData/WebUI/YAML 관련 수정 사항이 추가되었습니다.

현재 App Store 2.0의 기준 문서를 참조하세요.

현재 권장되는 점검 순서

  1. 현재 안정 버전의 ZimaOS로 업데이트합니다.
  2. 한 번도 설치한 적이 없는 공식 또는 단순한 앱 하나를 테스트합니다.
  3. 정확히 어떤 호스트 바인드 경로가 누락되었는지 확인합니다.
  4. 해당 폴더가 존재하는지, 어느 저장소에 속하는지 확인합니다.
  5. 동일한 의도된 경로를 사용해 YAML 설치가 성공하는지 확인합니다.
  6. 설정 양식이 계속 실패하면 App Store 및 컨테이너 로그를 수집합니다.

상태를 저장하는 앱의 AppData를 무작정 삭제하지 마세요

AppData 폴더에는 데이터베이스, 구성, 키, 라이브러리 및 사용자 상태가 포함될 수 있습니다. 테스트할 때는 삭제보다 이름을 변경하는 편이 안전하며, 중요한 데이터는 먼저 백업해야 합니다.

설정 양식 누락 관련 FAQ

오래된 AppData를 삭제하면 원래 문제가 영구적으로 해결되었나요?

아니요. 원글 작성자는 한 번은 도움이 되었지만 나중에는 더 이상 작동하지 않았다고 말했습니다.

처음 설치하는 앱도 영향을 받았나요?

예. 마지막 원문 게시글에 따르면 새 앱에서도 설정 양식을 건너뛰고 설치가 멈췄습니다.

YAML 설치는 여전히 작동했나요?

예. 이는 당시 문제가 Docker를 완전히 사용할 수 없어서가 아니라 App Store 경로와 관련되어 있었다는 것을 보여 주는 가장 강력한 단서 중 하나였습니다.