成都市网站建设_网站建设公司_VS Code_seo优化
2026/1/19 20:56:41 网站建设 项目流程

大家好,我是jobleap.cn的小九。在生产环境下,我们不再简单地使用uvicorn main:app,而是需要考虑进程守护、多核并发、故障自启以及特权端口管理

🛠 方案一:PM2 方案(最简单、全能)

PM2本是 Node.js 领域的顶流,但因其极简的命令行界面和强大的进程监控能力,现已成为 Python 开发者在 Linux 上部署 Web 服务的热门选择。

1. 安装与准备

# 安装 Node 环境及 PM2sudoaptupdate&&sudoaptinstallnodejsnpm-ysudonpminstall-g pm2

2. 启动 FastAPI

PM2 可以直接托管 uvicorn 进程。为了监听80 端口,命令前必须加sudo

sudopm2 start"uvicorn main:app --host 0.0.0.0 --port 80"--name"fastapi-demo"

3. 常用运维命令

功能命令
查看所有服务状态sudo pm2 list
查看实时日志sudo pm2 logs fastapi-demo
重启服务sudo pm2 restart fastapi-demo
开机自启sudo pm2 save && sudo pm2 startup

🚀 方案二:Gunicorn + Uvicorn 方案(工业标准)

这是 Python 社区最正统的生产部署方式。Gunicorn负责管理进程(Master),Uvicorn负责处理异步请求(Worker)。这种组合兼顾了稳定性和异步高性能。

1. 安装依赖

pipinstallgunicorn uvicorn

2. 启动命令

使用-k uvicorn.workers.UvicornWorker参数来启动异步工作流:

sudogunicorn main:app\--workers4\--worker-class uvicorn.workers.UvicornWorker\--bind0.0.0.0:80\--daemon
  • --workers 4: 启动 4 个进程(建议设置为2 * CPU核心数 + 1)。
  • --daemon: 在后台运行。

3. 如何停止 Gunicorn

由于 Gunicorn 是后台运行的,需要通过查找进程 ID 来关闭:

# 查找进程并杀死psaux|grepgunicornpkillgunicorn

⚖️ PM2 vs Gunicorn 选型对比

特性PM2Gunicorn
易用性极高,像刷短视频一样简单一般,需要配合 Systemd 使用
日志管理自带精美日志面板,支持自动切割需手动配置日志文件路径
监控提供 CPU、内存实时可视化需配合三方工具(如 Prometheus)
适用人群追求开发效率、全栈开发者纯 Python 环境、追求极致底层的团队

🛡 生产环境的安全堡垒:Nginx 反向代理

在真正的生产环境中,我们通常不让Python 直接监听 80 端口,而是让 Nginx 监听 80,再转发给后端的 Python(如监听 8000 端口)。

这样做的好处:

  1. SSL 证书:Nginx 处理 HTTPS 极其方便。
  2. 静态资源:Nginx 处理图片、CSS 的速度远超 FastAPI。
  3. 安全性:隐藏真实的后端服务器信息。

🆘 常见报错排查

  1. 端口被占用
    运行sudo lsof -i :80。如果有输出,说明 80 端口被占用(通常是默认的 Nginx)。执行sudo systemctl stop nginx即可释放。
  2. 权限拒绝 (Permission Denied)
    在 Linux 中,非 root 用户无法绑定 1024 以下端口。必须使用sudo启动。
  3. 代码更新不生效
    Git pull 完代码后,必须执行pm2 restartpkill gunicorn重新加载进程。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询