Configure o hospedagem de subcaminhos com o Caddy.

Você pode usar o Caddy para disponibilizar sua central de ajuda Notiondesk a partir de um subdiretório do seu domínio principal.

Por exemplo, em vez de usar um subdomínio como help.yourdomain.com, você pode disponibilizar sua central de ajuda em:

yourdomain.com/help

yourdomain.com/docs

yourdomain.com/support

Essa configuração é útil se o seu site principal estiver hospedado em um servidor onde o Caddy já está sendo usado como servidor web ou proxy reverso.

Antes de começar

Antes de configurar o hospedagem de subcaminhos com o Caddy, certifique-se de ter:

Acesso ao seu servidor

Acesso ao seu arquivo Caddyfile

Um subcaminho que você deseja usar para sua central de ajuda, como:
- __PRESERVADO_19__
- __PRESERVADO_18__
- __PRESERVADO_17__

Você também deve garantir que seu site principal já esteja funcionando corretamente antes de adicionar a configuração de subcaminho Notiondesk.

Habilitar hospedagem de subcaminho em Notiondesk

Primeiro, habilite o hospedagem de subcaminhos no seu painel de controle Notiondesk.

Abra seu painel de controle Notiondesk

Acesse Settings > General

Deslize para a seção Domains

Ative a opção Subpath

Salvar alterações

Copie a configuração do Caddy gerada.

O comando Notiondesk gera uma configuração do Caddy com os valores corretos para sua central de ajuda. Você precisará adicionar essa configuração ao seu Caddyfile na próxima etapa.

Adicione a configuração do Caddy

Após copiar a configuração de Notiondesk, adicione-a ao seu Caddyfile.

Abra o bloco do site Caddy que gerencia o domínio principal do seu site.

Por exemplo:

Adicione a rota Notiondesk gerada dentro deste bloco de site.

A configuração deve contemplar:

yourdomain.com {
    # Your main website configuration
}

O subcaminho da central de ajuda selecionado, como /help

Páginas aninhadas da central de ajuda, como /help/*

Notiondesk rotas internas, como /_nd/*

Todos os outros caminhos devem continuar a ser tratados pelo seu site principal.

Por exemplo, se sua central de ajuda usa /help, somente /help, /help/* e /_nd/* devem ser encaminhados para Notiondesk.

Exemplo de proxy reverso Caddy

Aqui está um exemplo de configuração do Caddy para uma central de ajuda servida a partir de /help.

Você deve copiar a configuração gerada do seu próprio painel de controle Notiondesk. O domínio da central de ajuda, o subcaminho e os valores de proxy são específicos da sua configuração.

Carrinho de recarga

Após adicionar a configuração ao seu Caddyfile, recarregue o Caddy para aplicar as alterações.

O comando exato depende da configuração do seu servidor. Se o Caddy estiver sendo gerenciado com systemd, geralmente você pode recarregá-lo com:

Antes de recarregar, você também pode validar seu Caddyfile:

Se a validação for bem-sucedida, recarregue o Caddy e teste o subcaminho da sua central de ajuda.

Verifique sua configuração

Após recarregar o Caddy, abra o subdiretório da central de ajuda no seu navegador.

Em seguida, teste algumas páginas para garantir que tudo funcione corretamente:

route {
    @subpath path /help /help/*
    handle @subpath {
        reverse_proxy your-help-center.notiondesk.help:443 {
            header_up Host {http.request.host}
            header_up X-Forwarded-Host {http.request.host}
            header_up X-Forwarded-Proto https
            header_up X-Site-Path-Prefix /help
            transport http {
                tls
                tls_server_name your-help-center.notiondesk.help
            }
        }
    }

    handle /_nd/* {
        reverse_proxy your-help-center.notiondesk.help:443 {
            header_up Host {http.request.host}
            header_up X-Forwarded-Host {http.request.host}
            header_up X-Forwarded-Proto https
            transport http {
                tls
                tls_server_name your-help-center.notiondesk.help
            }
        }
    }

    # Let your main app handle every other path.
}

sudo systemctl reload caddy

caddy validate

Abra a página inicial da central de ajuda.

Abra uma página de artigo conhecido

Abra a página inicial do seu site principal.

Tabela de conteúdos