OpenCloud는 공식 Docker 및 Docker Compose 배포 방식을 지원하므로 ZimaOS에서 실행할 수 있습니다. 간단한 로컬 테스트에는 단일 컨테이너 방식을 사용하고, HTTPS를 통한 가족용 파일 동기화에는 통합 Traefik 또는 외부 프록시 아키텍처를 사용하는 공식 Compose 스택을 사용하세요.
사용자는 AI가 생성한 안내를 따라 하느라 2주 동안 어려움을 겪었습니다. 해결책은 스택을 임의로 구성하지 않고, 영구 설정/데이터 경로, 최초 관리자 설정, URL, 프록시/TLS 요구 사항을 비롯해 OpenCloud의 최신 공식 배포 모델을 따르는 것입니다.
로컬 테스트 인스턴스로 시작하세요
최신 OpenCloud Docker 가이드에는 포트 9200을 사용하는 간단한 컨테이너가 설명되어 있습니다.
mkdir -p /DATA/AppData/opencloud/config
mkdir -p /DATA/AppData/opencloud/data
docker pull opencloudeu/opencloud-rolling:latest
docker run --rm -it -v /DATA/AppData/opencloud/config:/etc/opencloud -v /DATA/AppData/opencloud/data:/var/lib/opencloud -e IDM_ADMIN_PASSWORD=CHANGE_ME opencloudeu/opencloud-rolling:latest init
검증을 위한 로컬 테스트에만 사용하세요
업스트림 예제는 빠른 테스트를 위해 보안에 취약한 로컬 설정을 사용합니다. 이 설정을 인터넷에 공개하는 프로덕션 가족용 클라우드 배포에 사용하지 마세요.
프로덕션 환경에는 Docker Compose를 사용하세요
최신 OpenCloud Docker Compose 가이드는 통합 Traefik과 외부 리버스 프록시, 두 가지 공식 아키텍처를 지원합니다.
ZimaOS에서 포트 80과 443을 확인하세요
통합 Traefik 스택은 일반적으로 표준 HTTP/HTTPS 포트를 사용합니다. ZimaOS나 다른 리버스 프록시가 이미 해당 포트를 사용 중이면, ZimaOS 관리 엔드포인트를 섣불리 옮기는 대신 외부 프록시 방식을 사용하거나 별도의 LAN IP/VM을 사용하세요.
설정과 사용자 데이터를 모두 영구 저장하세요
/etc/opencloud와 /var/lib/opencloud를 내구성이 뛰어난 ZimaOS 저장소에 보관하세요. 컨테이너 이미지는 다시 만들 수 있지만, 사용자 계정 정보와 데이터는 복구할 수 없습니다.
가족 데이터를 위해 안정적인 이미지/브랜치를 사용하세요
빠른 시작 예제에서는 롤링 이미지를 사용합니다. 장기간 운영할 배포라면 무작정 업데이트하는 대신 검증 후 적절한 안정 버전/브랜치를 고정하고 OpenCloud의 프로덕션 지침을 따르세요.
업그레이드 전에 백업하세요
OpenCloud 구성과 데이터를 모두 보호한 다음 업그레이드 후 로그인, 공유, 동기화 클라이언트 및 복원을 테스트하세요.
OpenCloud와 Nextcloud 비교
주로 가벼운 다중 사용자 파일 동기화가 필요하다면 OpenCloud가 적합할 수 있습니다. 캘린더, 연락처, 오피스, 플러그인 및 성숙한 통합 기능으로 구성된 더 큰 생태계가 필요하다면 Nextcloud가 여전히 더 풍부한 기능을 제공할 수 있습니다.
맞춤 Docker 가이드에서 ZimaOS 측의 워크플로를 확인할 수 있습니다.
프로덕션 설정 전에 공개 또는 비공개 URL 선택하기
OpenCloud는 구성된 URL을 기반으로 링크와 인증 리디렉션을 생성합니다. 나중에 임시 localhost 형식의 URL에서 클라이언트를 마이그레이션하지 않도록 가족을 초대하기 전에 최종 호스트 이름과 HTTPS 경로를 정하세요.
관리자가 아닌 사용자로 파일 동기화 확인하기
일반 가족 계정을 만들고, 한 클라이언트에서 테스트 폴더를 업로드한 뒤 두 번째 기기에 동기화하고 테스트 파일을 삭제한 다음 복원하세요. 이렇게 하면 관리자 웹 로그인만 확인하는 것이 아니라 실제 다중 사용자 동기화 워크플로를 검증할 수 있습니다.
파일과 함께 ID 및 구성도 백업하세요
사용자 파일만으로는 서비스를 온전히 복구할 수 없습니다. 계정, 공유 항목, 권한을 저장된 파일과 함께 복구할 수 있도록 OpenCloud의 구성 및 ID 데이터도 보존하세요.
자주 묻는 질문
ZimaOS에서 OpenCloud를 실행할 수 있나요?
네. ZimaOS는 Docker/Compose를 지원하며, OpenCloud는 두 가지 컨테이너 배포 방식을 모두 공식 문서로 제공합니다.
간편한 OpenCloud 테스트에서는 어떤 포트를 사용하나요?
공식 로컬 Docker 예제에서는 포트 9200을 사용합니다.
프로덕션 환경에서 롤링 이미지를 사용해야 하나요?
테스트용으로만 사용하세요. 단, OpenCloud의 최신 프로덕션 지침이 현재의 업데이트 전략에 명시적으로 부합하는 경우는 예외입니다.
Traefik을 사용해야 하나요?
아니요. OpenCloud는 통합 Traefik을 사용하거나 외부 리버스 프록시 뒤에 배포할 수 있습니다.
