Agregar fuentes al servidor de documentos ONLYOFFICE: Docker vs Linux

Para agregar fuentes personalizadas a ONLYOFFICE Document Server, coloque los archivos de fuente con licencia en un directorio accesible para el servidor y ejecute el comando correspondiente /usr/bin/documentserver-generate-allfonts.sh. Para implementaciones de Docker, un directorio de fuentes montado mediante enlace suele ser preferible a copiar archivos en un contenedor en ejecución, ya que se conserva tras la recreación del contenedor.

El método de instalación adecuado depende de dónde se ejecute ONLYOFFICE Docs, con qué frecuencia lo reinstale y si puede aceptar una breve interrupción del servicio mientras se actualiza su catálogo de fuentes.

Elija un método de instalación de fuentes

Las instrucciones oficiales de Docker para fuentes documentan cómo copiar archivos y reconstruir la lista de fuentes. La documentación de Docker sobre montaje de enlace explica por qué montar una carpeta dedicada del host permite que los archivos estén disponibles en los cambios de contenedor. Se trata de opciones de implementación diferentes, no de formatos de fuente diferentes.

Prepare los archivos de fuente y confirme el servidor de destino.

1. Identifique la implementación activa de ONLYOFFICE.

Ejecútalo docker psen el host de Docker si el editor se ejecuta en contenedores. Busca el nombre del contenedor del servidor de documentos en la NAMEScolumna; los ejemplos a continuación usan onlyoffice-documentserver. Reemplaza ese valor si el tuyo es diferente. Una integración con Nextcloud u ownCloud normalmente no cambia el hecho de que las fuentes deben estar instaladas en el servidor de ONLYOFFICE Docs, no solo en el servidor de almacenamiento o en el equipo que visualiza el documento.

docker ps

2. Recopilar archivos de fuentes con licencia

Elija familias tipográficas completas y con licencia, incluyendo los grosores y estilos que sus documentos realmente utilizan. ONLYOFFICE enumera los formatos TrueType y OpenType, como .ttfy .otf, además de otras extensiones de fuente compatibles, en su documentación de fuentes para Linux . Para una implementación inicial predecible, utilice archivos TTF u OTF estándar y verifique el uso permitido en el servidor y el cliente en la licencia de la fuente.

Para el ejemplo de Docker, coloque los archivos en /srv/onlyoffice/custom-fontsel host de Docker. Los nombres de archivo de ejemplo Inter-Regular.ttfson Inter-Bold.ttfilustrativos; utilice los archivos que tenga permiso 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

Ejecute estos comandos desde el directorio que contiene los archivos de fuente. Verifique el contenido de la carpeta antes de continuar. En un sistema administrado, adapte la propiedad y los permisos a su política de seguridad en lugar de hacer que la carpeta sea editable por todos.

Recomendado para Docker: montar el directorio de fuentes de forma persistente.

3. Agregue un montaje de enlace al servicio Compose existente.

En el archivo Compose actual, busque el servicio que ejecuta la imagen del servidor de documentos ONLYOFFICE. Agregue la siguiente entrada debajo de su volumeslista existente; conserve los demás volúmenes, puertos, credenciales y variables de entorno ya configurados:

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

La ruta de origen se encuentra en el host de Docker; el destino está dentro del contenedor. El :rosufijo restringe las escrituras del contenedor en el directorio de fuentes. Monte el customdirectorio dedicado en lugar de reemplazar todo el /usr/share/fontsárbol, lo que podría ocultar las fuentes proporcionadas por la imagen. El Dockerfile oficial de ONLYOFFICE declara el directorio de fuentes TrueType personalizado como un volumen en sus etapas de imagen Community y Enterprise.

Revise la configuración de Compose modificada y aplíquela docker compose up -ddesde el directorio del proyecto. Esto podría recrear el servicio: programe el cambio para cuando los editores puedan cerrar documentos de forma segura. Si utiliza una docker runimplementación simple, agregue el argumento de solo lectura equivalente --mount type=bind,src=/srv/onlyoffice/custom-fonts,dst=/usr/share/fonts/truetype/custom,readonlyal recrear el contenedor.

4. Verifique que el contenedor pueda ver los archivos de fuente.

Una vez que el servicio esté en funcionamiento, inspeccione el directorio montado y, si está disponible, la lista de fontconfig. El nombre de la familia que informa fontconfig puede diferir del nombre del archivo.

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

Para las fuentes Inter de muestra, el segundo comando debería mostrar una familia coincidente si fontconfig las detecta. Si los archivos existen pero la familia no aparece, revise los permisos y ejecute docker exec onlyoffice-documentserver fc-cache -f, luego fc-listvuelva a comprobar. La detección de fuentes por sí sola no rellena el menú del editor ONLYOFFICE.

5. Regenerar el catálogo de fuentes de ONLYOFFICE

Con los archivos presentes dentro del contenedor, ejecute el script de generación de fuentes del servidor de documentos:

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

ONLYOFFICE utiliza este paso para actualizar sus datos y recursos de selección de fuentes. Puede afectar a los servicios del editor activos, por lo que se recomienda ejecutarlo durante un período de mantenimiento adecuado. La variable de entorno de Docker documentada GENERATE_FONTStambién se activa por defecto true, regenerando los datos de las fuentes al iniciar el contenedor; esto resulta útil tras un reinicio, pero no sustituye la instalación de los archivos en una ubicación persistente.

No modifique GENERATE_FONTSni fuerce un reinicio únicamente para ocultar un volumen faltante. Primero verifique que los archivos esperados estén realmente montados.

Alternativas: copia temporal de Docker o Linux nativo

6. Utilice una copia directa del contenedor para una prueba de corta duración.

Si no puede modificar Compose de inmediato, copie un archivo en el contenedor actual y vuelva a construir el catálogo. Esto sigue el enfoque de Docker documentado por ONLYOFFICE y evita tener que reconstruir el contenedor para una prueba rápida.

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

Esto resulta práctico para la resolución de problemas, pero es menos fiable como plan de implementación. Una actualización de la imagen o un nuevo contenedor pueden eliminar el archivo copiado; reiniciar el mismo contenedor no equivale a recrearlo . Si la fuente es necesaria para el trabajo en curso, convierta una prueba exitosa en un montaje de enlace o en una imagen personalizada mantenida por separado.

7. Instalar directamente en un servidor de documentos Linux no contenerizado.

Para instalar un paquete nativo de Linux, coloque los archivos en el directorio de fuentes del sistema del servidor y ejecute el mismo script de regeneración en ese equipo. Este comando no debe ejecutarse en el escritorio de un usuario común.

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

Este método deja los archivos de fuentes en la instalación de Linux en lugar de en un volumen de Docker, pero los administradores deben conservarlos en la gestión de configuración o en las copias de seguridad al reconstruir el host. Consulte el procedimiento oficial de ONLYOFFICE para Linux para el servidor instalado mediante paquete. Si más de un nodo del servidor de documentos da servicio a sus editores, configure la misma familia y variantes en cada nodo.

8. Verifica la fuente en un documento real.

Abra una nueva sesión de edición en la aplicación conectada al servidor de documentos. En un documento DOCX de prueba, seleccione la familia de fuentes instalada en el menú desplegable, introduzca una línea de texto normal, texto en negrita y caracteres no ingleses representativos si la fuente está destinada a uso multilingüe. Guarde, cierre, vuelva a abrir y exporte a PDF. Compare el ancho del texto, el ajuste de línea, la cobertura de glifos y las variantes en negrita/cursiva con un documento de referencia conocido.

Si una fuente no aparece en el menú desplegable, compruebe la ruta del servidor, la salida del comando fc-listy el comando de generación del catálogo, en ese orden. Si la familia aparece pero el diseño cambia, verifique que el documento solicite la familia exacta y que existan los pesos necesarios; de lo contrario, el editor podría sustituirla por otra fuente. Instalar una fuente solo en el escritorio del usuario no la agrega al servidor.

Existe una advertencia específica para cada versión del navegador: las instrucciones de fuentes de ONLYOFFICE indican que, en la versión 8.1.3 o anterior , se debe borrar la caché del navegador y volver a abrir el editor . En versiones posteriores, este paso adicional no es necesario. Si su instalación es anterior, siga el procedimiento de borrado de caché documentado antes de investigar causas más complejas.

La solución se confirma cuando la familia tipográfica personalizada permanece seleccionable tras reabrir el editor, el documento guardado se visualiza correctamente y, en el caso de Docker, las fuentes siguen existiendo tras recrear el servicio con la misma configuración. Si alguna de estas comprobaciones falla, investigue esa capa en lugar de copiar repetidamente las fuentes en el contenedor.