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-ProtoundX-Forwarded-Host. - In
contracthub.envstehtTRUST_PROXY=1, wenn genau ein Proxy davor ist. APP_BASE_URList die Adresse, die Benutzer im Browser sehen, mithttps://.- 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_URLnicht zur Adresse im Browser oderTRUST_PROXYfehlt.
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.crtenthält zuerst das Serverzertifikat, danach die Zwischenzertifikate (PEM).server.keyist 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