starter.py 2.5 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879
  1. #!/usr/bin/env python3
  2. import os
  3. import sys
  4. def main():
  5. """
  6. 启动 FastAPI 应用,根据环境选择不同参数:
  7. - DEV: 热重载,单进程,仅监听 app 目录
  8. - PROD: 多进程,代理头穿透(获取真实IP),高性能 uvloop + httptools,优雅停机
  9. """
  10. os.environ.setdefault(
  11. "WATCHFILES_IGNORE",
  12. "**/.git/**,**/venv/**,**/__pycache__/**"
  13. )
  14. env = os.getenv("ENV", "DEV").upper()
  15. host = os.getenv("HOST", "0.0.0.0")
  16. port = os.getenv("PORT", "8888")
  17. app_module = "app.main:app"
  18. # 使用 sys.executable 确保在所有环境使用当前 Python 解释器
  19. base_cmd = [
  20. sys.executable,
  21. "-m", "uvicorn",
  22. app_module,
  23. "--host", host,
  24. "--port", port,
  25. ]
  26. if env == "PROD":
  27. print("🔥 启动生产环境(多进程 + 代理穿透 + 高性能)")
  28. # 容器/生产环境限制:默认限制最大 4 个 Worker,防止物理宿主机多核导致 DB 连接池耗尽与 OOM
  29. # 运维可通过 WORKERS 或 WEB_CONCURRENCY 环境变量自定义
  30. default_workers = min(os.cpu_count() or 1, 4)
  31. workers = os.getenv("WORKERS") or os.getenv("WEB_CONCURRENCY") or str(default_workers)
  32. base_cmd += [
  33. "--workers", str(workers),
  34. "--loop", "uvloop",
  35. "--http", "httptools",
  36. "--proxy-headers", # ⭐ 信任反向代理(Nginx等)头信息
  37. "--forwarded-allow-ips", "*", # ⭐ 允许提取真实客户端 IP
  38. "--no-access-log", # 避免与 main.py 的自定义 access_log 中间件重复打印
  39. ]
  40. else:
  41. if env != "DEV":
  42. print(f"⚠️ 未知环境 {env},使用默认 DEV 配置")
  43. else:
  44. print("🚀 启动开发环境(热重载)")
  45. base_cmd += [
  46. "--reload",
  47. "--reload-dir", "app",
  48. "--reload-exclude", "*__pycache__*",
  49. ]
  50. print("\n执行命令:")
  51. print(" ", " ".join(base_cmd))
  52. if env != "PROD":
  53. print(f"\nSwagger UI: http://{host}:{port}/docs")
  54. print(f"ReDoc UI: http://{host}:{port}/redoc\n")
  55. else:
  56. print("\n🔒 生产环境(PROD)已禁用 Docs 与 ReDoc\n")
  57. # 在 POSIX 环境下使用 execvp 替换当前进程,使 uvicorn 成为 PID 1 直接接收系统 SIGTERM 信号进行优雅停机
  58. if sys.platform == "win32":
  59. import subprocess
  60. subprocess.run(base_cmd)
  61. else:
  62. os.execvp(base_cmd[0], base_cmd)
  63. if __name__ == "__main__":
  64. main()