Se um contêiner do Collabora Online Development Edition (CODE) for encerrado imediatamente em uma máquina ARM64, comece verificando a compatibilidade da arquitetura antes de alterar as configurações de rede, certificados ou WOPI. Em 7 de outubro de 2026, o collabora/coderepositório oficial listava linux/arm64variantes nativas para as versões atuais, incluindo a tag atual lateste a versão 26.04.4.2.1. Isso significa que um host ARM64 moderno normalmente não precisa de emulação x86 apenas para executar o CODE. O fluxo de trabalho mais útil para iniciantes é confirmar a arquitetura do host, inspecionar a tag exata da imagem, remover qualquer configuração AMD64 forçada, obter uma imagem compatível com ARM64 e somente então solucionar problemas de configuração no nível do aplicativo.
Este guia se concentra na falha de inicialização em si. Ele não pressupõe que todos os problemas do ARM64 tenham a mesma causa. Se o contêiner iniciar com sucesso, mas o Nextcloud, o ownCloud ou outro host WOPI não conseguir se conectar a ele, isso representa uma etapa diferente de solução de problemas.
ARM64 é uma arquitetura de CPU ARM de 64 bits. O Linux geralmente a reporta como `ARM64` aarch64, enquanto o Docker normalmente rotula o mesmo alvo como ` ARM64` linux/arm64. AMD64 , também chamada de x86-64, é uma arquitetura de CPU diferente. Uma imagem de contêiner contém binários compilados para uma ou mais arquiteturas; o Docker pode selecionar automaticamente a variante correta somente quando a tag da imagem fornece um manifesto compatível.
Uma imagem multiplataforma é uma única tag de imagem cujo manifesto de registro aponta para compilações de imagem separadas para arquiteturas como AMD64 e ARM64. A documentação do Docker informa que, ao baixar uma imagem multiplataforma, a variante correspondente ao host é selecionada automaticamente. Consulte a documentação de imagens multiplataforma do Docker para obter detalhes sobre o comportamento subjacente.
Para o Collabora CODE especificamente, consulte a lista oficial de tags collabora/code no Docker Hub em vez de confiar em um tutorial antigo. Quando este artigo foi consultado em 7 de outubro de 2026, a tag collabora/code estava incluída lateste também havia uma tag dedicada listada. Versões fixadas mais antigas podem ser diferentes, portanto, a tag que você realmente implanta é mais importante do que uma afirmação genérica de que "o Collabora suporta ARM".26.04.4.2.1linux/arm64latest-arm64
docker-compose.ymlcomando atual ou de implantação.O objetivo é simples: o Docker deve baixar uma imagem ARM64, o contêiner deve permanecer em execução em vez de ser encerrado imediatamente e seus registros devem progredir para a inicialização normal do Collabora em vez de falhar com um erro de arquitetura.
Execute essas verificações na máquina que realmente executa o contêiner do Collabora:
uname -m
docker info --format '{{.Architecture}}'
docker versionEm um host Linux ARM nativo de 64 bits, uname -mgeralmente retorna aarch64, enquanto o Docker deve retornar arm64. Esses nomes se referem à mesma família de arquitetura neste contexto.
Se o Docker reportar AMD64 mesmo que a máquina física seja ARM64, verifique se você está usando um contexto Docker remoto, uma máquina virtual ou o Docker Desktop com um backend diferente. Corrija essa ambiguidade antes de continuar. Caso contrário, você poderá inspecionar um sistema enquanto realiza a implantação em outro.
Os sinais típicos incluem exec format erroruma mensagem de registro indicando a existência de um contêiner no matching manifest for linux/arm64ou um serviço Compose explicitamente configurado com `--no- platform: linux/amd64contêiner-exit`. Essas mensagens são evidências mais fortes de uma incompatibilidade de plataforma do que a saída genérica "contêiner encerrado".
Não presuma que todas as tags históricas tenham o mesmo suporte de plataforma que as atuais latest. Inspecione os metadados do registro da tag em sua implantação:
docker buildx imagetools inspect collabora/code:latestA documentação do comando `buildx imagetools inspect` do Docker explica como ele exibe as plataformas contidas em uma imagem de registro. Você também pode usar o comando docker manifest inspect`docker-compose up`; o Docker documenta esse comando em sua referência de inspeção de manifesto .
Se linux/arm64aparecer, você pode usar a tag multiplataforma e deixar o Docker selecionar a imagem correta. Para um teste de solução de problemas explícito, o repositório oficial também lista latest-arm64. Para implantações de produção de longa duração, uma tag com versão exata que você testou geralmente é mais fácil de reproduzir do que latest, porque latestmuda conforme novas versões são publicadas.
Se a sua tag fixada não incluir ARM64, você tem três opções:
| Escolha | Melhor ajuste | Troca |
|---|---|---|
| Mover para uma tag de código ARM64 nativa atual | A maioria dos servidores ARM64 e laboratórios domésticos | Você deve validar a compatibilidade da versão e suas configurações de integração. |
| Continue usando a versão antiga com emulação AMD64. | Testes de compatibilidade de curto prazo | Complexidade adicional e possível sobrecarga de desempenho; não é a solução preferida quando existe uma imagem nativa. |
| Mantenha a versão antiga em um host AMD64. | Fixação estrita de versões onde o risco de atualização é inaceitável. | Requer hardware diferente ou capacidade de máquina virtual. |
Um erro comum não está na imagem do Collabora em si, mas em um arquivo de implantação que força a plataforma errada. O Docker Compose define platformo sistema operacional e a arquitetura de destino usados para selecionar a variante da imagem. A referência do serviço Docker Compose mostra valores como linux/arm64/v8.
Em um host ARM64, essa configuração é suspeita:
services:
collabora:
image: collabora/code:latest
platform: linux/amd64Se você não precisa de emulação, remova essa linha e deixe o Docker escolher a variante nativa do host. Como alternativa, especifique-a platform: linux/arm64quando desejar que a arquitetura seja explícita.
Em seguida, remova apenas o contêiner com falha e baixe a imagem novamente. Não exclua dados persistentes, a menos que tenha um motivo específico para fazê-lo.
docker compose down
docker image rm collabora/code:latest 2>/dev/null || true
docker pull --platform linux/arm64 collabora/code:latest
docker compose up -dSe você estiver usando a tag de arquitetura dedicada para uma execução de diagnóstico, substitua-a collabora/code:latest-arm64. Depois de confirmar que a implantação funciona, considere fixar uma versão exata, como uma tag 26.04.x testada, em vez de deixar um sistema de produção em uma tag em constante mudança.
Após recriar o contêiner, verifique o estado e os registros:
docker compose ps
docker compose logs --tail=100 collaboraPara uma implantação de contêiner único, os comandos equivalentes são docker ps -ae docker logs --tail=100 <container-name>.
O primeiro critério de sucesso é que o contêiner permaneça ativo e não apresente mais erros de manifesto ou formato executável. Somente depois disso você deve verificar a acessibilidade da porta 9980, as configurações de proxy reverso, o TLS, os hosts WOPI permitidos ou a integração do aplicativo. A documentação oficial do CODE Docker da Collabora é o local adequado para verificar os parâmetros de implantação atuais.
A emulação pode ser útil quando o software existe apenas para outra arquitetura de CPU, mas as imagens atuais do Collabora CODE incluem variantes ARM64. Adicionar a emulação primeiro pode mascarar o problema real e adicionar mais um componente. Prefira o ARM64 nativo quando a versão do CODE que você precisa o fornecer.
A disponibilidade da plataforma está vinculada a uma tag de imagem e manifesto específicos. Uma tag atual pode ser compatível com ARM64, enquanto uma versão mais antiga não. Verifique a referência exata no seu arquivo Compose.
Isso pode fazer com que um host ARM64 utilize a variante x86-64 mesmo quando existir uma imagem ARM64 nativa. Remova a configuração de sobrescrita, a menos que você tenha um motivo deliberado e comprovado para a emulação.
Um exec format errorerro ocorre antes que o Collabora consiga processar de forma significativa a maior parte da configuração em nível de aplicação. Corrija a seleção da arquitetura primeiro. A resolução de problemas de rede e WOPI vem depois.
Incompatibilidades de arquitetura normalmente não exigem a destruição de dados persistentes. Mantenha o escopo da correção restrito para que o rollback permaneça fácil.
Se o manifesto incluir claramente linux/arm64essa variante e o Docker a utilizar, a arquitetura deixa de ser a principal explicação. Nesse ponto, capture:
docker compose psoudocker ps -aEm seguida, investigue permissões, caminhos montados, perfis de segurança, pressão de memória, conflitos de porta, certificados ou configuração WOPI de acordo com a mensagem de log real. Evite alternar repetidamente entre arquiteturas depois de verificar se a imagem em execução é ARM64.
platformconfiguração.Em um sistema ARM64 moderno, a solução preferida geralmente não é a emulação. Conforme verificado em 7 de outubro de 2026, as tags oficiais atuais do Collabora CODE incluem imagens nativas para ARM64. Confirme aarch64o arm64host, inspecione o manifesto da imagem, elimine referências obsoletas ou forçadas ao AMD64, baixe novamente a imagem compatível com ARM64 e verifique se o contêiner permanece em execução. Essa sequência mantém a solução de problemas simples e evita que alterações irrelevantes em SSL, proxy ou WOPI obscureçam uma incompatibilidade básica de plataforma.
O Microsoft Access é um aplicativo de banco de dados para Windows que permite armazenar registros relacionados, criar consultas, elaborar formulários de entrada de dados e gerar relatórios. Saiba como ele funciona e quando é adequado para você.
Aprenda como ajustar a altura e a largura das linhas de grade no Word 2010, alterar a frequência das linhas visíveis e definir o espaçamento horizontal e vertical da grade de desenho subjacente.
Aprenda como importar um arquivo PST para o Outlook 2010 ou exportar emails, contatos, calendário e tarefas. Siga os menus corretos e evite pastas ausentes ou duplicadas.
Recupere uma senha esquecida de um arquivo PST do Outlook seguindo os passos atuais do Kernel, incluindo como identificar o arquivo correto, fazer um backup e verificar as limitações da ferramenta.
Use o suplemento LiveWeb para inserir um site em um slide do PowerPoint, definir seu tamanho e comportamento de atualização e verificar a compatibilidade antes da apresentação.
Aprenda como criar e organizar contatos no Outlook 2010, criar um grupo de contatos e selecionar pessoas salvas na Agenda de Endereços ao endereçar um e-mail.
Crie um campo de Hiperlink no Access 2010 no Modo de Exibição de Design e, em seguida, adicione e teste links para sites, e-mails ou arquivos compartilhados com os detalhes de destino corretos.
Use o Inspetor de Documentos do Word para revisar detalhes do autor, comentários, alterações controladas, texto oculto e outros dados antes de compartilhar, e descubra o que a verificação pode não detectar.
Mova guias personalizadas da Faixa de Opções e comandos da Barra de Ferramentas de Acesso Rápido no Office 2010 com um arquivo .exportedUI e proteja as configurações já existentes no seu computador de destino.
Crie papel quadriculado imprimível no Excel ajustando as dimensões das células, definindo uma área de impressão, escolhendo papel A4 e ativando a impressão de linhas de grade no Excel para desktop.
