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

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 reverse proxy 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. Reportez-vous à “Créer des certificats SSL” pour en savoir plus. 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 ce qui suit dans 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;
    }
}

Ici, 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 contrôleurs de domaine.

Ajoutez ce qui suit 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 est l’adresse IP de votre serveur Nginx.

Se connecter à Cloud via un alias

Vous êtes maintenant prêt à vous connecter à l’aide de 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 :)

Base de connaissances

Créer un alias DNS personnalisé en mettant en place un reverse proxy

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

Créer un certificat autosigné

Mettre à jour la configuration de Nginx

Mettre à jour le fichier hosts

Se connecter à Cloud via un alias

​Alias DNS personnalisé via la configuration d’un reverse proxy

​Créer un certificat autosigné

​Mettre à jour la configuration de Nginx

​Mettre à jour le fichier hosts

​Se connecter à Cloud via un alias

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

Créer un certificat autosigné

Mettre à jour la configuration de Nginx

Mettre à jour le fichier hosts

Se connecter à Cloud via un alias