커뮤니티 솔루션

기존 Samba 공유를 손상시키지 않고 CasaOS 제거 후 정리

An October 2025 report where uninstalling CasaOS from Linux left the CasaOS-created Samba configuration active while the user's pre-existing smb.conf had been renamed, breaking Kodi access to shares that existed before CasaOS.

소스 스레드는 게시물 하나뿐이지만, 여기서 설명하는 문제는 중요합니다. 한 사용자가 Linux에 CasaOS를 설치한 후 공식 제거 명령으로 CasaOS를 삭제했는데, CasaOS 이전에 사용하던 Samba 설정이 더 이상 작동하지 않는 것을 발견했습니다. 조사 결과 CasaOS가 설치될 때 기존 smb.conf의 이름이 변경되었고, CasaOS가 생성한 Samba 구성이 제거 후에도 계속 활성 상태로 남아 있었습니다.

이 스레드에는 운영진의 답변이나 완전한 정리 항목 목록이 없으므로, 이 페이지의 범위는 좁게 유지해야 합니다. 확인된 Samba 측면의 부작용과 안전한 제거 후 점검 방법은 설명할 수 있지만, 모든 Linux 배포판에서 CasaOS가 남기는 모든 파일의 확정적인 목록을 지어내서는 안 됩니다.

실제로 확인된 내용

사용자는 CasaOS를 설치하기 전에 Samba 공유를 사용하고 있었습니다. 해당 공유는 TV의 Kodi에서 정상적으로 작동했습니다. CasaOS를 제거한 지 며칠 후 Kodi에서 더 이상 공유에 접근할 수 없게 되었습니다.

이후 사용자는 CasaOS 설치 과정에서 기존 Samba 구성 파일이 이동되거나 이름이 변경되었고, CasaOS가 자체 구성을 설치했다는 사실을 확인했습니다. 제거 과정에서는 이전 smb.conf가 자동으로 복원되지 않았기 때문에, 컴퓨터는 계속 CasaOS 설치 당시의 구성을 사용하고 있었습니다.

애플리케이션 제거는 호스트를 이전 상태로 되돌리는 것과 다릅니다

CasaOS는 Linux 배포판 위에서 실행되며 Docker, 저장 경로, Samba와 같은 서비스와 통합됩니다. 설치 과정에서 구성 파일을 교체하거나 수정했다면 CasaOS 바이너리를 제거하는 것만으로는 호스트가 설치 전과 정확히 같은 상태로 복원되지 않을 수 있습니다.

이는 일반적인 Linux 관리 원칙입니다. “패키지 제거”와 “시스템을 이전 구성으로 복원”은 서로 다른 작업입니다.

현재 CasaOS 제거 프로그램에는 선택적 제거 항목이 있습니다

IceWhale이 유지 관리하는 CasaOS 프로젝트에서는 여전히 casaos-uninstall을 일반적인 제거 명령으로 제공합니다. 현재 제거 프로그램은 Docker, CasaOS 컨테이너, CasaOS 파일을 각각 제거할지 별도로 묻습니다.

최신 시스템을 제거하기 전에 현재 CasaOS 제거 경로를 확인하세요. 릴리스에 따라 정확한 프롬프트와 정리 동작이 변경될 수 있기 때문입니다.

제거하기 전에 호스트 수준 구성을 백업하세요

이미 서비스가 실행 중인 서버에서 CasaOS를 테스트하고 있다면 제거하기 전에 중요한 호스트 구성의 사본을 저장하세요. 예시는 다음과 같습니다.

  • Samba 구성 및 공유 정의;
  • 사용자 지정 systemd 유닛;
  • 리버스 프록시 구성;
  • CasaOS가 소유하지 않은 Docker Compose 파일;
  • 방화벽 또는 네트워크 구성;
  • 마운트 정의 및 저장소 구성.

CasaOS가 유일한 워크로드가 아닌 “실제” Linux 서버에서는 특히 중요합니다.

정상으로 알려진 파일을 비교하여 Samba를 복원하세요

CasaOS 설치 전의 smb.conf가 이름이 변경되었거나 백업 파일명으로 남아 있다면, 활성 구성 파일을 즉시 덮어쓰지 마세요. 먼저 두 버전을 모두 보존하고 공유 정의를 비교한 다음, 사용할 구성이 올바른지 검증하세요.

구문 오류가 발생하면 모든 Samba 공유가 오프라인이 될 수 있습니다. 가능하다면 서비스를 다시 시작하거나 다시 로드하기 전에 Samba 자체의 구성 검증 도구를 사용하세요.

점검 없이 “정리”를 위해 /DATA 또는 Docker 저장소를 삭제하지 마세요

CasaOS는 관리 계층을 제거해도 사용자 데이터가 자동으로 삭제되지 않도록 애플리케이션 및 사용자 데이터를 영구 저장 위치에 의도적으로 보관합니다. 이러한 안전장치는 제거 후에는 “잔여 파일”처럼 보일 수 있습니다.

어떤 파일이 CasaOS에 속하고 어떤 파일이 계속 필요한 애플리케이션에 속하는지 확인하기 전에는 /DATA, Docker 볼륨, 컨테이너 데이터 또는 애플리케이션 폴더를 재귀적으로 삭제하지 마세요.

안전한 제거 후 점검 방법

  1. CasaOS 서비스가 더 이상 실행되지 않는지 확인합니다.
  2. 활성 Samba 구성을 검토하고 CasaOS 설치 전 백업과 비교합니다.
  3. Docker 데이터를 삭제하기 전에 남아 있는 CasaOS 컨테이너를 나열합니다.
  4. 영구 데이터 디렉터리를 이름만 보고 삭제하지 말고 내용을 확인합니다.
  5. 호스트 수준 서비스가 CasaOS에서 생성한 파일을 여전히 참조하는지 확인합니다.
  6. 다른 서비스에 필요하지 않다는 사실을 확인한 후에만 잔여 파일을 제거합니다.

소스 스레드만으로는 확인할 수 없는 내용

이 게시물만으로는 모든 CasaOS 제거 과정에서 Samba가 남는다고 입증할 수 없고, 모든 잔여 파일의 목록도 확인할 수 없으며, 이 동작이 버그로 간주되었는지 설명하는 IceWhale의 답변도 확인할 수 없습니다. 확인된 사실은 더 좁습니다. 이 사용자의 기존 Samba 구성이 자동으로 복원되지 않았다는 것입니다.

CasaOS 제거 정리 FAQ

casaos-uninstall은 반드시 Docker를 제거하나요?

아니요. 유지 관리되는 제거 프로그램에서는 Docker 제거를 별도의 선택 항목으로 처리합니다.

사용자의 기존 Samba 공유가 작동하지 않게 된 이유는 무엇인가요?

활성 smb.conf가 CasaOS에서 생성한 버전으로 남아 있었고, CasaOS 설치 전 구성으로 되돌아가지 않았기 때문입니다.

제거 후 CasaOS처럼 보이는 디렉터리를 모두 삭제해야 하나요?

아니요. 영구 디렉터리에는 제거 과정에서 의도적으로 삭제하지 않은 애플리케이션 또는 사용자 데이터가 포함될 수 있습니다.