#!/usr/bin/env python3 import os import sys def main(): """ 启动 FastAPI 应用,根据环境选择不同参数: - DEV: 热重载,单进程,仅监听 app 目录 - PROD: 多进程,代理头穿透(获取真实IP),高性能 uvloop + httptools,优雅停机 """ os.environ.setdefault( "WATCHFILES_IGNORE", "**/.git/**,**/venv/**,**/__pycache__/**" ) env = os.getenv("ENV", "DEV").upper() host = os.getenv("HOST", "0.0.0.0") port = os.getenv("PORT", "8888") app_module = "app.main:app" # 使用 sys.executable 确保在所有环境使用当前 Python 解释器 base_cmd = [ sys.executable, "-m", "uvicorn", app_module, "--host", host, "--port", port, ] if env == "PROD": print("🔥 启动生产环境(多进程 + 代理穿透 + 高性能)") # 容器/生产环境限制:默认限制最大 4 个 Worker,防止物理宿主机多核导致 DB 连接池耗尽与 OOM # 运维可通过 WORKERS 或 WEB_CONCURRENCY 环境变量自定义 default_workers = min(os.cpu_count() or 1, 4) workers = os.getenv("WORKERS") or os.getenv("WEB_CONCURRENCY") or str(default_workers) base_cmd += [ "--workers", str(workers), "--loop", "uvloop", "--http", "httptools", "--proxy-headers", # ⭐ 信任反向代理(Nginx等)头信息 "--forwarded-allow-ips", "*", # ⭐ 允许提取真实客户端 IP "--no-access-log", # 避免与 main.py 的自定义 access_log 中间件重复打印 ] else: if env != "DEV": print(f"⚠️ 未知环境 {env},使用默认 DEV 配置") else: print("🚀 启动开发环境(热重载)") base_cmd += [ "--reload", "--reload-dir", "app", "--reload-exclude", "*__pycache__*", ] print("\n执行命令:") print(" ", " ".join(base_cmd)) if env != "PROD": print(f"\nSwagger UI: http://{host}:{port}/docs") print(f"ReDoc UI: http://{host}:{port}/redoc\n") else: print("\n🔒 生产环境(PROD)已禁用 Docs 与 ReDoc\n") # 在 POSIX 环境下使用 execvp 替换当前进程,使 uvicorn 成为 PID 1 直接接收系统 SIGTERM 信号进行优雅停机 if sys.platform == "win32": import subprocess subprocess.run(base_cmd) else: os.execvp(base_cmd[0], base_cmd) if __name__ == "__main__": main()