| 12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879 |
- #!/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()
|