详解Django+Uwsgi+Nginx 实现生产环境部署

Mason
Mason
发布时间:2026-10-13 | 3人浏览过
原创

本文详细解析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;
}
}

以上为本文全部内容,希望对您的学习有所帮助,也欢迎大家继续支持本站。

本站声明

本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。

Python 相关产品和应用

全部下载

专题列表