Conecte e colabore online com o ownCloud em escala infinita.

Utilize o serviço de Colaboração do ownCloud Infinite Scale como ponte WOPI entre a interface web e o Collabora Online. Para uma nova instalação, a opção mais segura é ocis_fullo exemplo oficial do ownCloud em Docker Compose, que inclui Infinite Scale, Collaboration, Collabora e Traefik. Configure os URLs públicos do Infinite Scale, Collabora e WOPI, utilize certificados TLS válidos e mantenha a consistência em todos os segredos de serviço. Não configure isso como se o Infinite Scale fosse um servidor ownCloud clássico.

Essa distinção é confirmada na documentação atual do ownCloud: o Infinite Scale integra suítes de escritório por meio do WOPI e seu serviço de Colaboração. Esse serviço substitui o cs3org/wopiservidor externo antigo nas versões mais recentes, portanto, os administradores que atualizam uma implantação antiga devem seguir as instruções de migração para a versão instalada.

1. Verifique os pré-requisitos de versão e de rede.

Confirme a versão exata do Infinite Scale antes de instalar qualquer coisa. A documentação atual do ownCloud lista o serviço de Colaboração na documentação de desenvolvimento da versão 9.0 e afirma que ele deve ser iniciado separadamente quando o Infinite Scale é executado no modo supervisionado. O exemplo completo do ownCloud também alerta que a configuração depende de versões que contenham o serviço de Colaboração e não funciona com versões de produção 5.x. Use a documentação e os arquivos Compose que correspondam à sua versão instalada; não copie um exemplo rolling para um sistema de produção mais antigo sem verificar a compatibilidade.

Para uma implantação pública, planeje nomes de host separados, como `<hostname>` cloud.example.com, office.example.com`<hostname>` e wopi.example.com`<hostname>`. O navegador deve acessar os URLs da nuvem e do Collabora, enquanto o Collabora deve conseguir acessar o endpoint WOPI exposto pelo Infinite Scale. DNS, firewalls e confiança TLS devem funcionar em ambas as direções. Um host acessível do seu laptop, mas não do contêiner do Collabora, não é suficiente.

O exemplo de implantação do ownCloud usa o Traefik como proxy reverso e espera um certificado SSL válido para a configuração do servidor. Sua configuração de teste local pode usar certificados autoassinados, mas instalações públicas não devem desativar silenciosamente a verificação de certificados. Decida quais nomes de host e certificados você usará antes de configurar a infraestrutura.

2. Comece com o exemplo Compose correspondente do ownCloud.

1. Consulte o guia oficial de implantação modular completa do oCIS com WebOffice do ownCloud e o diretório de exemplo ocis_full correspondente . Para produção, verifique uma versão ou tag que corresponda à sua versão do Infinite Scale, em vez de usar a branch rolling do repositório.
2. Analise o .envarquivo de exemplo. Defina `<hostname>` OCIS_DOMAIN, COLLABORA_DOMAIN`<hostname>` e ` WOPISERVER_DOMAIN<hostname>` para os nomes de host que resolvem para o seu servidor. O exemplo habilita o Collabora com o COLLABORA=:collabora.ymlOffice; mantenha essa configuração se o Collabora for o editor de texto que você deseja usar.
3. Configure credenciais de administrador fortes e privadas e siga as orientações de TLS para produção do exemplo. Não mantenha as senhas de exemplo. Se a versão do repositório tiver alterado os nomes das variáveis ​​de ambiente ou o layout dos arquivos, use os arquivos da mesma versão marcada, em vez de misturar instruções de versões diferentes.
4. Revise a configuração do Compose antes de iniciá-lo. Confirme se os serviços Collabora, Collaboration, Infinite Scale e proxy compartilham a mesma rede e configuração. O guia do ownCloud alerta que, se o Collaboration for executado em um contêiner separado, a configuração relevante do Infinite Scale e os segredos gerados deverão ser compartilhados com os outros serviços.

O exemplo de implantação é uma pilha integrada, não uma configuração universal para todas as instalações existentes. Se você já executa o Infinite Scale com systemd, Kubernetes ou um proxy reverso personalizado, mantenha esse modelo de implantação e configure o serviço de Colaboração e o Registro de Aplicativos usando a documentação dessa versão, em vez de iniciar uma segunda pilha completa.

3. Conecte a colaboração para colaborar com a WOPI

As configurações principais identificam o URL do editor e a fonte WOPI acessível externamente. Na documentação atual do serviço, `<app-display-name>` COLLABORATION_APP_NAMEé o nome de exibição do aplicativo, ` <product-> COLLABORATION_APP_PRODUCT` identifica o produto, ` COLLABORATION_APP_ADDR<collaboration-url>` aponta para o Collabora e COLLABORATION_WOPI_SRC`<infinite-scale-url>` é o URL que o Collabora usa para ler e gravar arquivos por meio do Infinite Scale. Uma configuração conceitual seria assim:

COLLABORATION_APP_NAME=CollaboraOnline
COLLABORATION_APP_PRODUCT=Collabora
COLLABORATION_APP_ADDR=https://office.example.com
COLLABORATION_WOPI_SRC=https://wopi.example.com

Use os URLs públicos e o formato de variável reais exigidos pela sua implementação. Se os serviços se comunicarem em uma rede interna do contêiner, o endereço interno pode ser apropriado para uma configuração, enquanto o URL voltado para o navegador pertence a outra. Não substitua um nome de host exclusivo do contêiner por um valor que o Collabora precisa resolver externamente.

O serviço de Colaboração também requer os valores de tempo de execução do Infinite Scale OCIS_URL, OCIS_JWT_SECRET`<nome_do_serviço>` OCIS_REVA_GATEWAY... e ` MICRO_REGISTRY_ADDRESS<nome_do_serviço>`. Estes devem corresponder à instância em execução; o exemplo oficial de pilha completa fornece os relacionamentos de serviço para sua própria rede Compose. Não crie novos segredos para apenas um serviço nem desative as verificações de chave de prova WOPI para contornar uma incompatibilidade. Mantenha a verificação de certificado ativada para certificados públicos confiáveis; COLLABORATION_APP_INSECUREa documentação sobre `<nome_do_serviço>` é apenas uma opção para um certificado de aplicativo WOPI autoassinado, não uma correção geral para produção.

O Registro de Aplicativos controla qual aplicativo do Office é exibido para cada tipo MIME e qual aplicativo é aberto por padrão. Se o Collabora estiver em execução, mas os documentos não mostrarem a opção "Abrir com", verifique a configuração do tipo MIME no registro e seu default_appvalor. O nome usado ali deve corresponder ao nome do aplicativo do Office configurado. O ownCloud documenta isso como uma configuração YAML; variáveis ​​de ambiente não substituem o mapeamento do tipo MIME.

4. Inicie, teste e diagnostique a integração.

Com o exemplo oficial do Compose, valide a configuração renderizada e, em seguida, inicie o stack a partir do diretório de implantação:

docker compose config
docker compose up -d

Se você não estiver usando o exemplo Compose, primeiro inicie os serviços de gateway, provedor de aplicativos e Collabora. No modo supervisionado, o ownCloud documenta explicitamente a inicialização do Collaboration com `--start-collaboration` ocis collaboration server; ele não inicia automaticamente. Certifique-se de que as variáveis ​​de ambiente necessárias estejam preenchidas no processo do serviço Collaboration antes de iniciá-lo.

1. Abra https://office.example.com/hosting/discoveryem um navegador. Um endpoint acessível deve retornar o XML de descoberta da Collabora em vez de um erro de DNS, TLS ou proxy.
2. Inicie sessão no Infinite Scale, abra um documento compatível e escolha Colaborar se a interface do utilizador oferecer várias aplicações do Office. Teste um ficheiro existente e, se estiver ativado no Registo de Aplicações, crie um novo documento.
3. Faça uma pequena alteração, espere o indicador de salvamento estabilizar, feche o editor e abra o arquivo novamente para confirmar se a alteração foi mantida.
4. Se o editor não abrir, verifique os logs do Infinite Scale Collaboration e do App Provider, os logs do Collabora e os logs do proxy reverso no mesmo horário. O erro "Host WOPI não autorizado" indica um problema na configuração de confiança WOPI do Collabora; uma falha no retorno de chamada ou um erro TLS indica um problema de acessibilidade da URL ou de confiança do certificado; uma opção de aplicativo ausente indica um problema no Registro de Aplicativos.

Uma integração bem-sucedida significa que o navegador carrega o editor, a conexão WOPI alcança o Infinite Scale e as edições são mantidas após a reabertura. Os nomes exatos dos contêineres, a configuração de URLs e os locais dos arquivos de configuração dependem da versão do Infinite Scale e do método de implantação. Consulte a documentação do ownCloud correspondente à sua versão para obter esses detalhes, principalmente ao migrar do servidor WOPI externo legado.

Referências: Configuração do serviço de colaboração ownCloud , configuração do registro de aplicativos ownCloud e notas de versão e de migração do Infinite Scale .