从零开始在 Ubuntu  下部署 Django + uwsgi + nginx

整体安装流程 安装 ubuntu ,安装 pip, 安装 uwsgi, 安装 django安装 nginx
整个请求逻辑
用户访问 -> nginx -> uwsgi -> django
其中静态文件 直接由 nginx 处理

  1. 安装 Ubuntu
    下载的时候, 看到 mini 版本只有几十兆, 就选了 mini 版本 链接在此
    安装的时候才发现, 好多都是要后面下载的, 不过无所谓了, 安装上就行了
  2. 安装 ssh server
    ssh server 可以让你在其他电脑上通过支持的命令行工具(如 mac 下的 终端, windows 下的 putty) 远程连接, 这样就不用一直守在机器旁边了.
    我自己安装的时候, 漏选了这一项, 导致安装好的 Ubuntu 没有ssh 服务器, 需要自己安装, 安装方法如下, 如果你已经有了就跳过 (可以在其他电脑上运行 ssh root@<服务器 ip> 来看, 如果提示连接拒绝, 就表示没有安装)
sudo apt-get update
sudo apt-get install openssh-server
service ssh start
  1. 安装 pip
    pip 是一个 python 下的包管理工具, 可以很方便的安装各类 python 的第三方工具, 类似 iOS 开发的 Cocoapod
curl -O https://bootstrap.pypa.io/get-pip.py 
sudo python3 get-pip.py
  1. 设置 pip 镜像
    由于默认服务器是在国外, 访问速度实在感人, 还好有各类国内的镜像可以加速访问. 这里使用清华大学的镜像服务
cd ~
mkdir .pip
cd .pip
cat -e "[global]\nindex-url = https://pypi.tuna.tsinghua.edu.cn/simple" > pip.config
  1. 安装 uwsgi
  2. 安装 python-dev
    安装 uwsgi 过程中, 需要编译, 要先安装 python 开发板
sudo apt-get install python3-dev
  1. 安装 gcc
    安装 uwsgi 需要一个 C 编译器, 所以还需要安装一个 gcc
sudo apt-get install gcc
  1. 安装 uwsgi
    一切准备妥当就可以安装 uwsgi 了
sudo pip3 install uwsgi

可以使用 uwsgi --version 来检查是否正确安装了

  1. 测试 uwsgi
    创建一个 test.py 文件测试
    内容如下
# test.py
def application(env, start_response):
    start_response('200 OK', [('Content-Type','text/html')])
    return [b"Hello World"]

在这个文件的目录内运行命令

uwsgi --http :8000 --wsgi-file test.py

打开浏览器输入服务器的 ip, 端口 8000 如果能看到 hello, world 就表安装 uwsgi 成功了

  1. 安装 django
sudo pip install django
  1. 创建一个 django 项目用来测试
django-admin startproject Hello

现在的目录结构应该是这样的

Hello/ 
    manage.py 
    Hello/ 
        __init__.py 
        settings.py 
        urls.py 
        wsgi.py
  1. 编辑 setting.py
    如果你安装的是1.10 以上的 django(可以运行命令 django-admin --version 来查看版本), 并且你需要在另外一台电脑上查看页面, 你就一定要设置 ALLOWED_HOSTS
    找到 settting.py 中的
...
DEBUG = True
ALLOWED_HOSTS = []
...

在 ALLOWED_HOSTS 中填入服务器的 ip 地址.

...
DEBUG = True
ALLOWED_HOSTS = ["192.168.1.5"]
...
  1. 使用 django 内置的服务器测试一下
    到项目的根目录中运行命令
python3 manage.py runserver

这个命令默认运行服务器在 8000 端口, 而且只会监听来自本机(服务器)的请求
如果需要在服务器之外的电脑中浏览, 需改成这个命令

python3 manage.py runserver 0.0.0.0:8000

在浏览器中输入服务器的地址加上端口, 就可以看到测试页面了, 不过这个是用来开发的测试服务器, 如果需要实际部署项目, 就不要用这个服务器了.

  1. 使用 uwsgi 测试 Django 项目
    在项目根目录(有 manage.py 的目录) 运行
uwsgi --http :8000 --module Hello.wsgi

打开浏览器输入服务器的 ip, 端口 8000 如果能看到django 的测试页面就表示 django 和 uwsgi 工作正常

  1. 安装 nginx
sudo apt-get install nginx

安装完毕,会自动开启 nginx 服务, 默认端口80, 打开浏览器, 输入服务地址, 可以看到 nginx 的测试页面

  1. 配置 nginx
    首先要将 uwsgi_params 文件拷贝到项目文件夹下. 拷贝过来后这个文件不用修改.
    原始的 uwsgi_params 文件在/etc/nginx/目录下
    新创建一个 nginx 配置文件, Hello_nginx.conf
    内容如下
upstream django {
        server 127.0.0.1:8001;
}
server {
        # the port your site will be served on
        listen      8000; # 端口号
        # the domain name it will serve for
        server_name 10.0.9.176; # 服务器 ip 或是域名
        charset     utf-8;
    
        # Django media
        location /media  {
            alias /home/yww/djangotest/Hello/media; # 媒体文件所在文件夹
        }

        location /static {
            alias /home/yww/djangotest/Hello/static; # 静态文件所在文件夹
        }
         # max upload size
        client_max_body_size 75M;   # adjust to taste

        # Finally, send all non-media requests to the Django server.
        location / {
            uwsgi_pass  django;
            include     /home/yww/djangotest/Hello/uwsgi_params; #uwsgi_params 路径
        }
}

这个配置文件告诉 nginx 从文件系统中拉起 media 和 static 文件作为服务,同时响应 django 的 request
在 /etc/nginx/sites-enabled 目录下创建本文件的连接, 使 nginx能够使用它:

sudo ln -s /home/yww/djangotest/Hello/Hello_nginx.conf /etc/nginx/sites-enabled/
  1. 部署静态文件
    在 django 的 setting 文件中,添加下面一行内容:
STATIC_ROOT = os.path.join(BASE_DIR, "static/")

然后运行

python3 manage.py collectstatic
  1. 测试 nginx 静态文件和媒体文件服务
    首先重启nginx服务:
service nginx restart

测试一下静态文件是否可以读取
访问 http://<服务器 ip>:8000/static/admin/css/base.css 看看是否正常显示这个文件
然后检查media文件是否已经正常
在项目根目录下新建一个 media 文件夹, 放入任意一张图片, 名字改为test.jpg
访问 http://<服务器 ip>:8000/media/test.jpg 看看是否正常显示图片

  1. 测试 nginx + uwsgi
    找到 第 6 步 创建的test.py, 放到 Django 项目根目录下测试
    运行命令
uwsgi --socket :8001 --wsgi-file test.py

访问 http://<服务器 ip>:8000/
如果能够显示 hello, world 就行了

  1. 用 UNIX socket 取代 TCP port
    对 Hello_nginx.conf 做如下修改
upstream django {
        #server 127.0.0.1:8001; # 去掉这行
        server unix:///home/yww/djangotest/Hello/Hello.sock; # 新建这行
}
...

然后重启服务器, 并运行 uWSGI, 代码如下

service nginx restart
uwsgi --socket Hello.sock --wsgi-file test.py --chmod-socket=662
  1. 测试 nginx + uwsgi + django
    只需要启动 uwsgi 就可以了, nginx 不需要重启
uwsgi --socket Hello.sock --module Hello.wsgi --chmod-socket=662

访问 http://<服务器 ip>:8000/
如果能够显示 django 的测试页面就大功告成了

  1. 使用 ini 文件运行 uwsgi
    上面的这个命令太长了, 也很容易写错, 我们可以写一个文件来方便运行 uwsgi
    在项目根目录下创建一个 Hello_uwsgi.ini
# Hello_uwsgi.ini file
[uwsgi]
# Django-related settings
# the base directory (full path)
chdir           = /home/yww/djangotest/Hello
# Django's wsgi file
module          = Hello.wsgi
# process-related settings
# master
master          = true
# maximum number of worker processes
processes       = 10
# the socket (use the full path to be safe)
socket          = /home/yww/djangotest/Hello/Hello.sock
chmod-socket    = 662
# clear environment on exit
vacuum          = true

运行 uwsgi 的时候就只需要运行这个命令就行了

uwsgi --ini Hello_uwsgi.ini

推荐阅读更多精彩内容