Créer un alias DNS personnalisé en configurant un proxy inverse

Découvrez comment configurer un alias DNS personnalisé pour votre instance à l’aide d’un proxy inverse

​

Alias DNS personnalisé via la configuration d’un proxy inverse

Dans cet article de la base de connaissances, nous vous expliquons comment configurer un alias DNS personnalisé pour votre instance ClickHouse Cloud à l’aide d’un proxy inverse tel que Nginx pour le client natif ClickHouse.

​

Créer un certificat autosigné

Cette étape n’est pas nécessaire si vous utilisez des certificats signés.

Créez un certificat autosigné avec le nom de domaine de votre choix. Dans cet exemple, nous utiliserons le nom de domaine xyz-customdomain.com et créerons un certificat nommé MyCertificate.crt. Consultez « Créer des certificats SSL » pour plus d’informations.

Ajoutez le certificat à /etc/clickhouse-client/config.xml :

<clickhouse>
    <openSSL>
        <client>
            <loadDefaultCAFile>false</loadDefaultCAFile>
            <caConfig>/etc/ssl/certs/MyCertificate.crt</caConfig>
            <cacheSessions>true</cacheSessions>
            <disableProtocols>sslv2,sslv3</disableProtocols>
            <preferServerCiphers>true</preferServerCiphers>
            <invalidCertificateHandler>
                <name>RejectCertificateHandler</name>
            </invalidCertificateHandler>
        </client>
    </openSSL>
</clickhouse>

​

Mettre à jour la configuration de Nginx

Ajoutez les éléments suivants à votre fichier nginx.conf :

proxy_ssl_name xyz.us-west-2.aws.clickhouse.cloud;
proxy_ssl_server_name on;

stream {
    upstream stream_backend {
         server xyz.us-west-2.aws.clickhouse.cloud:9440;
    }

    server {
        listen                9440 ssl;
        proxy_pass            stream_backend;

        ssl_certificate       /etc/ssl/certs/MyCertificate.crt;
        ssl_certificate_key   /etc/ssl/certs/MyKey.key;
        ssl_protocols         SSLv3 TLSv1 TLSv1.1 TLSv1.2;
        ssl_ciphers           HIGH:!aNULL:!MD5;
        ssl_session_cache     shared:SSL:20m;
        ssl_session_timeout   4h;
        ssl_handshake_timeout 30s;
	proxy_ssl on;
	proxy_ssl_trusted_certificate /etc/ssl/certs/isrgrootx1.pem;
	proxy_ssl_session_reuse on;
        proxy_ssl_verify on;
	proxy_ssl_name xyz.us-west-2.aws.clickhouse.cloud;
	proxy_ssl_server_name on;
    }
}

Où isrgrootx1.pem est le certificat racine de ClickHouse Cloud, que vous pouvez télécharger ici.

​

Mettre à jour le fichier hosts

L’étape suivante n’est pas nécessaire si vous utilisez vos propres serveurs DNS

Ajoutez les lignes suivantes au fichier /etc/hosts du serveur Nginx :

/etc/hosts

127.0.0.1   localhost localhost.localdomain localhost4 localhost4.localdomain4
::1         localhost6 localhost6.localdomain6
10.X.Y.Z  xyz-customdomain.com

Où 10.X.Y.Z correspond à l’adresse IP de votre serveur Nginx.

​

Se connecter à Cloud avec un alias

Vous pouvez maintenant vous connecter avec votre alias personnalisé :

clickhouse-client --host xyz.customdomain.com --secure --password 'xxxxxxx'
ClickHouse client version 23.12.1.428 (official build).
Connecting to xyz.customdomain.com:9440 as user default.
Connected to ClickHouse server version 23.9.2.

clickhouse-cloud :)