Centos7.x快速配置Django+Nginx+Uwsgi服务

原创已于 2025-03-13 18:19:14 修改 · 3.7w 阅读

7 ·

CC 4.0 BY-SA版权

文章标签：

#nginx #django #python #linux #uwsgi

于 2020-05-29 17:49:36 首次发布

Python 全栈开发专栏收录该内容

65 篇文章

订阅专栏

本文分享了作者历经两天调试成功的Django+Nginx+uWSGI服务器部署经验，涵盖系统环境搭建、Nginx配置、uWSGI启动流程及DNS服务器配置，适合初学者快速上手。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

在 CentOS 7.x 上部署 Django + Nginx + uWSGI 是一种高效且稳定的 Web 应用部署方案。为了简化安装与配置流程，本指南提供了 最直接、最简洁 的方式，帮助开发者快速完成 Nginx 安装、uWSGI 配置、Django 运行以及 DNS 设置，确保项目能够稳定运行。

无论是新手还是经验丰富的开发者，都可以通过本文快速完成 Django 生产环境的部署。

系统环境

先说明一下百度上能搜索到的内容我这里就不重复了，并吐槽一下超级繁琐的流程，这里简化到醉简单直接开始正题。

需要选择适当的操作系统和安装相应的编程环境。本教程以CentOS 7.x操作系统为例，使用Python 3.x和Django 3.x进行示范。

搭建Nginx

打开终端并执行执行命令yum install epel-release，添加Nginx官方存储库以确保获取最新版本的Nginx。

yum install epel-release

执行命令yum install nginx，安装Nginx。

yum install nginx

在管理 Nginx 服务时，使用一系列的命令来控制其启动、停止、重载配置以及监视状态是非常重要的。以下表格列出了这些常用命令及其描述，提供了一个清晰的概览，帮助理解和执行服务管理操作：

命令	功能描述
`systemctl start nginx`	启动 nginx 服务，使其开始处理请求。
`whereis nginx`	查找 nginx 可执行文件和相关配置文件的位置。
`nginx`	进入 nginx 的可执行文件目录，通常用于直接调用 nginx 命令。
`./nginx -s reload`	在 nginx 目录下执行，用于重新加载配置文件，适用于配置更改后。
`systemctl status nginx`	查看 nginx 服务的当前运行状态，包括是否正在运行及运行时间等信息。
`systemctl start/stop/enable/disable nginx`	这组命令用于控制 nginx 的运行（启动/停止）和是否设为开机自启动（启用/禁用）。

这些命令为系统管理员提供了强大的工具，以确保 Nginx 服务按预期运行，并能够快速适应配置变更和系统需求。理解并熟练使用这些命令，对于维护 Web 服务器的稳定性和响应性至关重要。通过这样的命令行操作，管理员可以有效地管理其服务器，确保服务的可靠性和效率。

# 直接启动
systemctl start nginx

# 查找目录并进入nginx目录启动
whereis nginx
nginx
# 重新加载
./nginx -s reload

# 查看nginx的状态
systemctl status nginx 
 
# 启动/关闭/设置开机启动/禁止开机启动
systemctl start/stop/enable/disable nginx

安装完成后，可以通过浏览器打开服务器的IP地址（如xxx.xxx.xxx.xxx）来验证Nginx服务是否正常启动。

配置uwsgi

uWSGI是一个Web服务器，可以与Nginx配合使用来部署Python应用程序。默认已经安装好python3，执行命令pip3 install uwsgi安装uWSGI。

pip3 install uwsgi

执行命令ln -s /usr/local/python3/bin/uwsgi /usr/bin/uwsgi，建立软链接否则会报错 [uwsgi: command not found]

ln -s /usr/local/python3/bin/uwsgi /usr/bin/uwsgi

接下来创建配置文件。对于每个项目可以创建一个独立的配置文件，也可以尝试将所有配置集中在一起。这里将为每个项目创建一个独立的配置文件夹。

在项目目录中创建一个名为conf的文件夹。
在conf文件夹中创建nginx.conf文件，用于配置Nginx服务器以将请求转发到uWSGI服务器。

在这里插入图片描述
把刚创建好的conf文件夹中创建nginx.conf，配置Nginx服务器以转发请求到uWSGI服务器。

配置项	描述
`listen 80;`	设置 Nginx 监听 HTTP 默认端口 80，用于接收来自客户端的请求。
`server_name`	指定服务器域名，应替换为实际购买的域名。
`access_log`	定义访问日志的存放位置，用于记录所有成功的请求。
`error_log`	定义错误日志的存放位置，用于记录访问过程中发生的错误。
`location /`	配置根 URL (“/”) 的处理规则，通常使用 uWSGI 处理。
`include uwsgi_params;`	引入 uWSGI 的参数设置，确保请求的正确处理。
`uwsgi_pass 127.0.0.1:自定义端口号;`	将请求代理到运行在指定端口的 uWSGI 服务，端口号应与 uWSGI 配置一致。
`location /static/`	配置静态文件的处理，通常映射到项目的 `/static/` 目录。
`location /media/`	配置媒体文件的处理，通常映射到项目的 `/media/` 目录。

这种配置方式不仅确保了高效的请求处理，也利于资源的组织和管理。通过这些设置，Nginx 能够有效地分发静态内容，同时把动态内容请求正确地转发到 uWSGI，从而为 Web 应用提供稳定和高效的服务。这些配置的理解和应用是部署现代 Web 应用的关键步骤，有助于保证应用的可靠性和性能。

# nginx.conf 配置

server {
    listen       80; # 默认选80，为了是不希望浏览器中出现端口号
    server_name   你自定义的前缀.你购买的域名.你的域名后缀; # 这个地方是你访问这个网址进行项目浏览

    access_log /Django/你的项目/conf/access.log; # 存放访问成功日志
    error_log /Django/你的项目/conf/error.log; # 存放访问失败日志

    location / {
        include uwsgi_params;  # 这个默认不要动
        uwsgi_pass 127.0.0.1:自定义端口号;  # 这个端口号和runsever 0.0.0.0:端口号一样，这个要记住后面有用。
    }
    location /static/ {  # 配置各类文件比如static
        alias /你的项目目录/static/;
    }
    location /media/ {   # 配置各类文件比如media
        alias /你的项目目录/media/;
    }
}

把刚创建好的conf文件夹中创建uwsgi.ini用于设置uWSGI服务器。在uwsgi.ini文件中指定项目路径和Python虚拟环境路径。

配置项	描述
`[uwsgi]`	标记配置文件的开始，指定以下内容为 uWSGI 相关配置。
`master = true`	启用 master 模式，允许管理多个工作进程。
`processes = 4`	设置工作进程数为 4，可以根据服务器的性能和需求调整。
`chdir = /你的项目名称`	设置工作目录为你的项目根目录，应将 `/你的项目名称` 替换为实际项目路径。
`module = 你的项目名称.wsgi:application`	指定 WSGI 模块和应用程序对象，应替换为实际项目的模块名和应用对象。
`socket = 127.0.0.1:自定义端口号`	指定 uWSGI 服务绑定的本地 IP 地址和端口，端口号需根据需要自定义。
`logto = /你的项目名称/conf/uwsgi.log`	设置日志文件的路径，应根据实际路径替换。
`pidfile = /你的项目名称/conf/uwsgi.pid`	设置存储主进程 PID 的文件路径，需要替换为实际路径。

这种配置方式确保了 uWSGI 服务器能够有效地运行和管理 Python Web 应用，同时提供了日志记录和进程管理的功能，这对于维护和故障排查都非常重要。通过对这些配置项的理解和应用，用户可以灵活地部署和优化他们的 Web 应用服务。

# uwsgi.ini配置

[uwsgi]
# 守护进程
master = true  
# 进程个数
processes = 4  # 随意更改不能为0

# 项目地址
chdir = /你的项目名称，注意没有最后的"/"
# 指定uwsgi文件
module = 你的项目名称.wsgi:application  # 找到对应wsgi.py文件夹，你的项目名称就是这个文件夹的名字

# 和nginx通信地址:端口  nginx.conf 定义的端口号 要和uwsgi_pass  一样要不启动起来
socket = 127.0.0.1:自定义端口号

# 日志文件地址
logto = /你的项目名称/conf/uwsgi.log 

# pid文件
pidfile = /你的项目名称/conf/uwsgi.pid

如果是默认安装的话，打开目录 /ect/nginx 目录下找到 nginx.conf。 pid /run/nginx.pid; 这行代码指定了Nginx的pid文件的路径，该文件存储了主进程的进程ID。当你在前面加上 #，这行代码就被注释掉了，意味着Nginx不会再创建或者查找这个pid文件。include /你的项目/conf/*.conf; 这行代码表示包含你的项目中的所有 .conf 结尾的配置文件。Nginx 会读取这些配置文件中的指令。这些配置文件通常包含有关服务器的详细设置，如位置块，服务器名称，监听的端口等。这些设置被合并到了主配置文件中。

pid /run/nginx.pid;  # 这个注销掉
# 在include中添加你项目中的 nginx.conf文件
# 举例
include /你的项目/conf/*.conf;

在这里插入图片描述

启动流程

前提nginx已经启动了，然后进入你Django项目中的conf文件夹，执行命令uwsgi --ini uwsgi.ini启动服务。

uwsgi --ini uwsgi.ini

执行命令uwsgi --reload uwsgi.pid可以重载服务，每次更改Django目录里的任何文件需要重新加载才能生效，否则不生效。

uwsgi --reload uwsgi.pid

启动之后是这样证明启动成功了，然后重新加载nginx。通过命令whereis nginx找到nginx目录，然后执行命令cd /usr/sbin进入目录，执行命令./nginx -s reload重新加载nginx就可以了。

whereis nginx
cd /usr/sbin
./nginx -s reload

启动成功后会在你的项目的conf文件夹中生成如下文件。
在这里插入图片描述

配置DNS服务器

需要在你的域名中添加你在在nginx.conf 设置的 server_name否则不管用。把你Django开的各种端口关了就行了，一个项目只能有一个端口。
在这里插入图片描述

其他常用命令

在系统管理和网络服务配置中，常用命令行工具和命令对于维护服务器的运行至关重要。这些命令帮助管理员执行各种操作，如软件安装、服务管理、配置更新等。下面是一些关键命令的整理，涉及查找文件、更改目录、管理服务、以及网络状态查看等操作：

命令	功能描述
`whereis nginx`	查找`nginx`相关的二进制文件、源代码文件和帮助文件
`cd /usr/sbin`	更改当前工作目录到`/usr/sbin`，包含系统管理命令
`./nginx -s reload`	在当前目录下执行`nginx`，用`-s reload`重新加载配置文件
`systemctl start nginx.service`	启动名为`nginx.service`的服务
`systemctl stop nginx.service`	停止名为`nginx.service`的服务
`systemctl reload nginx.service`	重新加载名为`nginx.service`的服务
`systemctl status nginx.service`	查看名为`nginx.service`的服务状态
`uwsgi --ini uwsgi.ini`	使用`uwsgi`命令和`--ini`参数启动配置为`uwsgi.ini`的uWSGI服务器
`uwsgi --reload uwsgi.pid`	使用`uwsgi`命令和`--reload`参数重新加载`uwsgi.pid`的uWSGI服务器
`netstat --ntlp`	显示网络状态，包括协议、地址、连接状态及其进程

通过熟练掌握这些命令，系统管理员能够高效地处理服务的日常维护和故障排查任务，确保系统的稳定运行和服务的高可用性。这些命令的整合提供了一套强大的工具集，用于支持复杂的网络环境和服务配置。

whereis nginx
cd /usr/sbin
./nginx -s reload

systemctl start nginx.service
systemctl stop nginx.service
systemctl reload nginx.service
systemctl status nginx.service

uwsgi --ini uwsgi.ini

uwsgi --reload uwsgi.pid

netstat --ntlp

总结

本指南详细介绍了在 CentOS 7.x 上搭建 Django 生产环境 的完整流程，包括 Nginx 安装与配置、uWSGI 配置、Django 启动、DNS 服务器设置 以及 常用运维命令。正确配置 Nginx 与 uWSGI，可以确保 Web 应用高效运行，避免端口冲突和服务异常。

同时提供了关键的 启动、重载与调试 命令，帮助开发者快速定位并解决问题。希望本指南能够帮助开发者高效完成 Django 生产环境的部署，提高 Web 应用的稳定性与性能。