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
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
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
Eine minimale Beispiel-Nginx-Konfiguration:
Beispiel
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
[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