---
title: "Apache HTTP server"
slug: "apache-http-server"
tags: ["Custom domain", "Subfolder hosting"]
updated: 2026-06-22T09:03:17Z
published: 2026-06-22T09:03:17Z
canonical: "docs.document360.com/apache-http-server"
---
> ## Documentation Index
> Fetch the complete documentation index at: https://docs.document360.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Apache HTTP server
Het hosten van je Document360-kennisbank in een submap op Apache, zoals `example.com/docs`, vereist het inschakelen van Apache-modules en het configureren van proxy- en redirect-regels. Dit artikel behandelt het inschakelen van de benodigde modules, het routeren van de startpagina, artikel- en categoriepagina's, en het Site API-pad, het genereren van sitemaps en het afhandelen van URL-omleiding om dubbele inhoud in zoekmachines te voorkomen.
OPMERKING
Vervang het voorbeelddomein in dit artikel door je eigen door Document360 geleverde domein of aangepaste domein. Bijvoorbeeld, `example.document360.io` vertegenwoordigt je domein, `example.document360.io/v1` een submap pad van de werkruimte, en `example.document360.io/help` een pad op de startpagina van een submap.
---
## Voordat je begint
Subfolderhosting werkt alleen wanneer zowel het **Subfolderpad** (bijvoorbeeld `/docs` of `/help`) als het **Site API-pad** (bijvoorbeeld `/api`) zijn gedefinieerd in Document360, met een bijpassende configuratie op je server.
Zorg ervoor dat de volgende Apache-modules zijn ingeschakeld — deze maken deel uit van de standaard Apache-installatie:
- `proxy`
- `proxy_http`
- `headers`
- `substitute`
- `proxy_html`
Stel ze in staat met:
```
sudo a2enmod proxy proxy_http headers substitute proxy_html
```
---
## Hoe de startpagina te configureren
Configureer het volgende Virtual Host-locatieblok om verzoeken voor de startpagina te proxyen, waarbij het pad begint met `/help`:
```
ProxyPreserveHost off
RequestHeader set Host example.document360.io
RequestHeader set requested-by proxy
RequestHeader unset Accept-Encoding
ProxyPass https://example.document360.io/v1
ProxyPassReverse https://example.document360.io/v1
AddOutputFilterByType SUBSTITUTE text/html
substitute 's|href="/docs|href="/help|ni'
substitute 's|href="/v1/docs|href="/help|ni'
substitute 's|href="https://example.document360.io/docs|href="https://docs.example.com/help|ni'
```
### Artikelen preview-links voor submap hosting repareren
Links voor artikelvoorbeelden in het Document360-portaal bevatten de werkruimte en taalslug in de URL. Bijvoorbeeld, de live article URL kan `docs.example.com/getting-started`zijn , terwijl de portal preview-link . `docs.example.com/v1/en/getting-started` Je kunt ofwel een locatieblok toevoegen om het `/v1/en` pad te verwerken, of een omleiding instellen van `/v1/en` naar `/`:
```
RewriteEngine on
RewriteRule ^v1/en$ / [R=301,L,NC]
```
Deze omleiding vereist de `rewrite` module:
```
sudo a2enmod rewrite
```
---
## Hoe je artikel- en categoriepagina's configureert
Voeg de volgende locatieblokken toe aan hetzelfde Apache Virtual Host-configuratiebestand aan proxy-artikel-, categorie- en API-verzoeken:
```
ProxyPreserveHost off
RequestHeader set Host example.document360.io
RequestHeader set requested-by proxy
ProxyPass https://example.document360.io/docs/
ProxyPassReverse https://example.document360.io/docs/
AddOutputFilterByType SUBSTITUTE text/html
substitute 's|href="/docs|href="/help|ni'
substitute 's|href="/v1/docs|href="/help|ni'
substitute 's|href="https://example.document360.io/docs|href="https://docs.example.com/help|ni'
ProxyPreserveHost off
RequestHeader set Host example.document360.io
RequestHeader set requested-by proxy
RequestHeader unset Accept-Encoding
ProxyPass https://example.document360.io/api
ProxyPassReverse https://example.document360.io/api
AddOutputFilterByType SUBSTITUTE application/json
substitute 's|href="/docs/|href="/help/|ni'
substitute 's|href="/v1/docs/|href="/help/|ni'
substitute 's|href="https://example.document360.io/docs/|href="https://docs.example.com/help/|ni'
```
Herstart de Apache-server zodra deze is geconfigureerd:
```
sudo systemctl restart apache2
```
OPMERKING
Vervang `/docs` en `/api` door de exacte waarden die zijn geconfigureerd onder **Subfolderpad** en **Site API-pad** in het Document360-portaal.
---
## Hoe je sitemapgeneratie instelt
Het sitemap-prefix blijft hetzelfde, behalve voor de taalcode (en, fr, de, enzovoort).
```
RequestHeader set Host example.document360.io
RequestHeader set requested-by proxy
ProxyPass https://example.document360.io/sitemap.xml.en
ProxyPassReverse https://example.document360.io/sitemap.xml.en
```
---
## Wat gebeurt er daarna
Zodra Apache is geconfigureerd, staat je kennisbanksite live in je aangepaste submap. De bestaande Document360-URL blijft ook verzoeken bedienen — bijvoorbeeld, zowel `example.document360.io` en `example.com/docs` verwijzen naar je kennisbanksite. Dit veroorzaakt dubbele inhoud in zoekmachines zoals Google en Bing.
Om dubbele inhoud te voorkomen, schakel je de schakelaar **Subdomeintoegang Beperken** in onder > **Knowledge base site** > **Custom domain** > **Subfolder hosting**. Zorg ervoor dat een canoniek domein is geconfigureerd voordat je dit inschakelt — zodra ingeschakeld, wordt je Document360-subdomein automatisch doorgestuurd naar je canonieke domein.
---
## Best practices
- Schakel alle vijf vereiste Apache-modules in (`proxy`, `proxy_http`, `headers`, `substitute`, ) `proxy_html`voordat je locatieblokken configureert, anders werkt proxy en herschrijven niet.
- Houd het Subfolderpad en het Site API-pad identiek tussen het Document360-portaal en je Apache-configuratie om gebroken routering te voorkomen.
- Gebruik de `substitute` regels consequent over de blokken op de startpagina, artikel/categorie en API-locaties om gemengde `/docs` links `/help` op de live site te voorkomen.
- Stel de `/v1/en` doorverwijzing voor artikelvoorbeeldlinks vroeg in, omdat niet-overeenkomende previewlinks anders verwarring kunnen veroorzaken voor contentauteurs.
## Related
- [Nginx-server](/nginx-server.md)