# Nginx+uWSGI部署Django项目
# Django 简介
Django 是一个高级的Python 网络框架，可以快速开发安全和可维护的网站。 由经验丰富的开发者构建，Django负责处理网站开发中麻烦的部分，因此你可以专注于编写应用程序，而无需重新开发。 它是免费和开源的，有活跃繁荣的社区，丰富的文档，以及很多免费和付费的解决方案。
# 部署流程(CentOS 7)
# 安装 Django
# 安装 python3
$ yum install -y python3
1
# 创建一个虚拟环境
首先创建django的工作目录：
$ mkdir my_django_app
$ cd my_django_app
1
2
2
使用如下命令创建一个虚拟环境（venv目录，里面包含了python的二进制包，pip等工具）：
$ python3 -m venv venv
1
使用上面刚创建好的虚拟环境：
$ source venv/bin/activate
1
# 安装 Django
使用pip工具安装：
(venv)$ pip install django
1
验证是否安装成功：
(venv)$ python -m django --version
1
# 创建一个 Django 项目
创建一个名为mydiangoapp的项目：
(venv)$ django-admin startproject mydjangoapp
1
迁移数据库并创建一个管理用户：
(venv)$ cd mydjangoapp
(venv)$ python manage.py migrate
(venv)$ python manage.py createsuperuser
# 接下来，会进入交互式命令，如下所示
Username (leave blank to use 'agou-ops'): admin
Email address: suofeiyaxx@gamil.com
Password:
Password (again):
Superuser created successfully.
1
2
3
4
5
6
7
8
9
2
3
4
5
6
7
8
9
默认情况下，Django使用的是SQLite数据库，如果用于生产环境，可以使用PostgreSQL ,MariaDB, Oracle或者MySQL 数据库.
❓如果你是迁移的项目，运行以下步骤：
# 首先，清除初始迁移和删除默认的sqlite数据库
(venv)$ find . -path "*/migrations/*.py" -not -name "__init__.py" -delete
(venv)$ find . -path "*/migrations/*.pyc" -delete
(venv)$ rm -f db.sqlite3
# 运行如下命令同步迁移数据库
(venv)$ python manage.py collectstatic
(venv)$ python manage.py makemigrations
(venv)$ python manage.py migrate
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
# 测试 Django 服务
(venv)$ python manage.py runserver [0.0.0.0:8000]
1
服务默认监听在本地的8000端口，打开浏览器，访问 http://localhost:8000 检查服务状态即可。
# 取消激活虚拟环境
当所有任务都完成之后，如果想要返回到原来的终端，使用以下命令取消激活虚拟环境即可：
(venv)$ deactivate
1
# 配置 nginx 和 uwsgi
# uwsgi 全局配置
sudo pip install uwsgi
sudo mkdir -p /etc/uwsgi/sites
cd /etc/uwsgi/sites
sudo vim mydjangoapp.ini
1
2
3
4
2
3
4
配置文件mydiangoapp.ini中添加如下内容：
[uwsgi]
project = <project_name>
username = <user_name>
base = /home/%(username)
chdir = %(base)/%(project)
home = %(base)/Env/env_1
module = %(project).wsgi:application
master = true
processes = 5
uid = %(username)
socket = /run/uwsgi/%(project).sock
chown-socket = %(username):nginx
chmod-socket = 660
vacuum = true
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
创建一个Unix socket来使用uWSGI协议来辅助 Ngx 反代：
# 编辑uwsgi的服务配置文件
$ sudo vim /etc/systemd/system/uwsgi.service
# ------------------------------
[Unit]
Description=uWSGI Emperor service
[Service]
# <user_name>为用户名称
ExecStartPre=/usr/bin/bash -c 'mkdir -p /run/uwsgi; chown <user_name>:nginx /run/uwsgi'
ExecStart=/usr/bin/uwsgi --emperor /etc/uwsgi/sites
Restart=always
KillSignal=SIGQUIT
Type=notify
NotifyAccess=all
[Install]
WantedBy=multi-user.target
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
# nginx 反代设置
server {
listen 8000;
server_name localhost;
location = favicon.ico { access_log off; log_not_found off; }
location /static/ {
root /home/<user_name>/<project_name>;
}
location / {
include uwsgi_params;
uwsgi_pass unix:/run/uwsgi/<project_name>.sock;
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
2
3
4
5
6
7
8
9
10
11
12
13
14
增加权限及启动服务：
$ sudo nginx -t
$ sudo usermod -a -G <user_name> nginx
$ chmod 710 /home/<user_name>
$ sudo systemctl start nginx
$ sudo systemctl start uwsgi
$ sudo systemctl enable nginx
$ sudo systemctl enable uwsgi
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
😄到此安装完成，打开浏览器访问 http://localhost:8000 测试即可。
# 其他
# Django 使用 MySQL 数据库
安装mysql客户端工具（服务器端在此不再赘述）：
(venv)$ sudo yum install -y mysql-connector-python.x86_64 mysql-community-devel.x86_64 mysql-cluster-community-client.x86_64 mysql-shell.x86_64 mysql-router.x86_64 gcc
pip install mysqlclient # inside the virtual environment
1
2
2
修改配置文件settings.py：
# 在行尾添加如下内容
STATIC_ROOT = os.path.join(BASE_DIR, "static/")
# 修改默认的数据库配置
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.mysql',
'NAME': 'first_db', # 数据库提前自行创建
'USER': 'root',
'PASSWORD': 'your-root-password',
'HOST': 'localhost',
'PORT': '',
}
}
# 修改监听地址，默认为本地localhost
ALLOWED_HOSTS = ['your_ip_here']
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
2
3
4
5
6
7
8
9
10
11
12
13
14
15
如果有firewalld防火墙，还需要：
$ sudo firewall-cmd --permanent --add-service=http
$ sudo firewall-cmd --permanent --add-port=8000/tcp
$ sudo firewall-cmd --complete-reload
$ sudo firewall-cmd --list-all
1
2
3
4
2
3
4
# 参考资料
- Deploy Django: https://www.codingpaths.com/django/deploy-django/