A integração do Collabora Online com o ownCloud Infinite Scale (oCIS) é uma integração WOPI, diferente da configuração usada pelo ownCloud Classic. WOPI, ou Web Application Open Platform Interface, é o protocolo que permite que um pacote de escritório online solicite um arquivo de uma plataforma de armazenamento, edite-o no navegador e grave o resultado de volta.
Essa distinção é importante porque as implementações atuais do Infinite Scale usam o serviço de colaboração integrado como ponte entre oCIS e Collabora. Você não instala o antigo aplicativo ownCloud Classic Collabora e o direciona para um URL de servidor. O aplicativo de escritório é registrado por meio dos serviços de colaboração e registro de aplicativos. A documentação oficial do ownCloud WOPI lista o Collabora como um aplicativo de escritório compatível, enquanto a documentação do serviço de colaboração explica o serviço e suas configurações necessárias.
A partir de outubro de 2026, os lançamentos oficiais do ownCloud no GitHub incluem o Infinite Scale 8.2.0, lançado em 10 de agosto de 2026. O exemplo de implantação do projeto pode evoluir independentemente, portanto, use uma tag de produção testada em vez de presumir que uma imagem rolling release seja apropriada. O exemplo oficial de implantação completa do oCIS recomenda atualmente a tag Collabora CODE 26.04.3.1.1em seu arquivo de ambiente. Verifique os lançamentos oficiais do Infinite Scale e o arquivo de ambiente do exemplo de implantação oficial antes de fixar as versões.
Uma integração de produção normalmente envolve três pontos finais lógicos:
| Ponto final | Propósito | Exemplo |
|---|---|---|
| Escala infinita | APIs de armazenamento e web do ownCloud voltadas para o usuário | https://cloud.example.com |
| Colabore online | Editor de navegador e cliente WOPI | https://office.example.com |
| WOPI/serviço de colaboração | Ponte através da qual o Collabora lê e grava arquivos oCIS. | URL de serviço interno ou nome de host WOPI roteado externamente, dependendo da topologia. |
Verificado: COLLABORATION_APP_ADDR é o URL do Collabora e COLLABORATION_WOPI_SRCidentifica a origem WOPI usada pelo aplicativo do Office. Dependente do ambiente: a origem WOPI não precisa ser um nome de host público separado quando o Collabora e o serviço de colaboração compartilham uma rede de contêiner confiável. O exemplo oficial atual do Compose usa http://collaboration:9300internamente. Uma implantação separada pode exigir um nome de host WOPI HTTPS roteado.
Ação útil: defina sua topologia antes de copiar os valores de configuração. Se todos os componentes estiverem em execução em uma pilha Compose oficial, comece por esse exemplo. Se o Collabora estiver em outro host ou cluster Kubernetes, documente qual nome DNS cada lado consegue resolver e acessar.
Antes de mexer na configuração do oCIS, certifique-se de que os nomes do ownCloud e do Collabora estejam sendo resolvidos corretamente e que o Collabora exponha seu endpoint de descoberta. O Collabora publica recursos WOPI por meio de [inserir URL aqui] /hosting/discovery. Uma verificação básica é:
dig +short cloud.example.com
dig +short office.example.com
curl -fsS https://office.example.com/hosting/discovery | headVocê deverá receber um arquivo XML do ponto de extremidade de descoberta. Se o TLS for encerrado em um proxy reverso, confirme se o certificado apresentado office.example.comé válido do ponto de vista do host ou da rede do contêiner oCIS.
Legenda: Verifique a resolução de nomes e o /hosting/discoveryendpoint do Collabora antes de depurar o registro WOPI no Infinite Scale.
Equívoco comum: visualizar uma página inicial do Collabora em um navegador não comprova que a integração com o WOPI funciona. Comprova apenas que o endpoint da web está acessível. O serviço de colaboração também precisa se conectar ao Collabora, e o Collabora precisa conseguir se conectar à fonte WOPI.
Ação útil: execute testes de conectividade a partir do mesmo namespace de rede que o serviço relevante — por exemplo, de dentro do contêiner de colaboração ao usar o Docker.
O serviço de colaboração não é iniciado automaticamente por uma ocis serverconfiguração genérica em modo supervisionado. A documentação do ownCloud afirma que ele deve ser iniciado explicitamente, pois os administradores podem executar mais de uma instância do serviço de colaboração para diferentes produtos do Office.
As configurações importantes para o Collabora são:
COLLABORATION_APP_NAME=CollaboraOnline
COLLABORATION_APP_PRODUCT=Collabora
COLLABORATION_APP_ADDR=https://office.example.com
COLLABORATION_WOPI_SRC=http://collaboration:9300
OCIS_URL=https://cloud.example.comA fonte WOPI acima corresponde exatamente à topologia usada pelo exemplo oficial atual do Compose: o Collabora e o serviço de colaboração compartilham a mesma rede Docker. Se o seu servidor Collabora for externo, substitua a URL interna pelo endereço que o Collabora consegue acessar.
O serviço também depende da infraestrutura de gateway e provedor de aplicativos da Infinite Scale. Em uma implantação de contêiner dividido, a documentação do ownCloud alerta especificamente que a configuração do oCIS deve ser compartilhada com o contêiner de colaboração, pois os segredos gerados são necessários em todos os serviços. Consulte a definição oficial atual do Collabora Compose .
Legenda: Um processo de serviço de colaboração deve começar com o endereço Collabora pretendido e a fonte WOPI; use registros de serviço reais para confirmar os valores em sua implementação.
Ação útil: se você criou a implantação manualmente, compare seu ambiente com o oficial collabora.ymlem vez de copiar as configurações de um tutorial antigo do cs3org/wopiserver.
O Collabora precisa confiar no host WOPI e ter permissão para renderizar dentro da página web do ownCloud. O exemplo oficial do oCIS Compose passa opções para o Collabora que encerram o TLS no proxy reverso e definem net.frame_ancestorso domínio oCIS. Ele também gera uma chave de prova WOPI antes de iniciar o Collabora.
No exemplo oficial, os valores relevantes do lado do Collabora incluem:
DONT_GEN_SSL_CERT=YES
extra_params:
--o:ssl.enable=...
--o:ssl.ssl_verification=...
--o:ssl.termination=true
--o:welcome.enable=false
--o:net.frame_ancestors=cloud.example.comOs parâmetros exatos do SSL dependem de onde o TLS termina. A configuração recomendada para conexões com a Internet é HTTPS com verificação de certificado habilitada. A INSECURE=trueopção do exemplo existe para configurações locais usando certificados autoassinados; o guia de implantação do ownCloud instrui explicitamente os administradores a removê-la ou defini-la como falsa para servidores públicos.
Legenda: Um endpoint Collabora acessível é um pré-requisito; implantações em produção devem expô-lo via HTTPS com um certificado confiável pelos demais componentes.
Ação útil: se o carregamento do documento resultar em um iframe em branco ou erro de CSP, verifique as ferramentas de desenvolvedor do navegador e os cabeçalhos do proxy reverso. Não desative a verificação de certificado ou as restrições de segurança de conteúdo de forma generalizada apenas para fazer a página carregar.
O serviço de registro de aplicativos do Infinite Scale decide qual aplicativo pode abrir cada tipo MIME. Sua configuração pode definir o tipo MIME, a extensão, o ícone, o aplicativo padrão e se os usuários podem criar novos arquivos desse tipo. A documentação oficial do Registro de Aplicativos descreve esses campos.
Um detalhe fundamental é que o nome do aplicativo usado pelo registro deve corresponder ao provedor de colaboração que você registrou. Os exemplos oficiais de implantação do Collabora usam `<nome_do_aplicativo>` CollaboraOnlinecomo nome do aplicativo COLLABORATION_APP_NAMEe ` Collabora<nome_do_produto>` como nome do produto. Não misture nomes copiados de exemplos antigos sem verificar a versão de implantação.
Após a inicialização, faça login no ownCloud Web e abra um documento do Office compatível. Um fluxo bem-sucedido se parece com isto:
Legenda: O teste final consiste em abrir um documento real do Office no ownCloud Web, editá-lo no Collabora, fechá-lo e confirmar se a versão salva está visível novamente no Infinite Scale.
Ação útil: faça uma pequena alteração em um documento de teste descartável, feche o editor, abra o arquivo novamente e verifique se a alteração persistiu. Uma página que apenas carrega o editor não constitui um teste completo do caminho de escrita.
Para uma implementação convencional do Docker, o caminho de menor risco é ocis_fullo exemplo mantido pelo ownCloud. Ele inclui o Infinite Scale, o serviço de colaboração Collabora e o Traefik. O guia oficial afirma que a implementação requer domínios para oCIS e Collabora e documenta o componente WOPI como parte da pilha. Consulte o guia de implementação completo oficial .
Um arquivo de ambiente típico, orientado à produção, inclui valores conceitualmente semelhantes a:
OCIS_DOCKER_IMAGE=owncloud/ocis
OCIS_DOCKER_TAG=<tested-production-version>
OCIS_DOMAIN=cloud.example.com
COLLABORA=:collabora.yml
COLLABORA_DOCKER_TAG=<tested-collabora-version>
COLLABORA_DOMAIN=office.example.com
INSECURE=falseEm seguida, inicie a pilha com:
docker compose pull
docker compose up -d
docker compose psVerificado: o exemplo oficial atual de proxy reverso permite barras invertidas, pontos de interrogação e caracteres de porcentagem codificados no ponto de entrada HTTPS porque o Collaboration/Collabora os exige. Dependente do ambiente: se você usar Nginx, HAProxy, um controlador de entrada ou um balanceador de carga na nuvem em vez do Traefik, você deve reproduzir o tratamento de URL, o comportamento do WebSocket/proxy, os certificados e os tempos limite necessários nessa plataforma.
Ação útil: não traduza os rótulos do Traefik literalmente para outro proxy. Use-os para entender os requisitos de roteamento e, em seguida, implemente esses requisitos usando a sintaxe documentada do seu proxy.
| Sintoma | Área provável | Confira a seguir |
|---|---|---|
| Não há opção de escritório para DOCX/ODT | Registro de aplicativos / cadastro de provedores | Confirme se o serviço de colaboração está registrado e se o tipo MIME aponta para o nome correto do aplicativo. |
| A página de colaboração funciona, mas o documento não abre. | Acessibilidade WOPI | Verifique se o Collabora consegue acessar COLLABORATION_WOPI_SRCe inspecionar os registros de colaboração. |
| Quadro em branco ou erro CSP do navegador | Configuração de quadro/CSP | Verifique frame_ancestorso CSP do oCIS e a origem real usada pelo navegador. |
| Erro de TLS ou certificado | Proxy reverso / cadeia de confiança | Utilize certificados válidos em produção e teste o HTTPS a partir dos contêineres de serviço, não apenas em sua estação de trabalho. |
| O editor abre, mas falha ao salvar. | Caminho de escrita WOPI / segredos compartilhados | Inspecione os registros de colaboração e do Collabora e confirme se a configuração oCIS compartilhada está montada onde necessário. |
| Um arquivo abre inesperadamente em vários pacotes do Office. | Integrações com vários escritórios | O arquivo de ambiente oficial atualmente alerta contra a ativação de aplicativos do Office sobrepostos, pois o bloqueio de aplicativos no mesmo arquivo não está disponível. |
Sabe-se que o Infinite Scale oferece suporte ao Collabora por meio do WOPI, o serviço de colaboração integrado é a ponte atual e a implementação completa oficial fornece uma arquitetura de referência funcional.
Depende do seu ambiente: se o endpoint WOPI é um URL de contêiner interno ou um nome de host público, onde o TLS termina, qual proxy você usa e se o Collabora é executado na mesma rede que o oCIS.
Não assuma que as instruções para o ownCloud Classic se aplicam ao Infinite Scale. A documentação do Classic que orienta a instalar um aplicativo Collabora/richdocuments ou configurá-lo por meio da interface administrativa do Classic descreve uma arquitetura de produto diferente.
O fluxo de trabalho de integração mais confiável é, portanto: começar com o modelo de implantação oficial do Infinite Scale, comprovar a conectividade de rede e TLS, configurar o serviço de colaboração, confirmar se o Collabora confia e consegue acessar o host WOPI, registrar os tipos MIME relevantes e, finalmente, testar a abertura e o salvamento de um documento real.
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.
