Configure o URL público do Nextcloud para que ele possa se acessar.

Defina a URL base canônica do Nextcloud para o endereço que os usuários realmente utilizam e, em seguida, certifique-se de que o servidor Nextcloud consiga resolver e se conectar a esse endereço. Para uma instalação HTTPS típica, a configuração principal é `https://localhost:8080/` overwrite.cli.url; se o Nextcloud estiver atrás de um proxy reverso, corrija também o protocolo encaminhado ou o diretório raiz da web somente quando sua configuração exigir.

Um aviso descrito como “O servidor não possui um endereço de saída” pode se referir à falha do Nextcloud em gerar ou verificar um endereço de retorno para seu próprio serviço web. Na documentação atual do Nextcloud, várias verificações de configuração exigem que o servidor web acesse um de seus domínios confiáveis ​​ou o endereço configurado overwrite.cli.url. Isso é diferente de um aviso geral de “sem conexão com a Internet”, que aponta para problemas de DNS de saída, firewall ou acesso de proxy a serviços externos.

Qual URL o Nextcloud deve usar?

Escolha a URL estável que seus usuários normalmente acessam. Por exemplo, se os usuários acessarem `https://example.com/` https://cloud.example.com, use exatamente o mesmo esquema e nome de host. Se a instalação for servida a partir de um subdiretório, como `/usr/local/bin` https://example.com/nextcloud, inclua `/ usr/local /nextcloud/bin` na URL base. Evite usar `/usr/local/bin` localhostou um nome de contêiner privado como URL canônica quando os links gerados precisarem funcionar para pessoas fora dessa máquina.

O Nextcloud usa overwrite.cli.urlcomo URL base canônica quando gera links fora de uma requisição normal do navegador, incluindo contextos de linha de comando e tarefas em segundo plano. Isso a torna uma configuração adequada quando um aviso ou link quebrado é causado por uma URL incorreta inferida durante a instalação.

Defina a URL base canônica

Em uma instalação padrão do Linux, acesse o diretório do Nextcloud que contém occ— geralmente /var/www/nextcloud— e execute o seguinte comando como o usuário do servidor web:

cd /var/www/nextcloud
sudo -u www-data php occ config:system:set overwrite.cli.url --value="https://cloud.example.com"

Substitua o URL de exemplo pelo seu endereço público real. Para uma instalação em subdiretório, inclua o caminho, por exemplo, `/var/www/ html` https://example.com/nextcloud. Se a sua instalação usar uma conta de servidor web, contêiner ou layout de pacote diferente, use o método documentado dessa implantação para executar o comando occ; o caminho e a conta acima não são universais.

Você também pode editar o existente config/config.phpe adicionar esta entrada dentro da $CONFIGmatriz:

'overwrite.cli.url' => 'https://cloud.example.com',

Não crie um segundo $CONFIGarray nem sobrescreva o restante do arquivo. Mantenha a vírgula final se outras entradas seguirem. Faça um backup fora do configdiretório ativo antes de fazer edições manuais; o Nextcloud pode carregar arquivos adicionais com extensão .next .config.phpdesse diretório como configuração em tempo real.

O que muda quando o Nextcloud está atrás de um proxy reverso?

Um proxy reverso aceita a solicitação HTTPS pública e a encaminha para o Nextcloud, às vezes por meio de HTTP simples em uma rede privada. O Nextcloud pode então inferir o esquema, o nome do host ou o caminho errados ao criar seu próprio URL. O guia oficial de proxy reverso recomenda usar os parâmetros de sobrescrita somente quando a detecção automática falhar e listar o endereço do proxy em trusted_proxies.

Para um proxy 10.0.0.1que serve o Nextcloud em https://cloud.example.com/nextcloud, as entradas relevantes dentro da matriz de configuração existente são semelhantes a estas:

'trusted_proxies'   => ['10.0.0.1'],
'overwriteprotocol' => 'https',
'overwritewebroot'  => '/nextcloud',
'overwrite.cli.url' => 'https://cloud.example.com/nextcloud',

Use o endereço IP real que o Nextcloud vê para o proxy e o caminho público na sua configuração. Para uma instalação com domínio raiz, omita o parâmetro `--hostname`, overwritewebroota menos que uma configuração específica de proxy o exija. O Nextcloud observa que o overwritehostparâmetro `--hostname` é desnecessário na maioria das configurações, pois ele consegue ler o host encaminhado pelo proxy; defina-o apenas quando precisar forçar um nome de host específico. Configurações incorretas de confiança no proxy ou de cabeçalho encaminhado podem afetar a interpretação dos endereços IP dos clientes; portanto, não copie um endereço de exemplo sem verificar sua topologia.

O servidor consegue acessar esse URL de dentro da sua própria rede?

Faça o teste a partir do host do Nextcloud ou do contêiner do Nextcloud, caso o serviço esteja sendo executado em um contêiner Docker. Primeiro, verifique a resolução de nomes e, em seguida, faça uma solicitação HTTPS:

getent ahosts cloud.example.com
curl -I https://cloud.example.com/status.php

O nome do host deve ser resolvido para o endereço acessível pretendido e a solicitação deve retornar uma resposta HTTP do Nextcloud sem erro de certificado. Uma solicitação bem-sucedida do seu computador não comprova que o servidor consegue acessar a mesma URL. Servidores domésticos atrás de um roteador podem falhar ao tentar acessar seu próprio endereço público de dentro da LAN; isso geralmente é chamado de problema de NAT hairpin ou loopback de NAT. Configure o DNS dividido para que o mesmo nome de host público seja resolvido internamente para o endereço LAN do proxy reverso ou habilite o comportamento de loopback suportado pelo roteador. Mantenha a URL canônica pública para que os links enviados a usuários remotos permaneçam válidos.

Não tente "corrigir" um problema de certificado usando-o curl -kcomo prova de que o HTTPS está funcionando corretamente. Instale ou configure uma cadeia de certificados confiável pelo sistema ou contêiner que executa o Nextcloud e, em seguida, repita o teste normalmente.

Quando você deve verificar o acesso geral à internet de saída?

Se a página de administração indicar especificamente que o Nextcloud não possui conexão com a internet ou não consegue alcançar vários endpoints externos, alterar as configurações overwrite.cli.urlpor si só não restaurará a saída de dados pela internet. Verifique a resolução de DNS e as regras de firewall de saída do servidor. Se sua rede exigir um proxy HTTP, configure as definições de proxy compatíveis com o Nextcloud ou o ambiente usado pelo PHP e pelas tarefas em segundo plano; um proxy configurado apenas em um shell interativo pode não estar disponível para tarefas agendadas.

Verifique a correção

Recarregue a Visão Geral da Administração depois que o Nextcloud conseguir resolver e acessar seu URL canônico. Confirme se o endereço usa o nome de host HTTPS correto e quaisquer subdiretórios. Em seguida, crie um link de compartilhamento de teste e verifique se ele contém o mesmo host acessível. Se o aviso de endereço de saída desaparecer, mas um aviso de conectividade com a Internet permanecer, investigue o acesso de saída separadamente. O Manual de Administração atual do Nextcloud documenta as configurações de URL e proxy reverso; a redação exata na tela pode variar de acordo com a versão e a interface traduzida.

Referências oficiais

• Configurações de proxy reverso do Nextcloud e exemplos de URLs canônicas
• Referência de configuração do Nextcloud para overwrite.cli.url
• Visão geral da administração do Nextcloud: segurança e avisos de configuração