在 Debian 11 上使用 Django 和 Nginx、PostgreSQL 和 Gunicorn

Django是一个免费的开源 Python Web 框架。本文提供了在 Debian 11 服务器上使用 Nginx、Gunicorn 和免费的 Let’s Encrypt TLS 证书设置 Django 项目的分步指南。

二、准备工作

在 Vultr 部署新的Debain 11 服务器
创建 sudo 用户。示例用户是django_user
更新服务器
将域名指向服务器。让我们加密 SSL/TLS 证书需要域名。本指南使用顶级域 example.com 和完全限定域名mydjango.example.com，并假定为这两个名称分配了相同的 IP 地址。

三、安装依赖项

通过 SSH 使用非 root sudo 用户登录到服务器。
```
$ ssh django_user@mydjango.example.com
```
安装，，并使用 apt 包管理器。UFWVimNginx
```
$ sudo apt -y install ufw vim nginx
```
允许所有出站流量。
```
$ sudo ufw default allow outgoing
```
阻止除 SSH（端口 22）、HTTP（端口 80）和 HTTPS（端口 443）之外的所有入站流量。
```
$ sudo ufw default deny incoming

$ sudo ufw allow ssh

$ sudo ufw allow http

$ sudo ufw allow https
```
启用并重新加载。UFW
```
$ sudo ufw enable

$ sudo ufw reload
```

四、安装 PostgresSQL

使用 apt 包管理器安装 PostgreSQL，在安装过程中会创建一个 postgres 用户。
```
$ sudo apt install -y postgresql postgresql-contrib
```
切换到 postgres 用户。
```
$ sudo su - postgres
```
Log in to PostgresSQL.
```
$ psql
```
Create a PostgresSQL database role for the Django project.
```
postgres=# CREATE ROLE dbuser WITH LOGIN;
```
Set password for role.dbuser
```
postgres=# \password dbuser
```

Set encoding to .dbuserUTF-8

postgres=# ALTER ROLE dbuser SET client_encoding TO 'utf8';

Set default transaction isolation to read commit.dbuser

postgres=# ALTER ROLE dbuser SET default_transaction_isolation TO 'read committed';

Set timezone to .dbuserUTC

postgres=# ALTER ROLE dbuser SET timezone TO 'UTC';

Create the Django project database.
```
postgres=# CREATE DATABASE appdb;
```

Grant the all privileges to .dbuserappdb

postgres=# GRANT ALL PRIVILEGES ON DATABASE appdb TO dbuser;

Exit the postgres client.
```
postgres=# \q
```
Exit to sudo
```
exit
```
Restart the PostgresSQL server.
```
$ sudo systemctl restart postgresql
```

五、设置 Python 环境

部署 Python Web 应用程序时应使用 Python 虚拟环境。

安装蟒蛇。venv
```
$ sudo apt -y install python3-venv
```
创建应用程序目录、虚拟环境所在的位置以及应用程序文件。例。切换到主目录。app_dir
```
$ cd ~
```
创建目录。
```
$ mkdir app_dir
```
更改为并创建虚拟环境。app dir
```
$ cd app_dir

$ python3 -m venv venv
```
激活虚拟环境。
```
$ source venv/bin/activate
```
安装 Python PostgresSQL 库而不是，因为在安装过程中需要构建。psycopg2-binarypsycopg2psycopg2
```
$ pip install psycopg2-binary
```
安装 Django 和 Gunicorn。
```
$ pip install django gunicorn
```

六、上传或创建 Django 项目

项目源码需要用 git 或者 scp 上传到 app 目录下，对于本文，创建一个名为的示例项目。app_direxample_app
```
$ django-admin startproject example_app .
```
检查文件夹结构。app_dir
```
$ ls

example_app manage.py venv
```
创建一个文件夹来将 Django 项目的静态文件保存在应用程序文件夹中。
```
$ mkdir static
```
打开 inwith以配置项目。settings.pyexample_appVim
```
$ vim example_app/settings.py
```

配置域的允许主机。

ALLOWED_HOSTS = ['mydjango.example.com']

使用创建自的详细信息配置变量。DATABASESsection 2

DATABASES = {

    "default" : {

        "ENGINE" : "django.db.backends.postgresql",

        "NAME" : "appdb",

        "USER" : "dbuser",



        "PASSWORD" : "dbpassword",



        "HOST" : "127.0.0.1",              

        "PORT" : "5432",



        }

}

设置静态文件夹路径。在它下面寻找添加。STATIC_URLSTATIC_ROOT
```
STATIC_ROOT = "/home/django_user/app_dir/static"
```
保存并关闭文件。settings.py
创建项目迁移。
```
$ python manage.py makemigrations
```
运行迁移。
```
$ python manage.py migrate
```
将项目的所有静态文件复制到静态文件夹。类型出现提示时。yes
```
$ python manage.py collectstatic
```
为项目创建管理员用户。
```
$ python manage.py createsuperuser
```
允许波顿。8000UFW
```
$ sudo ufw allow 8000
```

测试项目以确保其运行没有错误。

$ python manage.py runserver 0.0.0.0:8000



Watching for file changes with StatReloader

Performing system checks...



System check identified no issues (0 silenced).

November 16, 2022 - 21:19:26

Django version 4.1.3, using settings 'example_app.settings'

Starting development server at http://0.0.0.0:8000/

Quit the server with CONTROL-C.

七、配置独角兽

将创建一个 Gunicorn 服务来为项目提供服务，并在服务器重新启动时启动项目。

测试Gunicorn，看看它是否可以毫无错误地为项目服务。
```
$ gunicorn --bind 0.0.0.0:8000 example_app.wsgi
```
按+停止它。CTRLC
停用虚拟环境
```
$ deactivate
```
编辑文件。settings.pyVim
```
$ vim example_app/settings.py
```
禁用调试。查找变量并将其设置为。DEBUGFalse
```
DEBUG = False
```
保存并关闭文件。settings.py
拒绝端口 8000 的传入流量。UFW
```
$ sudo ufw deny 8000
```
在目录中创建一个文件。django_app.service/etc/systemd/system
```
$ sudo vim /etc/systemd/system/django_app.service
```
将以下内容写入文件。
```
[Unit]



Description=Gunicorn for the Django project

After=network.target



[Service]



User=django_user

Group=www-data





WorkingDirectory=/home/django_user/app_dir

Environment="PATH=/home/django_user/app_dir/venv/bin"

ExecStart=/home/django_user/app_dir/venv/bin/gunicorn --workers 2 --bind unix:django_app.sock example_app.wsgi





[Install]



WantedBy=multi-user.target
```
- 下，设置服务的用户，并将服务的组设置为 Nginx 组。[Service]USER=django_userGroup=www-data
- WorkingDirectory=/home/django_user/app_dir将服务工作目录设置为“项目”文件夹。
- Environment="PATH=/home/django_user/app_dir/venv/bin"设置服务应使用的虚拟环境。
- ExecStart=/home/django_user/app_dir/venv/bin/gunicorn --workers 2 --bind unix:django_app.sock example_app.wsgi为项目运行 Gunicorn worker 服务，并将它们绑定到 Unix 套接字，以便更快地交换 Nginx 代理服务器的数据。
保存并关闭文件。
使服务能够在启动时启动。
```
$ sudo systemctl enable django_app
```
启动服务。
```
$ sudo systemctl start django_app
```

八、配置云

需要一个 Nginx 代理服务器来为生产中的 Django 应用程序提供服务并处理SSL证书。

通过创建文件在 Nginx 中配置服务器块。django_app/etc/nginx/sites-available
```
$ sudo vim /etc/nginx/sites-available/django_app
```

将以下内容写入文件。

server {

    # listen to port 80 (HTTP)

    listen 80;

    # listen to the domain name

    server_name example.com mydjango.example.com;



    location /static/ {

        alias /home/django_user/app_dir/static/;

        expires max;

    }



    location / {

        include proxy_params;



        # pass the request to the project service sock

        proxy_pass http://unix:/home/django_user/app_dir/django_app.sock;

    }

}

保存并关闭文件。

为Nginx创建一个链接。django_appsites-enabled

$ sudo ln -s /etc/nginx/sites-available/django_app /etc/nginx/sites-enabled

检查 Nginx 配置是否有任何错误。
```
$ sudo nginx -t
```
重新启动 Nginx 服务器。
```
$ sudo systemctl reload nginx
```

九、（可选）使用加密添加 HTTPS

如果您在开始时配置了域，则可以使用 Let’s Encrypt 添加 SSL / TLS 证书以提供 HTTPS 支持。

使用插件安装。CertbotNginx

$ sudo apt install certbot python3-certbot-nginx

配置方式。CertbotNginx

$ sudo certbot --nginx -d example.com -d mydjango.example.com

首次运行 Certbot 时，将请求证书的管理员电子邮件。Certbot 还将配置 Nginx，并通过配置服务器块将所有 HTTP请求重定向到 HTTPS。

Saving debug log to /var/log/letsencrypt/letsencrypt.log

Plugins selected: Authenticator nginx, Installer nginx

Enter email address (used for urgent renewal and security notices)

 (Enter 'c' to cancel): me@example.com



- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Please read the Terms of Service at

https://letsencrypt.org/documents/LE-SA-v1.3-September-21-2022.pdf. You must

agree in order to register with the ACME server. Do you agree?

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

(Y)es/(N)o: y



- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Would you be willing, once your first certificate is successfully issued, to

share your email address with the Electronic Frontier Foundation, a founding

partner of the Let's Encrypt project and the non-profit organization that

develops Certbot? We'd like to send you email about our work encrypting the web,

EFF news, campaigns, and ways to support digital freedom.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

(Y)es/(N)o: y

Account registered.

Requesting a certificate for example.com and mydjango.example.com

Performing the following challenges:

http-01 challenge for example.com

http-01 challenge for mydjango.example.com

Waiting for verification...

Cleaning up challenges

Deploying Certificate to VirtualHost /etc/nginx/sites-enabled/django_app

Deploying Certificate to VirtualHost /etc/nginx/sites-enabled/django_app

Redirecting all traffic on port 80 to ssl in /etc/nginx/sites-enabled/django_app

Redirecting all traffic on port 80 to ssl in /etc/nginx/sites-enabled/django_app



- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Congratulations! You have successfully enabled https://example.com and

https://mydjango.example.com

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Subscribe to the EFF mailing list (email: me@example.com).



IMPORTANT NOTES:

 - Congratulations! Your certificate and chain have been saved at:

   /etc/letsencrypt/live/example.com/fullchain.pem

   Your key file has been saved at:

   /etc/letsencrypt/live/example.com/privkey.pem

   Your certificate will expire on 2023-02-15. To obtain a new or

   tweaked version of this certificate in the future, simply run

   certbot again with the "certonly" option. To non-interactively

   renew *all* of your certificates, run "certbot renew"

 - If you like Certbot, please consider supporting our work by:



   Donating to ISRG / Let's Encrypt:   https://letsencrypt.org/donate

   Donating to EFF:                    https://eff.org/donate-le

重新启动。Nginx
```
$ sudo systemctl reload nginx
```

在浏览器中访问服务器的域。mydjango.example.com/admin

在 Debian 11 上使用 Django 和 Nginx、PostgreSQL 和 Gunicorn

一、介绍

二、准备工作

三、安装依赖项

四、安装 PostgresSQL

五、设置 Python 环境

六、上传或创建 Django 项目

七、配置独角兽

八、配置云

九、（可选）使用加密添加 HTTPS

相关推荐

联系本站

最新文章

热门文章

热门标签

网站统计

其他操作

一、介绍

二、准备工作

三、 安装依赖项

四、 安装 PostgresSQL

五、设置 Python 环境

六、上传或创建 Django 项目

七、配置独角兽

八、配置云

九、（可选）使用加密添加 HTTPS

相关推荐

联系本站

最新文章

热门文章

热门标签

网站统计

其他操作

三、安装依赖项

四、安装 PostgresSQL