Seafile과 Collabora를 올바른 WOPI URL로 연결하세요

Seafile과 Collabora Online을 연결하려면 Seafile에서 HTTPS를 활성화하고 Collabora를 배포한 다음 Seafile의 Office 통합 기능을 Collabora의 검색 엔드포인트로 지정해야 합니다. 두 서비스가 동일한 Docker 네트워크에서 실행되는 경우 Seafile의 최신 통합 가이드에서는 내부 URL을 사용합니다 http://collabora:9980/hosting/discovery. Collabora가 별도의 호스트에서 실행되는 경우 해당 서비스의 공개 HTTPS URL을 사용하십시오.

최신 Seafile 관리자 매뉴얼에는 collabora.ymlCompose 통합 및 설정에 대한 자세한 설명이 나와 seahub_settings.py있습니다. 배포 파일은 Seafile 버전에 따라 다를 수 있으므로, 이 예제를 적용할 때는 설치된 버전에 맞는 매뉴얼을 참조하십시오.

시작하기 전에

유효한 TLS 인증서가 있는 HTTPS Seafile 주소를 사용하십시오. Seafile은 Collabora 통합을 위한 필수 조건으로 HTTPS를 명시하고 있습니다.
Collabora가 동일한 Docker 호스트에서 다른 컨테이너로 실행될지, 아니면 별도로 호스팅되는 서비스로 실행될지 확인하십시오.
Seafile의 배포 디렉터리에 대한 관리자 권한이 있어야 합니다 seahub_settings.py.
미리 보기 및 편집을 허용할 문서 형식을 선택하세요. Seafile 설정에서 이러한 확장자 목록을 제어할 수 있습니다.

Seafile과 Collabora는 WOPI를 사용하여 통신합니다. Seafile은 문서 접근 정보를 제공하고, Collabora는 Seafile에 파일을 요청합니다. 검색 URL은 Seafile에게 어떤 Collabora 서비스를 사용해야 하는지, 그리고 해당 서비스가 어떤 편집기 기능을 제공하는지 알려줍니다.

1. Seafile에서 HTTPS를 확인하세요

브라우저에서 Seafile을 열고 일반 주소가 로 시작 https://하고 인증서가 유효한지 확인하십시오. Seafile의 Docker 배포의 경우, 최신 설명서에는 파일 SEAFILE_SERVER_PROTOCOL=https에 설정을 한 .env다음 구성된 역방향 프록시를 통해 HTTPS 설정을 완료하는 방법이 나와 있습니다. 일반 HTTP를 사용하는 공개 Seafile 엔드포인트를 설정하지 마십시오.

# In the Seafile deployment .env file
SEAFILE_SERVER_PROTOCOL=https

실제 인증서와 개인 키는 TLS 프록시 또는 인증서 관리자의 관리 하에 두십시오. 이 설정만으로는 인증서가 발급되거나 역방향 프록시가 구성되지 않습니다. 온라인 오피스 편집을 활성화하기 전에 배포에 필요한 HTTPS 단계를 완료하십시오.

2. Seafile Docker 배포에 Collabora를 추가합니다.

문서화된 동일 호스트 Docker 설정의 경우, 별도의 컨테이너 정의를 작성하는 대신 Seafile에서 제공하는 Collabora Compose 파일을 사용하십시오. Seafile 배포 디렉터리에서 해당 수동 버전에 맞는 파일을 다운로드하고 collabora.yml기존 COMPOSE_FILE목록 에 추가하십시오 .env. 설치에 이미 사용 중인 Compose 파일은 그대로 두십시오.

# Example for a Seafile 14.0 deployment
wget https://manual.seafile.com/14.0/repo/docker/collabora.yml

Seafile에 문서화된 Collabora 변수를 설정하세요 .env.

COLLABORA_IMAGE=collabora/code
COLLABORA_PORT=6232
COLLABORA_USERNAME=your_admin_username
COLLABORA_PASSWORD=use_a_long_unique_secret
COLLABORA_ENABLE_ADMIN_CONSOLE=true
COLLABORA_ENABLE_FILE_LOGGING=false

자격 증명이 포함되어 있으므로 고유하고 강력한 암호를 사용하고 파일 접근을 제한하십시오 .env. 예시 포트는 Seafile 통합 구성에서 노출된 포트이며, 리버스 프록시의 공용 포트라고 가정하지 마십시오. collabora.yml사용 중인 릴리스에 맞는 파일과 프록시 설정을 따르십시오.

배포에 서비스를 추가한 후에는 일반적인 Seafile 절차에 따라 Compose 스택을 시작하거나 업데이트하십시오. 설계상 명시적으로 필요하고 엔드포인트 보안이 확보된 경우가 아니라면 Collabora의 내부 포트를 인터넷에 직접 공개하지 마십시오.

3. Seafile에서 Collabora의 검색 URL을 가리키도록 설정합니다.

활성 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_WEB_APP_FILE_EXTENSION = (
    'odp', 'ods', 'odt', 'xls', 'xlsb', 'xlsm', 'xlsx',
    'ppsx', 'ppt', 'pptm', 'pptx', 'doc', 'docm', 'docx'
)

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

여기에 있는 URL은 http://Seafile의 공식 Docker 네트워크에서 서비스 간 내부 연결 주소입니다. 웹 브라우저에서 접속하는 Seafile 사이트는 여전히 HTTPS를 사용해야 합니다. 이 내부 주소를 별도의 호스트에 배포할 때 복사하지 마십시오.

다른 호스트에서 Collabora를 사용하려면 표준 공용 포트에서 HTTPS를 통해 Collabora를 구성하고, 리버스 프록시가 Collabora의 수신 포트로 요청을 전달하도록 설정하십시오. 기본 URL을 실제 공용 호스트 이름으로 설정하세요(예: ).

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

URL의 호스트 이름이 문서를 열어야 하는 클라이언트에서 유효한 인증서를 표시하고 정상적으로 해석되는지 확인하십시오. 또한 Collabora의 WOPI 허용 목록에 Seafile 서버 호스트를 추가하십시오. Collabora의 공식 Docker 문서에는 aliasgroup허용된 WOPI 호스트를 선언하는 환경 변수에 대한 설명이 나와 있습니다. Seafile에서 사용하는 정확한 호스트 및 스키마와 일치하도록 설정하고, 프로덕션 서버에서는 광범위한 와일드카드 액세스를 피하십시오.

4. 재시작 후 연결을 테스트합니다.

Seahub가 새 Python 설정을 로드하도록 Seafile을 재시작하세요. 패키지, Compose 스택 또는 Kubernetes 설정에 따라 재시작 절차를 따르세요. 서비스 이름과 명령은 배포 환경에 따라 다를 수 있습니다. 새 Compose 파일을 추가한 경우 브라우저 워크플로를 테스트하기 전에 Collabora 컨테이너가 실행 중인지 확인하세요.

Seafile의 웹 인터페이스에서 지원되는 Office 문서를 엽니다. 해당 파일은 Collabora 편집기에서 열리고 내용이 표시되며, 간단한 테스트 변경 사항이 Seafile에 저장됩니다. 문서가 성공적으로 열리는 것을 확인하는 것은 검색 페이지만 확인하는 것보다 훨씬 유용합니다. 브라우저, Seafile, Collabora 및 WOPI 파일 전송 기능을 모두 테스트할 수 있기 때문입니다.

각 연결부를 점검하여 문제를 해결하십시오.

Seahub에서 검색 오류가 발생했습니다. Seafile 서비스에서 Confirm OFFICE_WEB_APP_BASE_URL에 접근할 수 있는지 확인하십시오. 두 컨테이너가 해당 네트워크를 공유하는 경우에만 내부 Docker 서비스 이름을 사용하십시오.
에디터는 로드되지만 파일을 가져올 수 없습니다. Collabora 로그와 Seafile 로그를 확인하십시오. Collabora에서 Seafile WOPI 호스트를 허용하고 Seafile의 HTTPS 인증서를 신뢰하는지 확인하십시오.
동일 호스트에서는 작동하지만 원격으로는 작동하지 않습니다. 내부 URL을 공용 HTTPS 검색 URL로 바꾸고, DNS 및 TLS를 확인하고, 프록시가 Collabora 요청을 9980번 포트로 전달하는지 확인하십시오.
일부 형식만 지원됩니다. 검토 OFFICE_WEB_APP_FILE_EXTENSION및 OFFICE_WEB_APP_EDIT_FILE_EXTENSION. 이러한 목록은 사용자가 필요로 하고 Collabora 배포에서 지원하는 형식으로만 제한하십시오.
재시작 후 설정이 변경되지 않은 것처럼 보이는 경우: 활성화된 Seafile 서비스를 편집 seahub_settings.py하고 올바른 서비스를 재시작했는지 확인하십시오.

독립형 Collabora 노드의 경우, Seafile은 관리자에게 번들로 제공되는 파일을 사용하는 대신 Collabora의 배포 문서를 참조하도록 명시적으로 안내합니다 collabora.yml. 번들 파일은 위에서 설명한 것과 동일한 Docker 호스트/네트워크 구성을 기준으로 작성되었습니다.