企业官网建设流程全解析

大家好，我是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. 常用运维命令

🚀 方案二：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 选型对比

🛡 生产环境的安全堡垒：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 restart或pkill gunicorn重新加载进程。