Adicionar fontes ao servidor de documentos ONLYOFFICE: Docker vs Linux

Para adicionar fontes personalizadas ao ONLYOFFICE Document Server, coloque os arquivos de fonte licenciados em um diretório acessível ao servidor e execute o comando /usr/bin/documentserver-generate-allfonts.sh. Para implantações em Docker, um diretório de fontes montado via bind é geralmente preferível à cópia de arquivos para um contêiner em execução, pois ele persiste mesmo após a recriação do contêiner.

O método de instalação correto depende de onde o ONLYOFFICE Docs está sendo executado, da frequência com que você o recompila e se você pode aceitar uma breve interrupção do serviço enquanto o catálogo de fontes é atualizado.

Escolha um método de instalação de fontes

O documento oficial de instruções de fontes do Docker explica como copiar arquivos e reconstruir a lista de fontes. A referência de montagem de diretórios do Docker explica por que montar uma pasta dedicada no host torna os arquivos disponíveis em diferentes contêineres. Essas são opções de implantação diferentes, não formatos de fonte diferentes.

Prepare os arquivos de fonte e confirme o servidor de destino.

1. Identifique a implantação ONLYOFFICE ativa.

Execute docker psno host Docker se o editor estiver sendo executado em contêineres. Encontre o nome do contêiner do Servidor de Documentos na NAMEScoluna; os exemplos abaixo usam onlyoffice-documentserver. Substitua esse valor se o seu for diferente. Uma integração com Nextcloud ou ownCloud normalmente não altera o fato de que as fontes devem ser instaladas no servidor ONLYOFFICE Docs, e não apenas no servidor de armazenamento ou no computador que visualiza o documento.

docker ps

2. Colete arquivos de fontes licenciadas

Escolha famílias de fontes completas e devidamente licenciadas, incluindo as variações de peso e estilo que seus documentos realmente utilizam. O ONLYOFFICE lista formatos TrueType e OpenType, como `<td::tf>` .ttfe `<td::tf>` .otf, além de outras extensões de fonte compatíveis, em sua documentação de fontes para Linux . Para uma primeira implementação sem problemas, utilize arquivos TTF ou OTF comuns e verifique o uso permitido no servidor e no cliente na licença da fonte.

Para o exemplo com Docker, prepare os arquivos /srv/onlyoffice/custom-fontsno host do Docker. Os nomes de arquivo de exemplo Inter-Regular.ttfsão Inter-Bold.ttfilustrativos; use os arquivos que você tem permissão para instalar.

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

Execute esses comandos a partir do diretório que contém os arquivos de fonte. Verifique o conteúdo da pasta antes de continuar. Em um sistema gerenciado, adapte a propriedade e as permissões à sua política de segurança, em vez de tornar a pasta gravável para todos.

Recomendado para Docker: monte o diretório de fontes de forma permanente.

3. Adicione uma montagem vinculada ao serviço Compose existente.

No arquivo Compose atual, localize o serviço que executa a imagem do servidor de documentos ONLYOFFICE. Adicione a seguinte entrada à volumeslista existente; mantenha os demais volumes, portas, credenciais e variáveis ​​de ambiente já configurados:

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

O caminho de origem está no host Docker; o destino está dentro do contêiner. O :rosufixo restringe as gravações do contêiner ao diretório de fontes. Monte o customdiretório dedicado em vez de substituir toda a /usr/share/fontsárvore, o que poderia ocultar as fontes fornecidas pela imagem. O Dockerfile oficial do ONLYOFFICE declara o diretório de fontes TrueType personalizado como um volume em seus estágios de imagem Community e Enterprise.

Analise a configuração Compose revisada e aplique-a a docker compose up -dpartir do diretório do projeto. Isso pode recriar o serviço: agende a alteração para um momento em que os editores possam fechar os documentos com segurança. Se você usar uma docker runimplantação simples, adicione o argumento somente leitura equivalente --mount type=bind,src=/srv/onlyoffice/custom-fonts,dst=/usr/share/fonts/truetype/custom,readonlyao recriar o contêiner.

4. Verifique se o contêiner consegue acessar os arquivos de fonte.

Após o serviço estar em execução, inspecione o diretório montado e, se disponível, a listagem do fontconfig. O nome da família relatado pelo fontconfig pode ser diferente do nome do arquivo.

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

Para as fontes Inter de exemplo, o segundo comando deve listar uma família correspondente se o fontconfig as detectar. Se os arquivos existirem, mas a família não aparecer, verifique as permissões e execute o docker exec onlyoffice-documentserver fc-cache -fcomando fc-listnovamente. A detecção pelo fontconfig, por si só, não preenche o menu do editor ONLYOFFICE.

5. Regenerar o catálogo de fontes do ONLYOFFICE

Com os arquivos presentes dentro do contêiner, execute o script de geração de fontes do servidor de documentos:

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

O ONLYOFFICE utiliza esta etapa para atualizar seus dados e recursos de seleção de fontes. Isso pode afetar os serviços de edição ativos, portanto, execute-a durante um período de manutenção adequado. A variável de ambiente Docker documentada GENERATE_FONTStambém tem como padrão o valor `true` true, regenerando os dados de fonte na inicialização do contêiner; isso é útil após uma reinicialização, mas não substitui a instalação dos arquivos em um local permanente.

Não altere GENERATE_FONTSou force uma reinicialização apenas para mascarar um volume ausente. Primeiro, verifique se os arquivos esperados estão realmente montados.

Alternativas: cópia temporária em Docker ou Linux nativo

6. Use uma cópia direta do contêiner para um teste de curta duração.

Se não for possível alterar o Compose imediatamente, copie um arquivo para o contêiner atual e reconstrua o catálogo. Isso segue a abordagem do Docker documentada pela ONLYOFFICE e evita a reconstrução do contêiner para um teste rápido.

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

Isso é conveniente para solucionar problemas, mas menos confiável como plano de implantação. Uma atualização de imagem ou um novo contêiner pode remover o arquivo copiado; reiniciar o mesmo contêiner não é o mesmo que recriá-lo . Promova um teste bem-sucedido para uma montagem de diretório ou uma imagem personalizada mantida separadamente quando a fonte for necessária para o trabalho contínuo.

7. Instale diretamente em um servidor de documentos Linux não conteinerizado.

Para instalar um pacote nativo do Linux, coloque os arquivos no diretório de fontes do sistema do servidor e execute o mesmo script de regeneração nesse host. Este não é um comando para ser executado na área de trabalho de um usuário comum.

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

Essa abordagem mantém os arquivos de fonte na instalação do Linux em vez de um volume do Docker, mas os administradores devem preservá-los no gerenciamento de configuração ou em backups ao reconstruir o host. Consulte o procedimento oficial do ONLYOFFICE para Linux para o servidor instalado por pacote. Se mais de um nó do Document Server atender seus editores, provisione a mesma família e variantes em cada nó.

8. Verifique a fonte em um documento real.

Abra uma nova sessão de edição no aplicativo conectado ao Servidor de Documentos. Em um arquivo DOCX de teste, selecione a família de fontes instalada no menu suspenso, insira uma linha de texto normal, uma linha de texto em negrito e caracteres representativos em outros idiomas, caso a fonte seja destinada ao uso multilíngue. Salve, feche, abra novamente e exporte para PDF. Compare a largura do texto, a quebra de linha, a cobertura de glifos e as variantes em negrito/itálico com um documento de referência conhecido.

Se uma fonte não estiver presente na lista suspensa, verifique o caminho do servidor, a saída do fc-listcomando `source` e o comando de geração de catálogo, nessa ordem. Se a família de fontes aparecer, mas o layout mudar, verifique se o documento solicita a família exata e se os pesos necessários existem; caso contrário, o editor poderá substituí-la por outra fonte. A instalação de uma fonte apenas na área de trabalho do usuário não a adiciona ao servidor.

Existe uma ressalva específica para cada versão do navegador: as instruções de fontes do ONLYOFFICE recomendam limpar o cache do navegador e reabrir o editor na versão 8.1.3 ou anterior . Em versões posteriores, essa etapa adicional não é necessária. Se a sua instalação for mais antiga, siga essa recomendação de limpeza do cache antes de investigar causas mais complexas.

A correção é confirmada quando a família personalizada permanece selecionável após reabrir o editor, o documento salvo é renderizado corretamente e — no caso do Docker — as fontes ainda existem após a recriação do serviço a partir da mesma configuração. Se uma dessas verificações falhar, investigue essa camada em vez de copiar repetidamente as fontes para o contêiner.