Gunicorn 开源项目教程

项目介绍

Gunicorn（Green Unicorn）是一个用于 UNIX 系统的 Python WSGI HTTP 服务器。它基于 Ruby 的 Unicorn 项目，采用预分叉工作模型。Gunicorn 服务器广泛兼容多种 Web 框架，实现简单，资源消耗低，且速度较快。

项目快速启动

安装 Gunicorn

首先，使用 pip 安装 Gunicorn：

pip install gunicorn

启动 Gunicorn

假设你有一个简单的 Flask 应用 myapp.py，内容如下：

from flask import Flask
app = Flask(__name__)

@app.route('/')
def hello():
    return "Hello, World!"

if __name__ == '__main__':
    app.run()

使用以下命令启动 Gunicorn：

gunicorn -w 4 myapp:app

其中，-w 4 表示启动 4 个工作进程。

应用案例和最佳实践

应用案例

Gunicorn 常用于部署 Flask、Django 等 Python Web 框架。以下是一个简单的 Django 项目部署示例：

1. 创建 Django 项目：

django-admin startproject myproject

2. 进入项目目录并启动 Gunicorn：

cd myproject
gunicorn myproject.wsgi:application

最佳实践

• 配置文件：使用配置文件管理 Gunicorn 的各项参数，例如工作进程数、绑定地址等。
• 日志管理：配置日志文件，便于排查问题。
• 监控：使用监控工具（如 Prometheus）监控 Gunicorn 的运行状态。

典型生态项目

Nginx

Gunicorn 通常与 Nginx 配合使用，以提供更好的性能和安全性。以下是一个简单的 Nginx 配置示例：

server {
    listen 80;
    server_name example.com;

    location / {
        proxy_pass http://127.0.0.1:8000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

进程管理工具

使用进程管理工具管理 Gunicorn 进程，确保应用稳定运行：

[program:myapp]
command=/path/to/gunicorn -w 4 myapp:app
directory=/path/to/myapp
autostart=true
autorestart=true
stderr_logfile=/var/log/myapp.err.log
stdout_logfile=/var/log/myapp.out.log

通过以上配置，可以确保 Gunicorn 进程在意外退出时自动重启。