相关链接
Django Document
- Django Document - How to use Django with uWSGI
Static Files:
- Managing static files (e.g. images, JavaScript, CSS)
- Deploying static files
nginx document
- Using NGINX as an Application Gateway with uWSGI and Django
uwsgi document
- Quickstart for Python/WSGI applications
- Setting up Django and your web server with uWSGI and nginx -- 强烈推荐
概念
WSGI & uwsgi
WSGI （aka Web Server Gateway Interface）是 Python 定义的标准（PEP333， PEP3333），定义了 Web Server 和 Python Web APP 之间通信的标准
uwsgi 用 C 语言实现了 WSGI 协议
各组件之间的关系
relationship
github - dot language
客户端通过 HTTP协议 向web服务器请求网页，web服务器通过 WSGI协议（或 HTTP协议，socket）与 uwsgi 通信，uwsgi 调用 Python （Django）生成动态网页
为什么需要 WSGI
- 对于静态文件（HTML, CSS, JS, image）Nginx 可以直接发布
-
但对于动态生成的网页，Nginx 需要通过 WSGI 向 Django 获取；
nginx 需要服务两种内容
部署
所需组件
- Django 项目
- uwsgi
- nginx
Django 项目
# mysite/settings.py
import os
# Build paths inside the project like this: os.path.join(BASE_DIR, ...)
BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__))) # 项目的根目录
MEDIA_DIR = os.path.join(BASE_DIR, 'media') # 存放 Media 的目录
DEBUG = True
INSTALLED_APPS = [
'rango',
# ...
'django.contrib.staticfiles',
]
# Static files (CSS, JavaScript, Images)
# https://docs.djangoproject.com/en/2.0/howto/static-files/
# Static File
STATIC_URL = '/static/'
# Media File
MEDIA_ROOT = MEDIA_DIR
MEDIA_URL = '/media/'
为 Media Files 声明 URL
# mysite/urls.py
from django.contrib import admin
from django.conf import settings
from django.conf.urls.static import static
from django.urls import path
urlpatterns = [
# ...
path('admin/', admin.site.urls),
] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)
$ python manage.py runserver
HTML, Static Files 可以正常访问
Media Files 可以正常访问
在开发阶段，Django runserver 会通过
django.contrib.staticfiles自动服务位于 app 目录下的 Static 文件和指定目录 Media 文件
nginx
nginx -- 入门
systemctl status nginx # 查看状态
systemctl start nginx.service # 启动 nginx
systemctl enable nginx.service # 开机启动 nginx
nginx 欢迎页面 80 端口
nginx 配置文件
在 Django 项目根目录下创建 nginx 配置文件：mysite_nginx.conf
下面以一个项目为例：
- 项目根目录：
/root/django_projects/rango_website/ - static 文件目录：
/www/rango_website/static - media 文件目录：
/www/rango_website/media
# mysite_nginx.conf
# the upstream component nginx needs to connect to
# nginx 与 uwsgi 通信的地址
upstream django-rango {
# server unix:///path/to/your/mysite/mysite.sock; # for a file socket
server 127.0.0.1:8002; # for a web port socket (we'll use this first)
}
# 配置一台 Web Server, 监听 8080 端口
# configuration of the server
server {
# the port your site will be served on
listen 8080;
# the domain name it will serve for
server_name demo.econfig.cn; # substitute your machine's IP address or FQDN # web Server ip地址或域名
charset utf-8;
# max upload size
client_max_body_size 75M; # adjust to taste
# 指向 Media Files 目录
# Django media
location /media {
alias /www/rango_website/media; # your Django project's media files - amend as required
}
# 指向 Static Files 目录
location /static {
alias /www/rango_website/static; # your Django project's static files - amend as required
}
# 指向 Django 项目
# Finally, send all non-media requests to the Django server.
location / {
uwsgi_pass django-rango; # 上面 upstream 定义的名字
include /root/django_projects/rango_website/uwsgi_params; # the uwsgi_params file you installed
}
}
将 nginx 目录下的 uwsgi_params 复制到 Django项目根目录
$ cp /etc/nginx/uwsgi_params ~/django_projects/rango_website/
创建链接文件：将 Django项目根目录（上面刚刚创建）的 mysite_nginx.conf 链接到 nginx 的配置目录
$ sudo ln -s django_projects/rango_website/django-rango.conf /etc/nginx/conf.d/
让 nginx 重新载入配置文件
$ nginx -s reload
将 static文件 和 media文件 放到上面指定的目录
# mysite/settings.py
import os
# Build paths inside the project like this: os.path.join(BASE_DIR, ...)
BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
STATIC_DIR = '/www/rango_website/static' # static 要存放的目录
# 现在不用告诉 Django : media file 在哪里，因为它交给 nginx 处理
# 但如果还要 运行 Django runserver ，则可以保留
# MEDIA_DIR = os.path.join(BASE_DIR, 'media')
# SECURITY WARNING: don't run with debug turned on in production!
DEBUG = False
ALLOWED_HOSTS = ['demo.econfig.cn']
# Application definition
INSTALLED_APPS = [
'rango',
# ...
'django.contrib.staticfiles',
# Static files (CSS, JavaScript, Images)
# https://docs.djangoproject.com/en/2.0/howto/static-files/
# django 用于生成 static 文件的链接
STATIC_URL = '/static/'
STATIC_ROOT = STATIC_DIR
# 现在不用告诉 Django : media文件 在哪里
# 因为 static文件和 media文件 交给 nginx 去发布
# 但如果还要 运行 Django runserver ，则可以保留
MEDIA_URL = '/media/'
# MEDIA_ROOT = MEDIA_DIR
将 Django 项目 所有app的 static 文件收集到 /www/rango_website/static
$ python manage.py collectstatic
手动复制 media 文件
$ cp -r ./media /www/rango_website/
给 static 文件 和 media 文件访问权限
# chmod -R 755 /www
哎，终于好了，static 文件和 media 文件都交给 nginx 发布；人在塔在
static 文件可以正常访问
但首页却无法访问，因为动态页面要由 Django 生成，而我们还没启用 uwsgi
502 服务器端错误
uwsgi ：nginx 和 django 之间的通信媒介
注：这里的 djagno 项目是事先在 pipenv 虚拟环境创建的
$ pipenv install uwsgi # 安装uwsgi
$ pipenv shell # 进入 pipenv 虚拟环境
创建 uwsgi 配置文件：mysite_uwsgi.ini
[uwsgi]
socket = :8002 # uswgi 端口
chdir = /root/django_projects/rango_website # django项目根目录
module = rango_website.wsgi # django项目的 wsgi 模块 rango_website/wsgi.py
processes = 4 # 工作进程数
threads = 2 # 线程数
stats = 127.0.0.1:9002 # 进程统计信息
virtualenv = /root/.local/share/virtualenvs/rango_website-e68KS5mW/ # 虚拟环境位置
# 1个 uwsgi 主进程
# 4个 处理请求的进程
# 每个工作进程有2个线程
啊？我忘记虚拟环境的路径是什么了...
$ pipenv --venv # 查看虚拟环境路径
/root/.local/share/virtualenvs/rango_website-e68KS5mW
启动 uswgi
$ uwsgi rango_uwsgi.ini
uwsgi 启动成功
访问首页
relationship
错误
访问 static 文件和 media 文件 出现 404 错误
反问三连
- nginx 配置文件中 static 文件和 media文件 的路径正确吗
mysite_nginx.conf
重新载入 nginx 配置文件了吗
nginx -s reloadstatic 文件 和 media 文件放到 指定目录了吗
$ python manage.py collectstatic
$ cp -r ./media /www/rango_website/
访问 static 文件和 media 文件 出现 403 错误 （拒绝访问）
目录权限给了吗 # chmod -R 755 /www