uwsgi 配置总结

无论什么 python web 框架，比如 Django 或者 flask，都需要一个 web 服务器把应用跑起来。
常用的解决方案有 apache、nginx。这里介绍一下 nginx + uwsgi 的配置方式。

以 flask 为例，假设入口文件是这样的

from flask import Flask, request
app = Flask(__name__)

@app.route('/', methods=['GET', 'POST'])
def hello_world():
    return "hello world"

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

安装 uwsgi

#使用 python 的包管理工具安装即可
pip install uwsgi
 
#然后会自动生成一个 uwsgi 的可执行文件，般情况下是与 python 可执行文件同路径，比如我的在 ~/.jumbo/bin 目录下。
$ which uwsgi
~/.jumbo/bin/uwsgi

配置

创建一个配置文件，比如 uwsgi.ini

# socket 地址，与 nginx 通信时使用的特殊文件
socket = /home/raoweijian/project/python/login_transfer/uwsgi/uwsgi.sock
 
# master 进程的 pid 文件
pidfile = /home/raoweijian/project/python/login_transfer/uwsgi/uwsgi.pid


# 运行目录
chdir = /home/raoweijian/project/python/login_transfer
 
# 虚拟运行环境目录。 一般情况下，在进行完整的 python 项目开发时，都会创建一个虚拟环境，用于安装依赖的包。如果需要运行的项目有虚拟环境的话，可以在这里指定其目录。
# 想了解更多虚拟环境，请百度 virtualenv
virtualenv = /home/raoweijian/project/python/login_transfer/venv

# index 文件
wsgi-file = index.py
callable = app


# master
master = true


# 进程数，进程越多，处理并发请求能力越强。一般生产环境可以设置为 10 个，测试环境随意。
processes = 1
 
#排队的请求数，可以理解为最高并发量，生产环境可以设置为 1024 - 65000
listen = 100


# ... with appropriate permissions - may be needed
vacuum = true
chmod-socket = 777
#代码修改后自动重启
python-autoreload = 1

启动

#前台运行
uwsgi --ini uwsgi/uwsgi.ini
 
#后台运行
nohup uwsgi --ini uwsgi/uwsgi.ini &

nginx 配置

建议在 nginx 的配置文件目录下 conf.d/ 里新建一个独立的配置文件，方便管理

#定义一个 upstream
upstream login_transfer_sock {
    # 这里写上 uwsgi.ini 文件里定义的 socket 地址，注意格式
    server unix:///home/raoweijian/project/python/login_transfer/uwsgi/uwsgi.sock;
}
server {
    # the port your site will be served on
    listen 8036;
    # the domain name it will serve for
    server_name localhost;
    charset     utf-8;
    # max upload size
    client_max_body_size 1M;   # adjust to taste
    # Finally, send all non-media requests to the flask server
    location / {
        include     /home/raoweijian/.jumbo/etc/nginx/uwsgi_params;
        # 把请求转发到上面定义的 upstream
        uwsgi_pass  login_transfer_sock;
    }
}

重启 nginx

nginx -s reload

重启/停止 uwsgi

#重启和停止需要用到配置文件里定义的的 pidfile，这个文件记录了 uwsgi master 进程的 pid
 
#重启
uwsgi --reload uwsgi.pid
 
#停止
uwsgi --stop uwsgi.pid