Establezca una contraseña segura para la consola de administración de Collabora.

Establezca la contraseña de la consola de administración en línea de Collabora según la forma en que esté implementado su servidor: para la imagen Docker de CODE, configure sus usernamevariables passwordde entorno; para una instalación de paquete de Linux, ejecute coolconfig set-admin-password. Luego, reinicie o vuelva a crear el servicio e inicie sesión en la página de administración para confirmar que las nuevas credenciales funcionan.

Sepa qué contraseña está cambiando

La consola de administración es la página de gestión de servicios de Collabora Online. Es independiente de la cuenta de administrador de Nextcloud u otra plataforma de almacenamiento, y cambiar su contraseña no modifica los inicios de sesión de los usuarios de documentos ni las credenciales que utiliza su plataforma para conectarse a Collabora. Las instalaciones basadas en Docker y paquetes también utilizan flujos de trabajo de configuración diferentes, por lo que debe identificar su implementación antes de realizar cualquier cambio.

Para CODE en Docker, Collabora documenta usernamey passwordcomo configuración del entorno del contenedor. Para instalaciones basadas en paquetes, la herramienta de configuración de Collabora puede establecer la contraseña de administrador de forma interactiva. La referencia de configuración actual marca el uso directo de la admin_console.passwordconfiguración como obsoleto en la mayoría de las plataformas y recomienda PAM o coolconfigen su lugar. Consulte la documentación de la imagen Docker de CODE de Collabora y la referencia de configuración de Collabora .

Prepárese antes de cambiar la credencial.

• Confirme el nombre del host, del contenedor o del servicio, e indique si Collabora se ejecuta en Docker o como un paquete de Linux. Si tiene varias instancias, anote cuál presta servicio a sus usuarios.
• Elige una contraseña única y guárdala en tu gestor de contraseñas o en el almacén de secretos de tu sistema. No uses una contraseña de ejemplo de un tutorial.
• Si administras Docker Compose, realiza una copia de seguridad o confirma el archivo Compose sin incluir ningún secreto. Restringe el acceso al archivo que contiene el secreto; las variables de entorno seguirán siendo visibles para los administradores que puedan inspeccionar el contenedor.
• Mantén el acceso de administrador protegido por tus controles de acceso habituales. Una contraseña segura ayuda, pero no sustituye la limitación del acceso a la página de administración.

Establezca la contraseña para un contenedor Docker de CODE.

En el servicio Compose para Collabora, configure las variables documentadas username. passwordEste ejemplo lee la contraseña de un .envarchivo local en lugar de colocar el secreto directamente en el archivo Compose:

services:
  collabora:
    image: collabora/code
    environment:
      username: admin
      password: "${COLLABORA_ADMIN_PASSWORD:?Set it in .env}"

En el mismo directorio del proyecto, coloque el secreto en .env:

COLLABORA_ADMIN_PASSWORD=replace-with-your-unique-secret

Sustituya el valor de ejemplo por su contraseña real y no realice ningún commit .enven un repositorio compartido. Si el servicio Compose ya existe, cambiar su entorno en el disco no altera el entorno del contenedor en ejecución. Vuelva a crear ese servicio para que la nueva configuración surta efecto.

docker compose up -d --force-recreate collabora

Utilice el nombre real de su servicio Compose si no es collabora. Esto reinicia el contenedor de Collabora; no elimina sus documentos, que se almacenan en su plataforma conectada. Si su implementación se gestiona mediante Kubernetes, Helm u otro plano de control, cambie el secreto o los valores correspondientes allí y aplique el proceso de despliegue normal de esa implementación en lugar de editar manualmente un contenedor en ejecución.

Establecer la contraseña en una instalación de paquete de Linux

En un servidor donde Collabora se instaló como paquete del sistema, ejecute la herramienta de configuración en ese servidor:

sudo coolconfig set-admin-password

La herramienta le pedirá la nueva contraseña, por lo que no es necesario incluirla en el comando de la consola. Introdúzcala cuando se le solicite y repítala si es necesario. A continuación, reinicie el servicio para que cargue la configuración actualizada.

sudo systemctl restart coolwsd

El ejemplo de instalación actual de Nextcloud en Ubuntu también utiliza coolconfig set-admin-passwordy reinicia coolwsddespués de la configuración. El paquete y el gestor de servicios exactos pueden variar en otras distribuciones; consulte las instrucciones de instalación de Collabora de esa distribución si el comando o el nombre del servicio no están disponibles. El ejemplo de Nextcloud está documentado en su guía de configuración para Ubuntu 24.04 .

Inicia sesión y comprueba el resultado.

Abra la consola de administración del servidor Collabora, generalmente en https://collabora.example.com/browser/dist/admin/admin.html, reemplazando el host de ejemplo con la URL pública de su servidor. Inicie sesión con el nombre de usuario de administrador configurado y la nueva contraseña. Un inicio de sesión exitoso confirma que la consola acepta las credenciales; esto no verifica por sí solo que la edición de documentos o la conexión WOPI funcionen correctamente.

1. Si el inicio de sesión falla en Docker, confirme que editó el proyecto Compose que realmente sirve esa URL, que el nombre de la variable es exactamente usernameo password, y que recreó el contenedor después del cambio.
2. Si el inicio de sesión falla tras una actualización de paquete, verifique que coolwsdel reinicio se haya realizado correctamente y que el navegador esté accediendo al servidor previsto. Revise los registros del servicio en busca de errores de configuración sin copiar información confidencial en una publicación de soporte.
3. Si habilitó la autenticación PAM, los valores configurados admin_console.usernamese admin_console.passwordignorarán. En su lugar, utilice la cuenta y la contraseña PAM configuradas para el host; modificar las variables de entorno de Docker CODE no anulará la configuración de PAM.
4. Si el inicio de sesión funciona pero la página de administración no carga, verifique las rutas de Collabora y la política de acceso del proxy inverso. Un problema de proxy o de red es diferente a una contraseña rechazada.

Errores comunes que se deben evitar

No confunda la contraseña de la consola de administración con la contraseña de administrador de Nextcloud, y no la copie ni la pegue en un comando, ya que docker run -e password=...el historial de la consola o la inspección de procesos podrían revelarla. Para una implementación con Compose, guarde la contraseña en un archivo de entorno protegido o en un gestor de secretos disponible y limite el acceso al host de Docker. Además, evite editarla coolwsd.xmldirectamente como primera opción: Collabora identifica la configuración de contraseña anterior como obsoleta en la mayoría de las plataformas.

Si no puede iniciar sesión después de seguir los pasos correctos, primero confirme la instancia y el modo de autenticación, y luego verifique que la nueva configuración se haya aplicado correctamente. Esta secuencia permite distinguir entre un contenedor obsoleto o un host incorrecto y un error tipográfico en la contraseña, y le indica claramente dónde investigar a continuación.