Wissen / Einrichtung

HTTPS und Reverse Proxy

Kontris hinter einem Reverse Proxy betreiben oder HTTPS direkt ausliefern.

Hinter einem Reverse Proxy

Der übliche Aufbau: nginx, Traefik, Caddy oder HAProxy nehmen HTTPS an und leiten an http://127.0.0.1:3000 weiter.

  • Der Proxy setzt die Header X-Forwarded-For, X-Forwarded-Proto und X-Forwarded-Host.
  • In contracthub.env steht TRUST_PROXY=1, wenn genau ein Proxy davor ist.
  • APP_BASE_URL ist die Adresse, die Benutzer im Browser sehen, mit https://.
  • Das Upload-Limit des Proxys liegt mindestens bei MAX_UPLOAD_MB (Standard 50 MB).
  • HSTS setzt der Proxy, zum Beispiel Strict-Transport-Security: max-age=31536000.

Beispiel für nginx:

server {
  listen 443 ssl;
  http2 on;
  server_name contracthub.example.com;

  ssl_certificate     /etc/ssl/contracthub/fullchain.crt;
  ssl_certificate_key /etc/ssl/contracthub/server.key;

  client_max_body_size 50m;
  add_header Strict-Transport-Security "max-age=31536000" always;

  location / {
    proxy_pass http://127.0.0.1:3000;
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-Host $host;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  }
}

Wirst du direkt nach der Anmeldung wieder abgemeldet, passt APP_BASE_URL nicht zur Adresse im Browser oder TRUST_PROXY fehlt.

Ohne Reverse Proxy

Kontris kann HTTPS selbst ausliefern:

APP_BASE_URL=https://contracthub.example.com
TRUST_PROXY=false
TLS_CERT_FILE=/tls/server.crt
TLS_KEY_FILE=/tls/server.key
# optional: HTTP-Port, der auf HTTPS weiterleitet
HTTP_REDIRECT_PORT=8080

In der compose.yaml:

    ports:
      - '443:3000'
      - '80:8080'
    volumes:
      - ./tls:/tls:ro
  • server.crt enthält zuerst das Serverzertifikat, danach die Zwischenzertifikate (PEM).
  • server.key ist der unverschlüsselte Schlüssel (PEM) und muss für UID 1000 lesbar sein.
  • Kontris prüft beim Start, ob beide zusammenpassen, und setzt HSTS selbst. Die Restlaufzeit des Zertifikats steht im Log, ab 30 Tagen vor Ablauf als Warnung.
  • Zum Erneuern tauschst du die Dateien aus und startest den Container neu.

Zertifikat aus einer PFX-Datei

openssl pkcs12 -in contracthub.pfx -clcerts -nokeys -out server-only.crt
openssl pkcs12 -in contracthub.pfx -cacerts -nokeys -out chain.crt
openssl pkcs12 -in contracthub.pfx -nocerts -nodes -out server.key
cat server-only.crt chain.crt > server.crt
sudo chown 1000:1000 server.key && sudo chmod 600 server.key

Meldet openssl unsupported, wiederhole die Befehle mit -legacy am Ende.

Stand 15.11.2026 · Kommst du nicht weiter? Schreib uns