Docker Compose를 사용하여 ownCloud Infinite Scale을 설치하세요.

서버 설치를 위해서는 ownCloud의 공식 ocis_fullDocker Compose 예제(안정 버전 8.2 문서 라인용)를 사용하세요. 이 예제에는 Infinite Scale 서비스, 리버스 프록시, 그리고 선택적으로 오피스 협업 서비스가 포함되어 있습니다. .env실행하기 전에 해당 파일 에서 도메인, SMTP 발신자, 데이터 경로를 구성해야 합니다 docker compose up -d. 이 설정은 단일 인스턴스용으로 설계되었으며, Let's Encrypt 인증서를 사용하려면 공용 DNS와 접근 가능한 포트가 필요합니다. 도메인 없이 내부 평가를 진행하려면 아래에 설명된 자체 서명 인증서 제한 사항을 따르세요.

설치하기 전에

이 절차는 ownCloud의 Infinite Scale 8.2 프로덕션 Compose 가이드 (2026년 10월 9일 확인)를 따릅니다. 이 가이드는 Docker Engine과 Docker Compose가 이미 설치된 Ubuntu LTS 24.04 또는 22.04를 대상으로 하며, 최소 4~6GB의 메모리를 권장합니다. 기본적으로 활성화된 서비스에는 사용자 파일, 로그, 백업 및 향후 증가분을 고려하기 전에 약 2.4GB의 디스크 공간이 필요합니다.

DNS, 방화벽 규칙 및 Linux 호스트를 관리할 수 있는 경우 이 전체 예제를 선택하십시오. 이 예제에는 핵심 파일 플랫폼 외에도 더 많은 기능이 포함되어 있습니다. ownCloud에 따르면 도메인 없이 평가하는 경우 자체 서명 인증서를 사용하여 설정합니다.

  • 호스트: SSH 및 sudo 접근 권한이 있는 Ubuntu 24.04 LTS 또는 22.04 LTS.
  • 네트워크: 필수 DNS 레코드가 서버의 WAN 주소로 확인되는 도메인이어야 하며, 방화벽 및 상위 라우터에서 TCP 포트 22, 80, 443의 인바운드 연결을 허용해야 합니다.
  • 소프트웨어: Docker Engine 및 Compose 플러그인. Linux에서 Docker는 패키지 저장소를 통해 설치 과정을 안내합니다. 설치 후 Compose가 올바른 응답을 보내는지 확인하십시오 docker compose version.
  • 메일: 이 예제를 시작하려면 값이 SMTP_SENDER필요합니다. 알림 이메일을 받으려면 다른 SMTP 설정을 완료하십시오.

1. Docker Compose를 설치하고 호스트를 준비합니다.

Docker Engine이 이미 설치되어 있는 경우, Docker의 공식 Compose 설치 지침에 따라 사용 중인 Linux 배포판에 맞는 방법으로 Compose 플러그인을 설치하십시오 . Docker 저장소가 구성된 Ubuntu 또는 Debian 시스템의 경우, 문서에 나와 있는 패키지 명령은 다음과 같습니다.

sudo apt-get update
sudo apt-get install docker-compose-plugin
docker compose version

docker composeDocker는 현재 설치 환경에서 플러그인 및 명령줄 형식을 권장합니다 . 필요한 경우 Ubuntu 공식 설치 지침 에 따라 Docker Engine을 설치하십시오.

구성 파일을 다운로드하기 전에 사용할 도메인 또는 서브도메인을 호스트의 공용 IP 주소로 연결하십시오. ownCloud 샘플은 을 필요로 하며 , 오피스 서비스가 구성된 경우 및 OCIS_DOMAIN도 사용할 수 있습니다 . DNS 이름은 의 값과 일치해야 합니다 . 라우터에서 포트 80과 443이 이 호스트로 포트 포워딩되는지, 그리고 로컬 방화벽에서 해당 포트를 허용하는지 확인하십시오.COLLABORA_DOMAINONLYOFFICE_DOMAIN.env

2. 공식 작문 예제를 확인하세요

공식 ownCloud 배포 예제ocis_full 브랜치 의 디렉토리를 사용하십시오 . 브라우저가 있는 컴퓨터에서 ZIP 파일을 다운로드하고, 해당 파일을 헤드리스 서버로 전송한 다음 , ownCloud 가이드에 설명된 대로 압축을 해제하십시오 .stable-8.2scp/opt/compose/ocis/ocis_full

업데이트된 사본을 추출하기 전에 현재 파일을 저장하세요 .env. ownCloud는 파일이 덮어쓰여질 수 있다고 경고합니다. 프로젝트 디렉터리에서 Compose 명령을 실행하세요.

3. 도메인, 인증서, 이메일 및 데이터 경로를 구성합니다.

텍스트 편집기에서 엽니다 /opt/compose/ocis/ocis_full/.env. 샘플의 변수 이름과 구문은 그대로 유지하고, 설치 환경에 맞는 값만 편집합니다.

  • 사용자가 입력할 호스트 이름을 설정하십시오 OCIS_DOMAIN. 예시에서 Collabora 또는 OnlyOffice 서비스가 활성화된 경우에만 해당 호스트 이름을 설정하십시오.
  • 인터넷에 연결된 서버의 경우, INSECURE예시에서 안내하는 대로 해당 부분을 주석 처리하십시오. 공개적으로 사용할 경우 보안 설정이 비활성화된 상태로 두지 마십시오.
  • TRAEFIK_ACME_MAIL본인이 관리하는 이메일 주소로 설정하세요 . 초기 인증서 테스트에는 TRAEFIK_ACME_CASERVERLet's Encrypt의 스테이징 서버를 사용하세요. 스테이징 인증서는 일반적인 용도로는 신뢰할 수 없으며, 프로덕션 인증서를 요청하기 전에 DNS 및 연결 가능성을 테스트하는 데 도움이 됩니다.
  • SMTP_SENDER메일 릴레이를 아직 구성하지 않았더라도 설정하십시오 . 공식 가이드에 따르면 이 설정이 없으면 배포가 시작되지 않습니다. SMTP 호스트, 포트, 자격 증명, 인증 및 보안 설정을 사용할 수 있는 경우 추가하십시오. 다른 메일 설정이 없으면 인스턴스는 시작되지만 알림을 보낼 수 없습니다.
  • 예시의 이미지 태그와 검토 내용을 확인하세요 OCIS_DOCKER_IMAGE. 안정 버전 설치 후에는 릴리스 채널을 임의로 변경하지 마십시오.
  • 프로덕션 서버의 경우, 충분한 용량과 백업 기능을 갖춘 스토리지에 계획된 호스트 경로를 할당하는 것을 고려하십시오 OCIS_DATA_DIR. OCIS_CONFIG_DIR기본 설정은 Docker에서 관리하는 볼륨을 사용하므로 편리하지만, ownCloud는 해당 볼륨의 위치, 스냅샷, 백업, 복원, 재설정 및 마이그레이션이 Docker 호스트의 스토리지에 따라 달라진다는 점에 유의해야 합니다.

서버 및 구성 파일에 대한 접근을 제한하십시오. 자체 서명 인증서는 내부 평가용으로만 적합하며, 신뢰할 수 있는 공개 배포용으로는 적합하지 않습니다.

프로젝트 디렉토리에서 컨테이너를 시작하기 전에 병합된 구성을 검증하십시오.

cd /opt/compose/ocis/ocis_full
docker compose config

계속하기 전에 보고된 변수 또는 YAML 오류를 수정하십시오. 이 명령은 Compose 구성을 검토할 수 있도록 렌더링하는 것이며, DNS, 인증서, 저장소 권한 또는 SMTP 연결이 제대로 작동하는지 여부를 보장하지는 않습니다.

4. 서비스를 시작하고 인증서 설정을 완료합니다.

스택을 백그라운드에서 시작합니다.

docker compose up -d

첫 실행 시에는 이미지를 다운로드하고 서비스를 시작하므로 이후 재시작보다 시간이 더 오래 걸릴 수 있습니다. 서비스 상태는 다음 명령으로 확인할 수 있습니다.

docker compose ps -a

서비스가 종료되었거나 웹 주소가 로드되지 않는 경우 로그를 확인하십시오.

docker compose logs --follow

Traefik 로그부터 확인하세요. 인증서 오류는 일반적으로 DNS 및 .env값 불일치, 포트 80/443 차단 또는 잘못된 ACME 이메일 주소와 관련이 있습니다. 원인을 해결한 후 다시 시도하세요. docker compose down -v재설정 기능은 사용하지 마세요. 모든 프로젝트 볼륨(데이터 포함)이 삭제됩니다.

스테이징 인증서 검사가 성공하면 ownCloud의 인증서 절차를 따르십시오. 배포를 중지하고 예제 인증서 볼륨만 제거한 다음( ocis_full_certs), 스테이징 CA 설정을 지우고 다시 시작하여 신뢰할 수 있는 프로덕션 인증서를 요청하십시오. 제거하기 전에 정확한 볼륨 이름을 확인하십시오 docker volume ls. 데이터 또는 구성 볼륨은 제거하지 마십시오.

접근 권한을 확인하고 배포 환경을 보호하세요.

에 설정된 URL을 엽니다 OCIS_DOMAIN. 성공하면 브라우저가 인증서 경고 없이 HTTPS를 통해 로그인 페이지에 도달하고 필요한 서비스가 실행 중인 것을 표시합니다. ownCloud에서 제공하는 초기 자격 증명(다른 초기 암호를 설정하지 않은 경우 / ) docker compose ps -a을 사용하여 로그인한 다음 관리자 암호를 즉시 변경하십시오.adminadmin

사이트에 접속할 수 없는 경우 DNS, 포트 포워딩, Traefik의 ACME 로그, 그리고 Infinite Scale 서비스 로그를 확인하십시오. 로그인은 되지만 이메일 알림이 전송되지 않는 경우 SMTP 설정을 확인하십시오.

중요 파일을 저장하기 전에 백업이 구성과 데이터를 모두 포함하는지 확인하십시오. Docker 관리 볼륨은 평가에 편리하며, 명시적인 호스트 경로는 별도의 디스크에 저장하고 호스트 백업에 포함하기가 더 쉽습니다. HTTPS가 유효하고, 서비스가 재시작 후에도 계속 실행되며, 관리자 로그인이 작동하고, 백업이 선택한 스토리지 영역을 모두 포함하면 준비가 완료된 것입니다.

댓글 남기기

ownCloud oCIS에서 사용자 역할별 기본 스토리지 할당량 설정

ownCloud oCIS에서 사용자 역할별 기본 스토리지 할당량 설정

역할별로 새로운 ownCloud Infinite Scale 사용자에게 바이트 기반 스토리지 제한을 할당하는 방법을 안내합니다. proxy.yaml 예제와 안전성 검증 체크리스트가 포함되어 있습니다.

ownCloud 동기화 인증서 오류 해결 (TLS 소스)

ownCloud 동기화 인증서 오류 해결 (TLS 소스)

TLS 인증을 비활성화하지 않고 서버 호스트 이름, 인증서 체인, 개인 CA 신뢰 및 캡티브 포털 문제를 확인하여 ownCloud 데스크톱 동기화를 복원하세요.

업그레이드 후 ownCloud 무결성 경고를 해결하는 방법

잘못된 파일 보고서를 사용하여 코어 파일이나 앱 서명이 일치하지 않는 부분을 식별하고, 올바른 릴리스 파일을 복원하고, 무결성 검사를 안전하게 확인할 수 있습니다.

Docker Compose를 사용하여 ownCloud Infinite Scale을 설치하세요.

ownCloud Infinite Scale을 공식 Compose 예제를 사용하여 배포하고, 도메인 및 영구 스토리지를 구성한 다음, TLS, 컨테이너 및 첫 로그인을 확인합니다.

ownCloud Infinite Scale을 위한 S3 Blob 스토리지 구성

ownCloud Infinite Scale을 위한 S3 Blob 스토리지 구성

ownCloud Infinite Scale이 파일 콘텐츠를 안정적으로 저장할 수 있도록 S3NG 드라이버, 버킷 권한, 영구 메타데이터 저장소 및 업로드 크기를 설정합니다.

ownCloud 업로드가 99%에서 멈추는 경우, 다음 제한 사항을 확인하세요.

ownCloud 업로드가 99%에서 멈추는 경우, 다음 제한 사항을 확인하세요.

ownCloud 서버 업로드가 거의 완료될 무렵 중단되는 이유를 파일 상태, 할당량, 임시 디스크 공간, PHP 제한 및 프록시 시간 초과를 확인하여 알아보세요.

ownCloud Apache .htaccess 경고를 안전하게 제거하는 방법

ownCloud Apache .htaccess 경고를 안전하게 제거하는 방법

ownCloud의 웹 루트에만 AllowOverride All을 설정하고, 활성 Apache vhost를 확인한 다음, 안전하게 페이지를 새로 고침하여 .htaccess 규칙을 복원하십시오.

ownCloud Enterprise 감사 설정 및 로그 검증

ownCloud의 엔터프라이즈 감사 앱을 활성화하고, admin_audit 이벤트를 보호된 로그 파일로 라우팅하고, 실제 사용자 작업이 기록되는지 확인하십시오.

OIDC를 사용하여 ownCloud Infinite Scale을 Keycloak에 연결합니다.

OIDC를 사용하여 ownCloud Infinite Scale을 Keycloak에 연결합니다.

Keycloak의 영역 발급자, 웹 클라이언트 및 사용자 클레임을 정렬하여 ownCloud Infinite Scale이 웹 및 모바일 클라이언트 전반에서 사용자를 안정적으로 로그인할 수 있도록 합니다.

ownCloud 파일의 지분 손실 없이 새 소유자에게 파일을 이전하세요

ownCloud의 occ 명령어를 사용하여 소유 파일과 공유 폴더를 이전하고, 어떤 파일이 남는지 확인하고, 이전 계정을 삭제하기 전에 액세스 권한을 확인하세요.