Collabora Online을 Seafile에 연결하는 방법: 설정 옵션 및 단계

Seafile은 WOPI 프로토콜을 통해 지원되는 오피스 파일을 Collabora Online에서 열 수 있습니다. 이 프로토콜을 통해 스토리지 서버와 온라인 편집기는 문서 정보와 파일 콘텐츠를 교환할 수 있습니다. 최적의 배포 환경은 Seafile 실행 위치, HTTPS 및 역방향 프록시 관리 방식, 그리고 Collabora를 동일한 Docker 네트워크에 설치할지 또는 별도의 서버에 설치할지에 따라 달라집니다.

이 가이드는 최신 Seafile 관리자 매뉴얼의 Collabora 통합 지침(Seafile 14.0 문서, 2026년 10월 6일 확인)을 따릅니다. Docker Compose 파일과 이미지 태그는 변경될 수 있으므로 이전 튜토리얼의 전체 Compose 구성을 복사하는 대신 설치된 Seafile 버전에 맞는 파일을 사용하십시오.

어떤 배포 방식을 선택해야 할까요?

새로운 단일 노드 Docker 배포의 경우 Seafile에서 제공하는 파일을 시작하십시오 collabora.yml. 기존의 독립형 Collabora 서버 또는 클러스터의 경우 Collabora 자체 설치 지침을 따르고 Seafile의 검색 URL을 외부 Collabora 주소로 설정하십시오. Seafile 통합 가이드에서는 Seafile에 HTTPS를 사용해야 하며, 별도의 Collabora 노드가 표준 포트 443에서 HTTPS를 사용하고 Collabora 서비스의 포트 9980으로 역프록시해야 한다고 명시하고 있습니다. Seafile Collabora 온라인 통합 가이드 및 Collabora 설치 문서를 참조하십시오 .

시작하기 전에

• Seafile 서버에 유효한 인증서를 사용하여 HTTPS로 접속할 수 있는지 확인하십시오. Seafile 가이드에서는 이 통합을 위해 HTTPS를 명시적으로 요구합니다.
• 배포 유형을 확인하십시오. 현재 Docker 단일 노드, 바이너리 설치 또는 다중 호스트/클러스터 설정 중 어떤 유형인지 확인해야 합니다. Compose 파일 이름과 프록시 라우팅은 해당 선택에 따라 달라집니다.
• office.example.comCollabora에 사용자의 브라우저가 독립적으로 접속할 경우 , 와 같은 Collabora 호스트 이름을 선택하십시오 . Seafile을 구성하기 전에 해당 호스트 이름의 DNS 및 TLS 인증서가 작동하도록 설정하십시오.
• Seafile seahub_settings.py및 Docker .env파일에 대한 관리자 권한을 확보하십시오(해당하는 경우). Collabora 관리자 암호는 보호된 환경 파일에 저장하고 스크린샷, 로그 또는 공개 저장소에 게시하지 마십시오.

Seafile의 문서에는 지원되는 Compose 레이아웃에 대한 동일 호스트 Docker 단계가 설명되어 있습니다. 리버스 프록시, Compose 프로젝트 또는 네트워크 환경이 다를 경우 아래 예시 값을 시작점으로 활용하고, 실제 배포 환경에서 서비스 이름과 경로를 확인하십시오.

옵션 A: Seafile Docker 배포에 Collabora 추가

1. Collabora 공식 Compose 파일을 추가합니다.

Seafile Compose 구성 파일이 있는 디렉토리에서 사용 중인 Seafile 버전에 맞는 Collabora 파일을 다운로드하십시오. 현재 설명서에서 Seafile 14.0의 경로는 다음과 같습니다.

wget https://manual.seafile.com/14.0/repo/docker/collabora.yml

기존 목록을 열고 .env추가합니다 . 현재 항목은 모두 유지됩니다. 예를 들어, Seafile 서버, Caddy 및 SeaDoc 파일이 이미 목록에 있는 설치의 경우 Collabora 파일은 기존 목록을 덮어쓰는 대신 추가됩니다.collabora.ymlCOMPOSE_FILE

COMPOSE_FILE='seafile-server.yml,caddy.yml,seadoc.yml,collabora.yml'

실제 목록은 다를 수 있습니다. 이 예시와 일치시키기 위해 현재 리버스 프록시 또는 기타 서비스를 제거하지 마십시오. Compose 파일은 Seafile에 포함된 배포에서 예상하는 컨테이너 및 네트워크 설정을 지정합니다.

2. Collabora 환경 변수 값을 설정합니다.

Seafile에서 제공하는 변수들을 동일한 .env파일에 추가하세요. 현재 예시에서는 롤링 collabora/code이미지 이름을 사용하고 있지만, 재현 가능한 업그레이드가 필요한 팀은 환경에서 지원하는 Collabora 릴리스 태그를 선택하여 고정해야 합니다. 작동 중인 에디터 서비스를 변경하기 전에 릴리스 노트를 검토하고 업그레이드를 테스트하세요.

COLLABORA_IMAGE=collabora/code
COLLABORA_PORT=6232
COLLABORA_USERNAME=admin
COLLABORA_PASSWORD=replace-with-a-long-random-secret
COLLABORA_ENABLE_ADMIN_CONSOLE=true
COLLABORA_REMOTE_FONT=
COLLABORA_ENABLE_FILE_LOGGING=false

포트 값은 Seafile Compose 예제에서 사용하는 호스트 연결 포트입니다. Collabora는 컨테이너 내부에서 9980번 포트를 사용합니다. 관리 콘솔은 비공개로 유지하거나 프록시/방화벽에서 접근을 제한하십시오. 위의 사용자 이름과 비밀번호는 예시이며, 고유한 자격 증명을 선택하고 파일을 안전하게 보호하십시오. 조직에서 관리 콘솔이 필요하지 않은 경우, Compose 템플릿에서 지원하는 설정에 따라 비활성화하십시오.

3. Seafile의 WOPI 연결을 구성합니다.

Collabora 통합 설정을 편집 seahub_settings.py하고 추가합니다. 동일한 Compose 네트워크에 있는 컨테이너의 경우 Seafile의 현재 예제에서는 내부 서비스 이름을 사용합니다 collabora.

OFFICE_SERVER_TYPE = 'CollaboraOffice'
ENABLE_OFFICE_WEB_APP = True
OFFICE_WEB_APP_BASE_URL = 'http://collabora:9980/hosting/discovery'
WOPI_ACCESS_TOKEN_EXPIRATION = 30 * 60
OFFICE_PREVIEW_MAX_SIZE = 30 * 1024 * 1024
ENABLE_OFFICE_WEB_APP_EDIT = True

OFFICE_WEB_APP_FILE_EXTENSION = (
    'odp', 'ods', 'odt', 'xls', 'xlsb', 'xlsm', 'xlsx',
    'ppsx', 'ppt', 'pptm', 'pptx', 'doc', 'docm', 'docx'
)
OFFICE_WEB_APP_EDIT_FILE_EXTENSION = (
    'odp', 'ods', 'odt', 'xls', 'xlsb', 'xlsm', 'xlsx',
    'ppsx', 'ppt', 'pptm', 'pptx', 'doc', 'docm', 'docx'
)

내부 검색 URL은 공유 Docker 네트워크에서 Seafile과 Collabora 간의 통신을 위한 것입니다. 사용자의 브라우저 또한 통합에서 제공하는 Collabora 주소에 접근할 수 있어야 합니다. 공식 Compose 파일 및 프록시 설정을 따라 브라우저에서 접근 가능한 경로가 안전하게 공개되도록 하십시오. Docker 내부에서만 확인되는 컨테이너 전용 호스트 이름은 공용 브라우저 URL로 사용할 수 없습니다.

파일 확장자 목록은 사용자가 필요로 하고 Collabora 빌드에서 지원하는 형식으로만 제한하세요. 위에 표시된 미리 보기 크기 설정은 Seafile의 현재 예시에서 30MiB 값입니다. 더 큰 문서의 경우 메모리 및 성능에 미치는 영향을 고려하여 의도적으로 제한을 변경해야 할 수 있습니다.

4. 서비스를 시작하거나 업데이트합니다.

Compose 구성을 검증한 다음 프로젝트 디렉터리에서 스택을 시작하십시오.

docker compose config
docker compose up -d

Seafile 가이드에서는 설정을 변경한 후 Seafile을 재시작하라고 안내합니다 seahub_settings.py. Docker 배포 환경에서는 업데이트된 Compose 설정이 적용됩니다. 설정 변경 사항이 적용되지 않으면 해당 릴리스에 맞는 재시작 방법을 사용하여 Seafile 서비스를 다시 시작하십시오. 전체 스택을 중지할 의도가 아니라면 docker compose up -d광범위한 설정 변경은 피하는 것이 좋습니다 .docker compose down

옵션 B: Seafile을 다른 호스트의 Collabora에 연결합니다.

Collabora의 공식 배포 및 리버스 프록시 지침에 따라 Collabora를 설치하고 노출하십시오. 일반 공용 엔드포인트에는 HTTPS를 사용하고, Collabora의 내부 포트 9980으로 요청을 프록시하십시오. Seafile 호스트가 Collabora에 연결할 수 있고, Collabora도 Seafile의 HTTPS 주소에 연결할 수 있는지 확인하십시오. WOPI 문서 로딩에는 양방향 연결이 모두 중요합니다.

이전 섹션의 다른 Seafile 설정은 그대로 유지하되, 검색 설정을 실제 Collabora 호스트 이름으로 변경하십시오.

OFFICE_WEB_APP_BASE_URL = 'https://office.example.com/hosting/discovery'

실제 호스트 이름과 인증서를 사용하십시오. Seafile과 Collabora가 해당 이름으로 확인되는 네트워크를 실제로 공유하는 경우가 아니라면 내부 Docker 서비스 이름을 포함하지 마십시오. 별도의 호스트를 사용하면 리소스 및 유지 관리 제어를 독립적으로 수행할 수 있지만 DNS, 방화벽, 인증서 및 역방향 프록시 관련 작업이 추가됩니다. Seafile 클러스터의 경우 단일 노드 Compose 네트워크가 적용된다고 가정하지 말고 클러스터의 프록시 및 서비스 검색 설계를 따르십시오.

연결이 제대로 되었는지 확인하는 방법

1. 별도의 호스트를 사용하는 경우 브라우저에서 여세요 https://office.example.com/hosting/discovery. 동일 호스트 설정의 경우 프록시에서 게시한 Collabora 공개 경로를 테스트하세요. 응답이 성공하면 검색 엔드포인트에 연결할 수 있음을 확인하는 것이지만, 그 자체로 WOPI 편집이 작동함을 증명하는 것은 아닙니다.
2. Seafile에 로그인하고 구성된 확장 프로그램 목록에 포함된 작고 민감하지 않은 , 또는 파일을 엽니 .docx다 .xlsx..odt
3. Collabora에서 파일이 제대로 열리는지 확인하고, 간단한 수정을 한 후 저장이 완료될 때까지 기다렸다가 편집기를 닫으세요.
4. Seafile에서 파일을 다시 열고 변경 사항이 유지되었는지 확인하십시오. 더 확실한 확인을 위해 파일을 다운로드하여 예상 내용과 일치하는지 확인하십시오.

안전하게 수정할 수 있는 파일로 테스트하십시오. 저장에 성공하지 못한 편집기가 보이는 것은 부분적인 성공일 뿐입니다. WOPI는 파일을 검색하고 편집된 버전을 Seafile에 반환할 수 있어야 합니다.

흔히 발생하는 고장 및 점검해야 할 부분

Docker 로그는 Seafile 문서를 참조하십시오 docker logs seafile-collabora. Seafile/Seahub 로그와 Collabora 출력 결과를 함께 확인하고 프록시에서의 요청을 비교 분석하십시오. 문서 URL이나 기타 민감한 운영 정보가 노출될 수 있는 경우, 상세 로깅 또는 파일 로깅을 무기한 활성화하지 마십시오. Collabora 공식 문제 해결 가이드에서 Collabora 측 오류에 대한 추가 점검 사항을 확인할 수 있습니다.

어떤 선택이 합리적일까요?

Seafile 설치 환경이 단일 Docker 호스트이고, 지원되는 Compose 연결 기능을 사용하며, Seafile과 CPU 및 메모리를 공유하는 것이 허용되는 경우 번들 컨테이너를 선택하십시오. 이미 Collabora 호스트를 운영 중이거나, 독립적인 용량 또는 업그레이드 일정이 필요하거나, 다중 호스트 아키텍처를 통합하고 HTTPS 및 네트워크 라우팅을 안정적으로 유지할 수 있는 경우에는 별도의 Collabora 호스트를 선택하십시오. 어느 경우든 사용 중인 Seafile 릴리스에 해당하는 문서를 참조하고, 브라우저에 연결되는 엔드포인트를 안전하게 유지하며, 사용자가 온라인 편집 기능을 사용하기 전에 문서 열기 및 저장 기능을 모두 확인하십시오.