树莓派部署django项目

如果你手里有台树莓派他可以作为 Web 服务器运行一些网站，比如你可以把个人网站部署到家里，成本很低可以不用购买服务器了。

部署概览

我们采用 nginx + uwsgi 的方案进行部署。整个系统架构图如下：

环境配置

树莓派默认安装了 pyoth3 直接使用即可，非常方便

首先需要安装 virtualenv 为其提供独立的环境，命令行如下：

pip3 install virtualenv

创建并生成环境，我的项目名为 demo，我决定将它放置在 /home/pi/www/demo 下，命令行如下：

cd ~/www/demo
python3 -m virtualenv --no-site-packages venv

激活环境命令为：

source venv/bin/activate

注：激活环境后，输入命令的指示标志前会变成类似 (venv) pi@raspberrypi:~/www/demo $。

退出当前环境命令为：

deactivate

uwsgi 配置

安装 uwsgi：

pip3 install uwsgi

配置 uwsgi，我们使用 .ini 文件配置。

新建一个 uwsgi 文件夹存放 uwsgi 相关的文件（配置、日志等），这个文件夹可以存放在任意位置，我将它放置在了 django 项目根目录下，其目录即为 /home/pi/www/uwsgi/，在文件夹下新建一个 uwsgi.ini 文件。文件内容如下：

# uwsgi使用配置文件启动
[uwsgi]
# 项目根目录，并非是app目录
chdir=/home/pi/www/demo/
# wsgi.py 的路径，demo是wsgi.py存在的目录名
module=demo.wsgi:application
# 指定sock的文件路径，用来与nginx通信       
socket=/home/pi/www/uwsgi/uwsgi.sock
# 进程个数       
workers=4
pidfile=/home/pi/www/uwsgi/uwsgi.pid
# 指定IP端口，这里可以用来测试uwsgi与django项目之间是否准确连接。调试好后可以注释掉
# 如果开启了可以不用开启nginx服务而直接通过 ip:8000       
# http=192.168.1.37:8000
​
# 这里使用上面收集的静态文件夹目录
static-map=/static=/home/pi/www/demo/static
# 启动uwsgi的用户名和用户组
uid=pi
gid=root
# 启用主进程
master=true
# 自动移除unix Socket和pid文件当服务停止的时候
vacuum=true
# 序列化接受的内容，如果可能的话
thunder-lock=true
# 启用线程
enable-threads=true
# 设置自中断时间
harakiri=30
# 设置缓冲
post-buffering=4096
# 设置日志目录
daemonize=/home/pi/www/uwsgi/uwsgi.log

启动 uwsgi 服务：

uwsgi --ini uwsgi.ini

nginx 配置

安装 nginx：

sudo apt-get install nginx

创建一个配置文件 nginx.conf 文件内容如下：

server { 
    listen 80; 
    server_name demo.pi.com; #如果解析到域名便填写域名，否则填写ip地址即可
    charset utf-8;
    gzip_types text/plain application/x-javascript text/css text/javascript application/x-httpd-php application/json text/json image/jpeg image/gif image/png application/octet-stream;
​
    error_page 404 /404.html;
    error_page 500 502 503 504 /50x.html;
​
    # 指定项目路径uwsgi
    location / {
        # uwsgi_params在nginx文件夹下
        include /etc/nginx/uwsgi_params; 
        # 设置连接uWSGI超时时间
        uwsgi_connect_timeout 30; 
        # nginx与uwsgi的通信方式，动态请求会通过sock传递给uwsgi处理
        uwsgi_pass unix:/home/pi/www/uwsgi/uwsgi.sock;
    }
​
    # 这里使用上面收集的静态文件夹目录
    location /static/ {
      alias /home/pi/www/demo/static/;
      index index.html index.htm;
    }
}

接下来把 nginx.conf 文件 移动到/etc/nignx/conf.d/目录下，nginx 默认会查找该目录下的配置

重启 nginx 使其生效：

service nginx restart

一键重启脚本

每次网站有变动时，总要在做这么几个事，关闭原有 uwsgi 服务，启动 uwsgi 服务，重启 nginx，太繁琐，我们写个脚本搞定它，我把脚本放在了 ~/www/uwsgi/ 这个目录，方便管理。脚本名为 run.sh，内容如下：

#!/bin/sh
sudo killall -9 uwsgi
/home/pi/www/demo/venv/bin/uwsgi --ini /home/pi/www/uwsgi/uwsgi.ini
sudo /etc/init.d/nginx restart

当中第三行的 uwsgi 相关路径换为你的项目对应的就 OK。

别忘了给这个文件执行权限：

chmod +x run.sh

以上完成之后，运行 ./run.sh 重启整个项目，然后在其他设备访问试试。