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

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

本文详细解析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 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。