ONLYOFFICE Workspace의 기본 저장 위치 변경
포털 데이터를 기본 디스크에서 지원되는 클라우드 스토리지 공급자로 이동하거나, Docker 데이터의 호스트 볼륨 매핑을 변경하여 안전하게 재배치할 수 있습니다.
ONLYOFFICE Workspace의 기본 저장 위치 변경
ONLYOFFICE Workspace 포털 데이터를 로컬 디스크에서 지원되는 클라우드 스토리지 서비스로 이동하려면 포털 설정 → 통합에서 해당 서비스를 연결한 다음 제어판 → 일반 설정 → 스토리지로 이동하여 구성하고 연결을 클릭하세요. ONLYOFFICE는 연결이 시작되면 데이터 마이그레이션이 시작되며 다소 시간이 걸릴 수 있다고 안내합니다. "저장 위치"가 Docker 설치에 사용되는 호스트 디렉터리를 의미하는 경우, 배포 환경에서 커뮤니티 서버 데이터 볼륨을 변경해야 합니다. 이는 별도의 작업입니다.
어떤 저장 위치를 변경하려고 하십니까?
ONLYOFFICE에서는 "저장소"라는 용어를 여러 가지 의미로 사용합니다. 제어판의 저장소 페이지에서 포털 데이터를 기본 디스크 에서 지원되는 타사 저장소로 정적 데이터 저장 위치로 전환할 수 있습니다. 이는 대부분의 사용자가 Workspace 포털 데이터를 서버의 로컬 디스크에서 다른 저장소로 이동하려는 경우 사용하는 관리자 설정입니다. 문서 모듈 내의 폴더를 선택하거나, 개별 사용자를 위해 외장 드라이브를 연결하거나, 백업 대상을 변경하거나, Docker 데이터 디렉터리를 이동하는 것과는 다른 개념입니다.
| 당신의 목표 | 이 설정을 사용하세요 | 절충 |
|---|---|---|
| 포털 정적 데이터를 객체 스토리지로 이동합니다. | 제어판 → 저장소 | 사전 공급업체 통합이 필요하며 마이그레이션을 시작합니다. |
| 커뮤니티 서버 데이터를 다른 호스트 디스크에 저장하세요. | Docker 바인드 마운트 또는 볼륨 | 계획된 파일 복사 및 컨테이너 재시작이 필요합니다. |
| 사용자가 Documents에서 외부 계정을 탐색할 수 있도록 허용합니다. | 문서 모듈 타사 연결 | 외부 리소스를 추가하는 기능이며, 포털의 기본 저장소를 대체하지는 않습니다. |
제어판 문서에는 포털 저장소로 Google Cloud Storage, Amazon AWS S3, Rackspace Cloud Storage 및 Selectel Cloud Storage가 나열되어 있습니다. CDN 옵션으로는 Amazon S3와 Selectel만 표시됩니다. CDN은 정적 포털 콘텐츠 배포를 위한 별도의 설정이며, 저장소 선택을 대체하는 것이 아닙니다. 설치 환경에 따라 제공되는 공급자 옵션 및 필드에 대한 자세한 내용은 ONLYOFFICE 저장소 관련 지침을 참조하십시오.
시작하기 전에 무엇을 준비해야 할까요?
제어판에 접근할 수 있는 관리자 계정이 필요합니다. 먼저 포털의 통합 설정에서 선택한 공급자를 연결하세요. 그렇지 않으면 해당 스토리지 옵션을 사용할 수 없거나 비활성화됩니다. S3 버킷 이름 및 지역과 같은 대상에 필요한 세부 정보를 준비하고, 자격 증명과 버킷 권한이 Workspace 서버에서 해당 버킷을 사용할 수 있도록 허용하는지 확인하세요.
저장 위치를 변경하기 전에 최신 백업을 생성하십시오. 제어판 백업 가이드에서 백업 위치 및 포털 백업 생성 방법을 확인할 수 있습니다. 운영 포털인 경우 사용량이 적은 시간대를 선택하고 사용자에게 저장 위치 마이그레이션이 시작될 예정임을 알리십시오. 문서에는 마이그레이션에 시간이 걸릴 수 있다고 명시되어 있지만 정확한 소요 시간은 나와 있지 않으므로 예상 완료 시간을 기준으로 일정을 잡지 마십시오.
제어판에서 포털 저장소를 어떻게 전환하나요?
- 서비스 제공업체를 연결하세요. 포털 설정에서 통합으로 이동합니다. 사용할 클라우드 서비스를 추가하고 연결 설정을 저장합니다. 서비스가 제어판에서 사용 가능해진 후에만 제어판으로 돌아가세요.
- 저장소를 엽니다. 관리자 계정으로 로그인합니다. 시작 페이지에서 제어판을 열거나 설정 → 제어판을 사용합니다. 왼쪽 사이드바의 일반 설정에서 저장소를 선택합니다. 저장소 섹션에서 기본적으로 디스크 기본값이 선택되어 있습니다. 사용할 연결된 타사 공급자를 선택합니다.
- 서비스 제공업체 정보를 입력하고 연결하세요. 해당 서비스에 표시되는 필드를 모두 입력한 후, 연결을 클릭하기 전에 내용을 검토하세요. Amazon S3의 경우, 필수 입력 항목에는 버킷과 리전이 있으며, 서비스 URL과 같은 엔드포인트 설정은 선택 사항입니다. 다른 서비스 제공업체는 입력 항목이 다를 수 있으므로, 선택한 서비스에 필요한 값만 사용하세요.
- 데이터 마이그레이션이 완료될 때까지 기다리세요. [연결]을 클릭하면 페이지가 새로 고쳐지고 데이터 마이그레이션 프로세스가 시작됩니다. 브라우저를 열어 두거나 나중에 제어판으로 돌아가 저장소 페이지를 확인하세요. 마이그레이션이 진행되는 동안에는 저장소 설정을 변경하지 마세요. 마이그레이션이 완료되면 ONLYOFFICE에서 연결된 대상이 선택된 상태로 저장소 페이지가 로드된다고 알려줍니다.
Docker 호스트 디렉토리를 말씀하시는 거라면 어떻게 하시겠어요?
포털의 스토리지 선택기는 Docker의 바인드 마운트된 데이터 디렉터리를 변경하지 않습니다. ONLYOFFICE 커뮤니티 서버 Docker 설명서에서는 /var/www/onlyoffice/Data커뮤니티 서버 데이터의 컨테이너 경로를 `/localhost:100`으로 지정하고, 이를 호스트 폴더(예: `/localhost:100`)에 매핑한 것을 보여줍니다 /app/onlyoffice/CommunityServer/data. 다른 디스크를 사용하려면 컨테이너 대상 경로는 그대로 두고 Compose 파일에서 호스트 측 소스 경로를 수정해야 합니다. 예를 들면 다음과 같습니다.
services:
communityserver:
volumes:
- /srv/onlyoffice/community-data:/var/www/onlyoffice/Data실행 중인 컨테이너가 새롭고 비어 있는 디렉터리를 가리키도록 설정하고 기존 데이터가 그곳에 나타날 것이라고 기대하지 마십시오. 현재 데이터를 백업하고 관련 스택을 중지한 다음, 소유권과 권한을 유지하면서 기존에 마운트된 데이터를 새 호스트 디렉터리로 복사하고 바인드 마운트를 업데이트한 후 다시 시작하십시오. 이전 복사본을 제거하기 전에 포털이 로드되고 파일과 설정이 있는지 확인하십시오. 정확한 서비스 이름과 볼륨 매핑은 Compose 파일 및 설치 방법에 따라 다르므로 실제 구성을 먼저 확인하십시오. 공급업체의 Docker Community Server 데이터 볼륨 설명서 에서 지원되는 컨테이너 경로 및 호스트 마운트 방식을 확인할 수 있습니다.
새로운 위치를 어떻게 확인할 수 있나요?
클라우드 스토리지를 변경한 경우, 제어판 → 스토리지로 이동하여 마이그레이션 후 의도한 공급자가 선택되었는지 확인하십시오. 문서 모듈을 열고 관리자 계정과 일반 사용자 계정으로 기존 파일 몇 개와 새로 업로드한 파일을 테스트하십시오. Docker 호스트 경로를 변경한 경우, 실행 중인 컨테이너의 마운트를 확인하고 예상 호스트 디렉터리가 매핑되는지 확인한 /var/www/onlyoffice/Data다음, 재시작 후 포털에서 파일을 읽고 쓸 수 있는지 확인하십시오. 마이그레이션이 완료되지 않거나 데이터가 누락된 경우, 원본 백업 및 스토리지 복사본을 그대로 유지하고 포털 및 컨테이너 로그를 수집한 후 ONLYOFFICE 지원팀에 문의하여 마이그레이션을 다시 시도하십시오.
Linux에서 ONLYOFFICE Document Server를 완전히 제거하십시오.
문서 서버가 Linux 패키지를 사용하는지 Docker를 사용하는지 확인하고, 해당 구성 요소만 제거한 다음, 공유 서비스를 실수로 삭제하지 않고 나머지 데이터를 확인합니다.
OnlyOffice 공동 편집 지연 현상 해결: 병목 현상 찾기
공동 편집 속도 저하의 원인을 Docker 리소스 사용량, 프록시 연결 또는 문서 로드에서 추적한 다음 측정값에 맞는 해결 방법을 선택하십시오.
Docker에서 ONLYOFFICE Docs에 대한 HTTPS 구성
TLS 종료 위치를 선택하고, 신뢰할 수 있는 인증서와 개인 키를 안전하게 마운트하고, Docker로 컨테이너화된 ONLYOFFICE Docs 서버에 대한 HTTPS 액세스를 확인하십시오.
PHP 앱을 ONLYOFFICE Docs에 연결하고 편집 내용을 저장하세요.
ONLYOFFICE 편집기를 PHP 앱에 내장하고, JWT로 구성 파일에 서명하고, 보안 콜백을 통해 편집된 파일을 저장하세요.
ONLYOFFICE 맞춤법 검사 기능을 원하는 언어로 유지하세요.
문서 전체 또는 선택한 텍스트에 대한 교정 언어를 설정하고, 맞춤법 검사가 활성화되어 있는지 확인하고, 서버 사전이 누락된 경우를 식별합니다.
문서를 다시 열 때 변경 내용 추적 기능을 켜기
ONLYOFFICE 문서에서 모든 사용자에 대해 지속적인 변경 내용 추적 기능을 활성화하고, 편집 내용이 기록되는지 확인하고, 이 설정의 한계를 이해하십시오.
ONLYOFFICE의 Nginx 502 오류를 해결하기 위해 상위 원인을 추적하세요
Nginx, Docker 네트워킹 또는 내부 ONLYOFFICE 서비스에서 502 오류가 발생하는지 확인한 다음, 수정된 상위 서버 및 상태 점검 결과를 검증하십시오.
ONLYOFFICE가 Nextcloud에 저장되지 않을 때 저장 콜백을 추적합니다.
Nextcloud 콜백 경로, 프록시 리디렉션 및 스토리지 로그를 확인하여 ONLYOFFICE 저장 실패를 진단한 다음 편집된 파일이 유지되는지 확인합니다.
ONLYOFFICE 문서 서버의 VPS 메모리 부족 문제를 해결하세요
ONLYOFFICE 메모리 충돌의 원인을 찾고, Docker 제한을 확인하고, VPS RAM 크기를 올바르게 설정하고, 스왑 영역을 안전하게 추가하고, 문서가 제대로 열리고 저장되는지 확인하십시오.