ONLYOFFICE 문서 서버에 글꼴 추가하기: Docker vs Linux

ONLYOFFICE Document Server에 사용자 지정 글꼴을 추가하려면 라이선스가 있는 글꼴 파일을 서버에서 접근 가능한 디렉터리에 배치하고 다음 명령을 실행하십시오 /usr/bin/documentserver-generate-allfonts.sh. Docker 배포 환경에서는 컨테이너를 다시 생성해도 글꼴 디렉터리가 유지되므로 실행 중인 컨테이너에 파일을 복사하는 것보다 바인드 마운트된 글꼴 디렉터리를 사용하는 것이 일반적으로 더 좋습니다.

올바른 설치 방법은 ONLYOFFICE Docs가 실행되는 위치, 재구축 빈도, 그리고 글꼴 카탈로그를 새로 고치는 동안 발생할 수 있는 짧은 서비스 중단을 허용할 수 있는지 여부에 따라 달라집니다.

글꼴 설치 방법을 선택하세요

Docker 공식 글꼴 지침 문서에는 파일 복사 및 글꼴 목록 재구축 방법이 설명되어 있습니다. Docker의 바인드 마운트 참조 문서 에서는 특정 호스트 폴더를 마운트하면 컨테이너 교체 시에도 파일을 사용할 수 있게 되는 이유를 설명합니다. 이는 서로 다른 배포 방식이지, 다른 글꼴 형식이 아닙니다.

글꼴 파일을 준비하고 대상 서버를 확인하세요.

1. 현재 활성화된 ONLYOFFICE 배포를 확인합니다.

docker ps편집기가 컨테이너에서 실행되는 경우 Docker 호스트에서 실행하세요 . 해당 NAMES열에서 문서 서버 컨테이너 이름을 찾으세요. 아래 예시에서는 를 사용합니다 onlyoffice-documentserver. 값이 다르면 해당 값으로 바꾸세요. Nextcloud 또는 ownCloud 통합을 사용하더라도 글꼴은 스토리지 서버나 문서를 보는 컴퓨터뿐 아니라 ONLYOFFICE Docs 서버에도 설치해야 한다는 사실은 일반적으로 변하지 않습니다.

docker ps

2. 라이선스가 있는 글꼴 파일을 수집하세요

문서에서 실제로 사용하는 굵기와 스타일을 포함하여 완전하고 적절한 라이선스가 있는 글꼴 제품군을 선택하십시오. ONLYOFFICE는 Linux 글꼴 설명서.ttf 에서 TrueType 및 OpenType 형식(예: )과 .otf기타 지원되는 글꼴 확장자를 나열합니다 . 처음 배포 시 안정적인 작동을 위해서는 일반 TTF 또는 OTF 파일을 사용하고 글꼴 라이선스에서 허용된 서버 및 클라이언트 사용 권한을 확인하십시오.

Docker 예시의 경우, Docker 호스트에 파일을 준비하세요 /srv/onlyoffice/custom-fonts. 예시 파일 이름은 설명을 위한 Inter-Regular.ttf것이며 Inter-Bold.ttf, 설치 권한이 있는 파일을 사용하세요.

sudo mkdir -p /srv/onlyoffice/custom-fonts
sudo cp Inter-Regular.ttf Inter-Bold.ttf /srv/onlyoffice/custom-fonts/
sudo chmod 644 /srv/onlyoffice/custom-fonts/*.ttf

글꼴 파일이 있는 디렉토리에서 다음 명령을 실행하십시오. 계속 진행하기 전에 폴더 내용을 확인하십시오. 관리되는 시스템에서는 폴더에 모든 사용자가 쓰기 권한을 갖도록 설정하는 대신 보안 정책에 따라 소유권과 권한을 조정하십시오.

Docker 사용 시 권장 사항: 글꼴 디렉토리를 영구적으로 마운트하십시오.

3. 기존 Compose 서비스에 바인드 마운트를 추가합니다.

현재 Compose 파일에서 ONLYOFFICE Document Server 이미지를 실행하는 서비스를 찾습니다. 기존 목록에 다음 항목을 추가합니다 volumes. 이미 구성된 다른 볼륨, 포트, 자격 증명 및 환경 변수는 그대로 유지합니다.

services:
  onlyoffice-documentserver:
    volumes:
      - /srv/onlyoffice/custom-fonts:/usr/share/fonts/truetype/custom:ro

소스 경로는 Docker 호스트에 있고, 대상 경로는 컨테이너 내부에 있습니다. :ro접미사는 컨테이너의 쓰기 작업을 글꼴 디렉터리로 제한합니다. custom전체 디렉터리 트리를 덮어쓰는 대신 지정된 디렉터리를 마운트하세요. 전체 /usr/share/fonts트리를 덮어쓰면 이미지에서 제공하는 글꼴이 가려질 수 있습니다. 공식 ONLYOFFICE Dockerfile은 커뮤니티 및 엔터프라이즈 이미지 단계에서 사용자 지정 TrueType 글꼴 디렉터리를 볼륨으로 선언합니다.

docker compose up -d수정된 Compose 구성을 검토한 다음 프로젝트 디렉터리에서 적용하세요 . 이렇게 하면 서비스가 다시 생성될 수 있습니다. 편집자가 안전하게 문서를 닫을 수 있는 시간에 변경 사항을 적용하도록 예약하세요. 일반 배포를 사용하는 경우 컨테이너를 다시 생성할 때 docker run읽기 전용 인수를 추가하세요 .--mount type=bind,src=/srv/onlyoffice/custom-fonts,dst=/usr/share/fonts/truetype/custom,readonly

4. 컨테이너가 글꼴 파일을 인식하는지 확인합니다.

서비스가 실행되면 마운트된 디렉터리와, 가능하다면 fontconfig 목록을 확인하십시오. fontconfig에서 보고하는 글꼴 패밀리 이름은 파일 이름과 다를 수 있습니다.

docker exec onlyoffice-documentserver ls -l /usr/share/fonts/truetype/custom
docker exec onlyoffice-documentserver fc-list | grep -i 'Inter'

샘플 Inter 글꼴의 경우, 두 번째 명령을 실행하면 fontconfig가 해당 글꼴 패밀리를 감지했을 때 일치하는 패밀리가 표시됩니다. 파일은 존재하지만 패밀리가 나타나지 않으면 권한을 확인하고, 다시 실행한 docker exec onlyoffice-documentserver fc-cache -f후 fc-list다시 확인하십시오. fontconfig를 통한 검색만으로는 ONLYOFFICE 편집기의 메뉴가 채워지지 않습니다.

5. ONLYOFFICE 글꼴 카탈로그를 다시 생성합니다.

컨테이너 안에 파일이 있으면 문서 서버의 글꼴 생성 스크립트를 실행합니다.

docker exec onlyoffice-documentserver /usr/bin/documentserver-generate-allfonts.sh

ONLYOFFICE는 이 단계를 통해 글꼴 선택 데이터와 자산을 새로 고칩니다. 이 작업은 활성 편집기 서비스에 영향을 줄 수 있으므로 적절한 유지 관리 기간에 실행하십시오. 문서화된 Docker 환경 변수 GENERATE_FONTS도 기본적으로 true컨테이너 시작 시 글꼴 데이터를 다시 생성하도록 설정되어 있습니다. 이는 재시작 후 유용하지만 파일을 영구적인 위치에 설치하는 것을 대체할 수는 없습니다.

누락된 볼륨을 숨기기 위해 단순히 재부팅을 변경하거나 강제로 재시작하지 마십시오 GENERATE_FONTS. 먼저 예상되는 파일이 실제로 마운트되었는지 확인하십시오.

대안: 임시 Docker 복사본 또는 네이티브 Linux

6. 단기 테스트에는 컨테이너를 직접 복사하여 사용하세요.

Compose를 즉시 변경할 수 없는 경우, 파일을 현재 컨테이너에 복사한 다음 카탈로그를 다시 빌드하세요. 이는 ONLYOFFICE에서 문서화한 Docker 접근 방식을 따르며, 빠른 테스트를 위해 컨테이너를 다시 빌드하는 것을 방지합니다.

docker cp ./Inter-Regular.ttf onlyoffice-documentserver:/usr/share/fonts/truetype/custom/
docker exec onlyoffice-documentserver /usr/bin/documentserver-generate-allfonts.sh

이 방법은 문제 해결에는 편리하지만 배포 계획으로는 신뢰성이 떨어집니다. 이미지 업데이트나 새 컨테이너 생성 시 복사된 파일이 삭제될 수 있으며, 동일한 컨테이너를 재시작하는 것은 컨테이너 를 새로 생성하는 것과는 다릅니다 . 지속적인 작업에 글꼴이 필요한 경우, 테스트에 성공한 이미지를 바인드 마운트하거나 별도로 관리되는 사용자 지정 이미지로 승격시키는 것이 좋습니다.

7. 컨테이너화되지 않은 Linux 문서 서버에 직접 설치

네이티브 Linux 패키지 설치의 경우, 파일을 서버의 시스템 글꼴 디렉터리에 넣고 해당 호스트에서 동일한 재생성 스크립트를 실행하십시오. 이 명령은 일반 사용자의 데스크톱에서 실행할 명령이 아닙니다.

sudo install -d -m 755 /usr/share/fonts/truetype/custom
sudo install -m 644 Inter-Regular.ttf /usr/share/fonts/truetype/custom/
sudo /usr/bin/documentserver-generate-allfonts.sh

이 방식은 글꼴 파일을 Docker 볼륨 대신 Linux 설치 폴더에 남겨두지만, 관리자는 호스트를 재구축할 때 구성 관리 또는 백업을 통해 글꼴 파일을 보존해야 합니다. 패키지 설치 서버에 대한 자세한 내용은 ONLYOFFICE Linux 공식 절차를 참조하십시오 . 여러 Document Server 노드가 편집기를 지원하는 경우, 각 노드에 동일한 글꼴 패밀리와 변형을 프로비저닝해야 합니다.

8. 실제 문서에서 글꼴을 확인하십시오.

Document Server에 연결된 애플리케이션에서 새 편집 세션을 엽니다. 테스트 DOCX 파일에서 글꼴 드롭다운 메뉴에서 설치된 글꼴 패밀리를 선택하고, 일반 텍스트, 굵은 텍스트, 그리고 다국어 사용을 위한 글꼴인 경우 영어 이외의 문자를 한 줄씩 입력합니다. 파일을 저장하고 닫은 후 다시 열어 PDF로 내보냅니다. 텍스트 너비, 줄 바꿈, 글리프 적용 범위, 굵게/기울임꼴 변형을 알려진 참조 문서와 비교합니다.

드롭다운 메뉴에 글꼴이 없으면 서버 경로, 명령 출력 fc-list, 카탈로그 생성 명령을 순서대로 확인하십시오. 글꼴 패밀리는 나타나지만 레이아웃이 변경되는 경우, 문서에서 정확한 글꼴 패밀리를 요청했는지, 필요한 두께가 존재하는지 확인하십시오. 그렇지 않으면 편집자가 다른 글꼴로 대체할 수 있습니다. 사용자의 바탕 화면에 글꼴을 설치하는 것만으로는 서버에 추가되지 않습니다.

버전별로 주의해야 할 브라우저가 하나 있습니다. ONLYOFFICE의 글꼴 관련 안내에 따르면 버전 8.1.3 이하 에서는 브라우저 캐시를 지우고 편집기를 다시 열어야 합니다 . 이후 버전에서는 이 추가 단계가 필요하지 않습니다. 설치 버전이 오래된 경우, 더 복잡한 원인을 조사하기 전에 안내된 캐시 삭제 단계를 먼저 수행하십시오.

문제가 해결된 것은 편집기를 다시 열었을 때 사용자 지정 글꼴 패밀리를 선택할 수 있고, 저장된 문서가 올바르게 렌더링되며, Docker 환경의 경우 동일한 구성으로 서비스를 다시 생성한 후에도 글꼴이 남아 있는 경우입니다. 이러한 검사 중 하나라도 실패하면 컨테이너에 글꼴을 반복적으로 복사하는 대신 해당 레이어를 조사하십시오.