Virtualhosts

Dans l'agent redirection.io, les Virtualhosts permettent de définir une configuration pour un ensemble spécifique de domaines. Ceci est utile si vous souhaitez héberger plusieurs sites web sur le même agent sans avoir besoin de lier chaque site web à un port spécifique. L'agent routera automatiquement les requêtes vers le bon backend en fonction du domaine demandé, en utilisant le header Host de la requête.

La configuration des virtualhosts est définie sous la clé virtual_hosts dans la configuration de l'agent. Chaque virtualhost est défini par une liste de domaines qu'il doit gérer, et il permet de spécifier toutes les options de configuration qui se trouvent habituellement sous la clé reverse_proxy, telles que la configuration forward, certificate ou trusted_proxies, etc. Voici un exemple de configuration pour plusieurs virtualhosts :

instance:
    name: 'My Instance'
reverse_proxy:
    listen:
        - 'tcp://0.0.0.0:80'
        - 'tls://0.0.0.0:443'
    forward:
        address: '127.0.0.1:8080'
    agent:
        project_key: DEFAULT_PROJECT_KEY
    certificate:
        acme:
            contacts:
                - myemail@example.com
            directory_url: 'https://acme-v02.api.letsencrypt.org/directory'
    virtual_hosts:
        -
            domains:
                - example.com
                - www.example.com
            agent:
                project_key: WEBSITE_PROJECT_KEY
        -
            domains:
                - 'tls://media.example.com'
            forward:
                directory: /var/www/media
            agent:
                project_key: MEDIA_PROJECT_KEY

Cette configuration définit deux Virtualhosts, un pour les domaines example.com et www.example.com, et un pour le domaine media.example.com. Chaque virtualhost possède sa propre configuration, avec différentes clés projet redirection.io.

Avec une telle configuration de reverse proxy :

• l'agent acceptera toutes les connexions entrantes sur les ports 80 et 443
• par défaut, les requêtes seront gérées en utilisant le projet redirection.io DEFAULT_PROJECT_KEY et transmises au backend à l'adresse 127.0.0.1:8080 en http
• les requêtes vers example.com et www.example.com utiliseront le projet redirection.io qui a la project key WEBSITE_PROJECT_KEY, et seront transmises à l'adresse de forward par défaut (127.0.0.1:8080), en http
• les requêtes reçues sur media.example.com en tls seront envoyées vers un backend de système de fichiers, et associées au projet redirection.io qui a la project key MEDIA_PROJECT_KEY

Si deux configurations de Virtualhost se chevauchent, l'agent utilisera la première qui correspond au domaine demandé. Par exemple, si vous avez une configuration de Virtualhost pour example.com, et une autre pour à la fois example.com et www.example.com, alors une requête sur example.com utilisera le premier Virtualhost, car il est défini en premier dans le fichier de configuration. Pour éviter ce problème, assurez-vous de définir vos configurations de Virtualhost dans le bon ordre, avec les plus spécifiques définies en premier.