Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

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

View as MarkdownEdit this pageReport an issueSet up docs MCP


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é

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

Ajoutez ce qui suit au fichier /etc/hosts du serveur Nginx :

/etc/hoststext
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 :)
Navigation