Flask-Deployment

Nach Abschluss der Entwicklung muss die Flask-Anwendung in einer Produktionsumgebung bereitgestellt werden, damit echte Benutzer darauf zugreifen können.

Dieses Kapitel behandelt die wichtigsten Schritte und Überlegungen von der Entwicklung bis zur Produktion.


Entwicklungsserver vs. Produktionsserver

Wichtig: Der in Flask integrierte Entwicklungsserver (flask run) eignet sich nur für Entwicklungsumgebungen. Ihm fehlen die für die Produktion erforderliche Sicherheit, Stabilität und Leistung. In Produktionsumgebungen muss ein professioneller WSGI-Server verwendet werden.

Funktionen Flask-Entwicklungsserver Produktions-WSGI-Server (Gunicorn/Waitress)
Umgang mit Nebenläufigkeit Single-Threaded (Standard) Multiprozess/Multithread/Coroutine
Sicherheit Der Debug-Modus ermöglicht die Ausführung von Code im Browser Keine Debugging-Funktionen, sicher und kontrollierbar
Leistung Nicht optimiert Für hohe Nebenläufigkeit optimiert
Anwendbare Szenarien Lokale Entwicklung und Debugging Produktionsumgebung

Deployment-Checkliste

Stellen Sie vor dem Deployment sicher, dass alle folgenden Punkte abgeschlossen wurden:

Beispiel

# Dateipfad: app.py (Prüfungen der Produktionsumgebungskonfiguration)
import os

app.config.update(
    # 1. Debug-Modus deaktivieren (erforderlich!)
    DEBUG=False,

    # 2. Geheimen Schlüssel aus Umgebungsvariablen lesen (niemals hardcodieren)
    SECRET_KEY=os.environ.get("FLASK_SECRET_KEY", ""),

    # 3. Sicherheitsoptionen für Session-Cookies konfigurieren
    SESSION_COOKIE_SECURE=True,   # Nur über HTTPS übertragen
    SESSION_COOKIE_HTTPONLY=True, # JavaScript-Zugriff blockieren
    SESSION_COOKIE_SAMESITE="Lax",  # CSRF-Angriffe verhindern
)

Vollständige Checkliste:

Prüfpunkt Beschreibung Risikostufe
DEBUG = False Debug-Modus deaktivieren, um Code-Leakage zu verhindern Kritisch
SECRET_KEY zufällig und geheim Session und Flash basieren auf Schlüsselsignierung Kritisch
SECRET_KEY wird aus Umgebungsvariablen gelesen Kein Hardcoding, nicht in Git committen Kritisch
Datenbankpasswörter aus Umgebungsvariablen lesen Keine sensiblen Informationen im Code Kritisch
SESSION_COOKIE_SECURE = True Cookies nur über HTTPS senden Hoch
Fehlerseiten geben keine Stacktrace-Informationen preis Benutzerdefinierten errorhandler verwenden Mittel

Bereitstellung mit Waitress (Windows/macOS/Linux)

WaitressEs ist ein reiner Python-WSGI-Server, plattformübergreifend und einfach zu installieren:

(.venv) $ pip install waitress

Beispiel

# Dateipfad: run.py (Produktionsstartskript)
from waitress import serve
from app import create_app

app = create_app()

if __name__ == "__main__":
    # Produktionsserver starten
    serve(app, host="0.0.0.0", port=8000, threads=4)
    # host="0.0.0.0" ermöglicht externen Zugriff
    # threads=4 verwendet 4 Threads, um gleichzeitige Anfragen zu verarbeiten

Starten:

(.venv) $ python run.py
Serving on http://0.0.0.0:8000

Bereitstellung mit Gunicorn (Linux/macOS)

GunicornEs ist der beliebteste Python-WSGI-Server unter Linux, mit ausgezeichneter Leistung:

(.venv) $ pip install gunicorn

Gunicorn starten (Anwendung direkt auf der Kommandozeile angeben):

# 基本用法:4 个 worker 进程
$ gunicorn -w 4 -b 0.0.0.0:8000 "app:create_app()"

# 参数说明:
# -w 4       : 启动 4 个 worker 进程(通常设为 CPU 核心数 × 2 + 1)
# -b 0.0.0.0:8000 : 监听所有网络接口的 8000 端口
# "app:create_app()" : 模块名:工厂函数(与 flask --app 语法相同)

Auswahl des Gunicorn-Worker-Typs:

Worker-Typ Anwendbare Szenarien Befehl
sync (Standard) CPU-intensiv, geringe Nebenläufigkeit gunicorn -w 4 app:app
gevent IO-intensiv, hohe Nebenläufigkeit, langlebige Verbindungen gunicorn -k gevent -w 4 app:app
gthread Mittlere Nebenläufigkeit, erfordert Thread-Unterstützung gunicorn --threads=2 -w 4 app:app

Gunicorn unterstützt Windows nicht. Wenn Sie unter Windows bereitstellen, verwenden Sie bitteWaitress。


Nginx als Reverse-Proxy verwenden

In der Produktion wird Nginx typischerweise als Reverse-Proxy vor dem WSGI-Server eingesetzt:

  • Nginx verarbeitet statische Dateien (CSS, JS, Bilder) mit wesentlich höherer Effizienz als Python
  • Nginx bietet HTTPS-Terminierung (SSL-Terminierung)
  • Nginx führt Lastverteilung durch und verteilt Anfragen auf mehrere Backend-Worker

Flask 生产环境部署架构

Eine minimale Beispiel-Nginx-Konfiguration:

Beispiel

# Dateipfad: /etc/nginx/sites-available/example
server {
    listen 80;
    server_name example.com www.example.com;

    # Statische Dateien werden direkt von Nginx ausgeliefert
    location /static/ {
        alias /var/www/example/static/;
        expires 30d;  # Browser-Cache für 30 Tage
    }

    # Andere Anfragen werden an Gunicorn weitergeleitet
    location / {
        proxy_pass http://127.0.0.1:8000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

Konfiguration aktivieren und Nginx neu laden:

$ sudo ln -s /etc/nginx/sites-available/example /etc/nginx/sites-enabled/
$ sudo nginx -t          # 检查配置语法
$ sudo systemctl reload nginx

systemd zum Verwalten von Diensten verwenden (Linux)

Erstellen Sie eine systemd-Dienstdatei, damit die Flask-Anwendung beim Systemstart startet und nach einem Absturz automatisch neu startet:

Beispiel

# Dateipfad: /etc/systemd/system/example.service
[Unit]
Description=EXAMPLE Flask-Anwendung
After=network.target

[Service]
User=www-data
WorkingDirectory=/var/www/example
# Umgebungsvariablen beim Start automatisch aus .env-Datei laden
EnvironmentFile=-/var/www/example/.env
# Anwendung mit Gunicorn starten
ExecStart=/var/www/example/.venv/bin/gunicorn⟦⟧"app:create_app()" -w 4 -b 127.0.0.1:8000 "app:create_app()"
# Nach einem Absturz automatisch neu starten
Restart=always
RestartSec=5

[Installation]
WantedBy=multi-user.target

Dienste starten und verwalten:

$ sudo systemctl daemon-reload        # 重载配置文件
$ sudo systemctl enable example        # 设置开机自启
$ sudo systemctl start example         # 启动服务
$ sudo systemctl status example        # 查看服务状态
$ sudo journalctl -u example -f        # 实时查看日志

WSGI-Server-Kurzreferenz

Server Plattform Funktionen Installation
Werkzeug (integriert) Alle Plattformen Nur für die Entwicklung, unterstützt Hot Reload und Debugger Mit Flask mitgeliefert
Waitress Alle Plattformen Reines Python, bevorzugt unter Windows pip install waitress
Gunicorn Linux/macOS Gute Performance, die bevorzugte Wahl unter Linux und ein ausgereiftes Ökosystem pip install gunicorn
uWSGI Linux/macOS Voll funktionsfähig, komplexe Konfiguration pip install uwsgi

Tutorial-Zusammenfassung

Herzlichen Glückwunsch zum Abschluss aller Inhalte des Flask-Einführungstutorials!

Lass uns wiederholen, was du gelernt hast:

Kapitel Kernkompetenzen
Flask verstehen Positionierung und Ökosystem von Flask verstehen
Umgebungsvorbereitung Virtuelle Umgebung erstellen, Abhängigkeiten installieren
Erste Anwendung Eine minimale Anwendung erstellen und flask run verwenden
Routing-System URL-Zuordnung, Variablenregeln, url_for, HTTP-Methoden
Anfrage und Antwort Anfragedaten lesen und verschiedene Arten von Antworten erstellen
Template-Rendering Jinja2-Syntax, Template-Vererbung, XSS-Schutz
Statische Dateien Statische Assets wie CSS/JS/Bilder verwalten
Session und Cookie Persistenz von Benutzersitzungen, Flash-Nachrichten
Konfigurationsverwaltung Multi-Umgebungs-Konfiguration, Laden von Umgebungsvariablen
Blueprint Modulare Code-Organisation, Factory-Pattern
Fehlerbehandlung Benutzerdefinierte Fehlerseiten, Logging
Datenbankintegration SQLite-Operationen, Verwenden des g-Objekts zur Verwaltung von Verbindungen
Testen test_client, pytest zum Testen von Routen und APIs
Bereitstellung Gunicorn/Waitress + Nginx + systemd

Empfohlene Richtungen für weiterführendes Lernen:

  • Flask-SQLAlchemy: Leistungsfähigere Datenbankintegration
  • Flask-Login: Benutzerauthentifizierung und Berechtigungsverwaltung
  • Flask-WTF: Formularverarbeitung und CSRF-Schutz
  • Flask-Migrate: Verwaltung von Datenbankmigrationen
  • Flask-RESTfuloderFlask-RESTX: Aufbau einer RESTful-API
  • DockerContainerisierte Bereitstellung zur weiteren Verbesserung der Portabilität
Weitere Erweiterungen