Defina uma senha segura para o Console de Administração do Collabora.

Defina a senha do Console de Administração do Collabora Online de acordo com a forma como seu servidor está implantado: para a imagem Docker do CODE, configure as usernamevariáveis password​​de ambiente; para uma instalação de pacote Linux, execute o comando coolconfig set-admin-password. Em seguida, reinicie ou recrie o serviço e faça login na página de administração para confirmar se as novas credenciais funcionam.

Saiba qual senha você está alterando.

O Console de Administração é a página de gerenciamento de serviços do Collabora Online. Ele é independente da conta de administrador do Nextcloud ou de outra plataforma de armazenamento, e alterar a senha não altera os logins de usuários de documentos nem as credenciais usadas pela sua plataforma para se conectar ao Collabora. As instalações baseadas em Docker e em pacotes também usam fluxos de trabalho de configuração diferentes; portanto, identifique sua implantação antes de fazer qualquer alteração.

Para o CODE em Docker, consulte a documentação da Collabora usernamee passwordas configurações do ambiente do contêiner. Para instalações baseadas em pacotes, a ferramenta de configuração da Collabora permite definir a senha de administrador interativamente. A referência de configuração atual indica que o uso direto dessa admin_console.passwordconfiguração está obsoleto na maioria das plataformas e recomenda o uso do PAM ou coolconfigoutras alternativas. Consulte a documentação da imagem Docker do CODE da Collabora e a referência de configuração da Collabora .

Prepare-se antes de alterar a credencial.

• Confirme o nome do host, do contêiner ou do serviço e se o Collabora está sendo executado no Docker ou como um pacote Linux. Se você tiver várias instâncias, anote qual delas atende seus usuários.
• Escolha uma senha exclusiva e armazene-a em seu gerenciador de senhas ou repositório de segredos de implantação. Não use uma senha de exemplo de um tutorial.
• Se você gerencia o Docker Compose, faça backup ou confirme o arquivo Compose sem confirmar nenhum segredo. Restrinja o acesso ao arquivo que contém o segredo; as variáveis ​​de ambiente ainda estarão visíveis para administradores que podem inspecionar o contêiner.
• Mantenha o endpoint administrativo protegido por seus controles de acesso normais. Uma senha forte ajuda, mas não substitui a limitação de quem pode acessar a página administrativa.

Defina a senha para um contêiner Docker CODE

No serviço Compose do Collabora, defina as variáveis ​​documentadas username. passwordEste exemplo lê a senha de um .envarquivo local em vez de inserir o segredo diretamente no arquivo Compose:

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

No mesmo diretório do projeto, coloque o segredo em .env:

COLLABORA_ADMIN_PASSWORD=replace-with-your-unique-secret

Substitua o valor de exemplo pela sua senha real e não faça commit .envem um repositório compartilhado. Se o serviço Compose já existir, alterar seu ambiente em disco não altera o ambiente do contêiner em execução. Recrie esse serviço para que a nova configuração entre em vigor.

docker compose up -d --force-recreate collabora

Use o nome real do seu serviço Compose, caso não seja collabora. Isso reinicia o contêiner do Collabora; não exclui seus documentos, que são armazenados pela sua plataforma conectada. Se sua implantação for gerenciada pelo Kubernetes, Helm ou outro plano de controle, altere o segredo ou os valores correspondentes lá e aplique o processo de implantação normal dessa implantação, em vez de editar manualmente um contêiner em execução.

Defina a senha em uma instalação de pacote Linux.

Em um servidor onde o Collabora foi instalado como um pacote de sistema, execute a ferramenta de configuração nesse servidor:

sudo coolconfig set-admin-password

A ferramenta solicitará a nova senha, portanto, não é necessário incluí-la no comando do shell. Digite-a quando solicitado e repita-a, se necessário. Em seguida, reinicie o serviço para que ele carregue a configuração atualizada.

sudo systemctl restart coolwsd

O exemplo de instalação atual do Nextcloud no Ubuntu também usa o comando `nextcloud` coolconfig set-admin-passworde reinicia coolwsdapós a configuração. O pacote e o gerenciador de serviços exatos podem variar em outras distribuições; consulte as instruções de instalação do Collabora da sua distribuição caso o comando ou o nome do serviço não estejam disponíveis. O exemplo do Nextcloud está documentado no guia de configuração do Ubuntu 24.04 .

Faça login e verifique o resultado.

Abra o console de administração do host do Collabora, geralmente em https://collabora.example.com/browser/dist/admin/admin.html, substituindo o host de exemplo pelo URL público do seu servidor. Faça login com o nome de usuário de administrador configurado e a nova senha. Um login bem-sucedido confirma que o console aceita as credenciais; ele não verifica por si só se a edição de documentos ou a conexão WOPI estão funcionando corretamente.

1. Se o login falhar no Docker, confirme se você editou o projeto Compose que está servindo essa URL, se o nome da variável é exatamente `<nome_da_variável>` usernameou ` password<nome_da_variável>`, e se você recriou o contêiner após a alteração.
2. Se o login falhar após uma atualização de pacote, verifique se o serviço coolwsdfoi reiniciado corretamente e se o navegador está acessando o servidor correto. Verifique os logs do serviço em busca de erros de configuração, sem copiar informações confidenciais para uma postagem de suporte.
3. Se você habilitou a autenticação PAM, os valores configurados admin_console.usernameserão admin_console.passwordignorados. Em vez disso, use a conta e a senha PAM configuradas para o host; alterar as variáveis ​​de ambiente do Docker não substituirá o PAM.
4. Se o login funcionar, mas a página de administração não carregar, verifique as rotas e a política de acesso do Collabora no proxy reverso. Um problema de proxy ou de rede é diferente de uma senha rejeitada.

Erros comuns a evitar

Não confunda a senha do Console de Administração com a senha de administrador do Nextcloud e não cole o segredo em um comando, caso docker run -e password=...o histórico do shell ou a inspeção de processos possam expô-lo. Para uma implantação do Compose, mantenha o segredo em um arquivo de ambiente protegido ou em um gerenciador de segredos disponível e limite o acesso ao host do Docker. Além disso, evite editar coolwsd.xmldiretamente como primeira opção: a Collabora identifica a configuração de senha legada como obsoleta na maioria das plataformas.

Se você não conseguir fazer login seguindo o caminho correto, primeiro confirme a instância e o modo de autenticação e, em seguida, verifique se a nova configuração foi realmente aplicada. Essa sequência distingue um contêiner desatualizado ou um host incorreto de um erro de digitação na senha e fornece um próximo passo claro para a investigação.