详解Django+Uwsgi+Nginx 实现生产环境部署
本文详细解析Django在生产环境中的部署方案,涵盖Uwsgi安装、配置及与Nginx的集成。文章区分了WSGI、uwsgi协议与uWSGI服务器的概念,提供了从命令行启动到配置文件管理的完整步骤,并解决静态文件加载问题,帮助开发者实现高效稳定的Web服务部署。
uWSGI介绍
uWSGI是一款Web服务器,支持WSGI、uwsgi及HTTP等多种协议。在Nginx架构中,HttpUwsgiModule模块负责与uWSGI服务器进行数据交互。
需明确区分WSGI、uwsgi与uWSGI这三个概念。
WSGI(Web Server Gateway Interface)是Web服务器网关接口,定义了Web服务器(如Nginx、uWSGI等)与Web应用(如基于Flask开发的程序)之间的通信规范。
uwsgi是一种线路协议,而非通信协议,主要用于uWSGI服务器与其他网络服务器之间的数据通信。
uWSGI则是实现了uwsgi和WSGI两种协议的Web服务器。
uwsgi协议是uWSGI服务器自有的协议,用于定义传输信息的类型。每个uwsgi数据包前4字节为传输信息类型的描述,这与WSGI有着本质区别。
安装uwsgi
pip install uwsgi
注意,uwsgi不支持Windows系统。
测试启动
创建测试文件并写入以下内容:
def application(environ, start_response):
status = '200 OK'
output = 'Hello World! powerde by wsgi'
response_headers = [('Content-type', 'text/plain'),
('Content-Length', str(len(output)))]
start_response(status, response_headers)
return [output.encode('utf8'),]
执行命令:
uwsgi --http :8080 --file test.py
通过浏览器访问该端口,正常情况下应能获取到输出结果。
使用uwsgi启动Django项目
uwsgi --http :8080 --file django_project/wsgi.py
页面可以访问,但静态文件无法加载,需要额外配置。
uwsgi --http :8080 --file django_project/wsgi.py --static-map=/static=static
配置完成后,静态文件即可正常加载。
参数说明:
- http参数与runserver类似,用于指定IP和端口。
- file参数指向包含WSGI接口的文件,若未指定Web Server,则使用默认设置。
- static参数用于建立映射,指定静态文件目录。
使用uwsgi配置文件启动Django项目
uwsgi支持大量参数,可将其写入配置文件中。在项目同级目录下创建uwsgi.ini文件:
# uwsig使用配置文件启动 [uwsgi] # 项目目录 chdir=/opt/webvirtcloud/ # 指定项目的application module=webvirtcloud.wsgi:application # 指定sock的文件路径 socket=/tmp/uwsgi.sock # 进程个数 workers=5 pidfile=/tmp/uwsgi.pid # 指定IP端口 http=0.0.0.0:8080 # 如果和ngxin结合,本行注释掉 # 指定静态文件 static-map=/static=/opt/webvirtcloud/static # 启动uwsgi的用户名和用户组 uid=root gid=root # 启用主进程 master=true # 自动移除unix Socket和pid文件当服务停止的时候 vacuum=true # 序列化接受的内容,如果可能的话 thunder-lock=true # 启用线程 enable-threads=true # 设置自中断时间 harakiri=30 # 设置缓冲 post-buffering=4096 # 设置日志目录 daemonize=/var/log/uwsgi.log
更多参数详情可参考:https://uwsgi-docs.readthedocs.io/en/latest/Options.html
执行命令:uwsgi --ini uwsgi.ini。此时无需依赖shell终端,即使断开shell连接,页面仍可正常访问。
那么如何关闭或重启该服务呢?
uwsgi --stop /tmp/uwsgi.pid
配置Nginx
找到Nginx的配置文件,若使用虚拟域名,则在虚拟域名配置中写入:
server {
listen 80;
server_name localhost;
location / {
include uwsgi_params;
uwsgi_pass 127.0.0.1:8080; //必须和uwsgi中socket的设置一致
client_max_body_size 35m;
}
}
以上为本文全部内容,希望对您的学习有所帮助,也欢迎大家继续支持本站。
本站声明
本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。













