Telegram Bot Webhook + VPS + Nginx + SSL: Schritt-für-Schritt ins Production-Setup

Bringen Sie den Server zuerst in den Zustand, den Zertifikatsausstellung und Reverse Proxy benötigen.

Stellen Sie das Zertifikat aus, bevor Sie den Webhook auf die endgültige HTTPS-Route umstellen.

Verwenden Sie einen HTTP-Serverblock für den Redirect und einen HTTPS-Serverblock für den finalen Reverse Proxy. Leiten Sie nur den Webhook-Pfad an den lokalen Bot-Prozess weiter [4][5][6].

Verwenden Sie eine Konfiguration in dieser Form:

server {
    listen 80;
    listen [::]:80;
    server_name bot.example.com;

    location / {
        return 301 https://$host$request_uri;
    }
}

server {
    listen 443 ssl http2;
    listen [::]:443 ssl http2;
    server_name bot.example.com;

    ssl_certificate /etc/letsencrypt/live/bot.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/bot.example.com/privkey.pem;
    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 10m;

    client_max_body_size 20m;

    location = /healthz {
        add_header Content-Type text/plain;
        return 200 "ok\n";
    }

    location /telegram/webhook {
        proxy_pass http://127.0.0.1:3000/telegram/webhook;
        proxy_http_version 1.1;
        proxy_connect_timeout 5s;
        proxy_read_timeout 60s;
        proxy_send_timeout 60s;

        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }

    location / {
        return 404;
    }
}

Laden Sie Nginx nach dem Speichern der Konfiguration neu. Der Bot bleibt privat auf 127.0.0.1, und Telegram erreicht ausschließlich die HTTPS-Route, die Nginx veröffentlicht.

Registrieren Sie die endgültige öffentliche HTTPS-URL erst dann, wenn Nginx und SSL bereits funktionieren. Übergeben Sie ein secret_token und prüfen Sie es in der Anwendung über den Header X-Telegram-Bot-Api-Secret-Token [1].

Registrieren Sie den Webhook:

curl -X POST "https://api.telegram.org/bot$BOT_TOKEN/setWebhook"   -d "url=https://bot.example.com/telegram/webhook"   -d "secret_token=replace_with_a_long_random_value"   -d 'allowed_updates=["message","callback_query"]'

Prüfen Sie danach den Status:

curl "https://api.telegram.org/bot$BOT_TOKEN/getWebhookInfo"

Begrenzen Sie mit allowed_updates die Zustellung auf die Update-Typen, die der Bot tatsächlich verarbeitet. Wenn keine Updates ankommen, lesen Sie pending_update_count und die letzte Fehlermeldung in getWebhookInfo [1].

Gehen Sie diese Punkte durch, nachdem der Webhook registriert wurde.

Die meisten Webhook-Ausfälle gehen auf wenige wiederkehrende Fehler zurück.

Diese Quellen stützen das Verhalten von Telegram-Webhooks, den Nginx-Reverse-Proxy, den SSL-Ablauf und die Firewall-Hinweise in diesem Tutorial.

PAS7 Studio unterstützt Teams bei der Bereitstellung von Telegram-Bots mit stabilem Webhook-Routing, Reverse Proxy, automatischer Zertifikatserneuerung, App-Prozess-Management, Migration von Polling und Production-Hardening des gesamten Stacks.