FastAPI 项目部署指南：Docker 容器化与 Nginx 反向代理配置

FastAPI 项目部署指南：Docker 容器化与 Nginx 反向代理配置

准备工作

确保已安装 Docker 和 Docker Compose。
检查 FastAPI 项目结构完整，包含 requirements.txt 或 pyproject.toml 依赖文件。

编写 Dockerfile

在项目根目录创建 Dockerfile，内容如下：

FROM python:3.9-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY . .
CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000"]

配置 Docker Compose

创建 docker-compose.yml 文件定义服务：

version: "3.8"
services:
  app:
    build: .
    ports:
      - "8000:8000"
    environment:
      - APP_ENV=production

构建并运行容器

执行以下命令启动服务：

docker-compose up --build

配置 Nginx 反向代理

创建 Nginx 配置文件 /etc/nginx/conf.d/fastapi.conf：

server {
    listen 80;
    server_name your_domain.com;

    location / {
        proxy_pass http://app:8000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

启用 HTTPS（可选）

使用 Let's Encrypt 证书配置 SSL：

certbot --nginx -d your_domain.com

重启服务

完成配置后重新加载 Nginx：

nginx -s reload
docker-compose restart

监控与日志

查看容器日志确认运行状态：

docker-compose logs -f

---

以上方案实现了 FastAPI 项目的容器化部署与生产级反向代理配置，兼顾安全性与可扩展性。根据实际需求可调整端口、环境变量等参数。