我最近将我自己的 django 应用程序部署到生产环境中。该网站名为 videoeiro.com，是用 django HTML/CSS/JS Tailwind 开发的。

设置

我正在使用 debian 12 服务器，它将通过 cloudflare 隧道公开我的应用程序。所有静态文件都通过 nginx 提供服务，Django 项目由 Gunicorn 运行。

在本指南中，我将向您展示如何进行设置。

准备 Django 项目

您要做的第一件事是打开 settings.py 并更改以下内容

Debug = False
ALLOWED_HOSTS = ['yourdomain.tld']
CSRF_COOKIE_SECURE = True
CSRF_TRUSTED_ORIGINS = [
    'yourdomain.tld',
]

您还应该将 SECRET_KEY 更改为一个长随机字符串，您不应该与任何人共享。

之后创建一个名为 .gitignore 的新文件并粘贴以下内容：

db.sqlite3
*.pyc

这将确保数据库不会上传到我们的服务器，也不会上传 pyc 文件。

现在您可以将项目上传到新的 github 存储库（或 gitea 存储库）。如果您不希望每个人都可以访问您的源代码，请确保将存储库设置为私有。

如果您想确保源代码保持私有，我建议您设置一个自托管 gitea 实例，请阅读 Selfhost your own gitea instance - selfhosted, lightweight github Alternative，以了解如何做到这一点。

git init
git branch -M main
git add .
git commit -m "initial commit"
git remote add origin https://...
git push -u origin main

现在您已经完成了，您应该登录到您的服务器

服务器设置

在配置任何内容之前，请确保您不允许任何使用密码的 ssh 登录。遵循使用基于密钥的身份验证保护 ssh 来保护您的服务器免受此类攻击。

登录您的服务器

ssh [email protected]

确保您的包裹符合数据

sudo apt update && sudo apt upgrade

现在安装 python、pip、git 和 nginx

sudo apt install python3 python3-pip git nginx

现在将您的项目克隆到您的主目录中。

git clone https://...
cd my-project

安装后，安装以下内容：

pip install django django-crispy-forms whitenoise

现在尝试运行该项目：

python3 manage.py runserver

如果您收到缺少软件包的错误，请安装它并重新运行。

配置gunicorn

现在我们将设置gunicorn

首先安装

pip install gunicorn

现在用您最喜欢的文本编辑器创建一个名为gunicorn.service的新文件：

sudo vim /etc/systemd/system/gunicorn.service

并粘贴以下内容：

[Unit]
Description=gunicorn daemon
After=network.target

[Service]
User=YOURUSER
Group=www-data
WorkingDirectory=/home/YOURUSER/PROJECT
ExecStart=/path/to/gunicorn --access-logfile - --workers 3 --bind 127.0.0.1:8000 PROJECTNAME.wsgi:application

[Install]
WantedBy=multi-user.target

将 YOURUSER 更改为您的用户。

找到gunicorn运行的路径：

which gunicorn

您的项目名称是项目内包含 settings.py 文件的文件夹的名称。

现在运行以下命令来启动并启用gunicorn（开机启动）

sudo systemctl daemon-reload
sudo systemctl start gunicorn.service
sudo systemctl enable gunicorn.service

现在，如果您访问 127.0.0.1:8000，您应该会看到您的项目正在运行。

但是还没完

设置 nginx

现在我们需要通过 nginx 提供静态内容。

首先用你喜欢的文本编辑器创建一个新的nginx配置文件：

sudo vim /etc/nginx/sites-available/PROJECT

将 PROJECT 更改为您想要的任何内容

现在粘贴以下内容：

server {
    listen 80;
    server_name YOURDOMAIN;

    location /static/ {
    alias /var/www/staticfiles/;
    }

    location / {
        proxy_pass http://127.0.0.1:8000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

只需将 YOURDOMAIN 更改为将托管此域名的域。

创建符号链接以启用您的网站：

sudo ln -s /etc/nginx/sites-available/PROJECT /etc/nginx/sites-enabled/

启动并启用nginx:

sudo systemctl start nginx
sudo systemctl enable nginx

设置静态文件

您要做的第一件事是 cd 进入您的 (django) 项目

cd project

现在运行以下命令：

python3 manage.py collectstatic

这将创建一个名为 staticfiles 的新文件夹

现在要设置静态文件，我们有两个选项：

1. 将 /etc/nginx/nginx.conf 中的用户更改为您的用户（不太安全）
2. 将静态文件复制到/var/www/（更安全）

我将做第二个选项：

首先在/var/www中创建一个名为staticfiles的新文件

sudo mkdir -p /var/www/staticfiles

现在复制项目中的所有静态文件：

sudo cp staticfiles/* /var/www/staticfiles

现在 cd 进入 /var/www

cd /var/www

更改所有文件的所有权

sudo chown www-data:www-data staticfiles
sudo chown www-data:www-data staticfiles/*

重启nginx服务：

sudo systemctl restart nginx

现在如果您前往：

127.0.0.1

您应该看到您的网站正在运行，并提供所有静态文件！

通过 cloudflare 隧道暴露

现在让您的网站可公开访问。

为此，您需要一个 cloudflare 帐户和一个指向 cloudflare 的域名。

首先前往零信任仪表板

在“网络”下单击“隧道”，然后单击“创建隧道”

创建后，您应该安装并运行连接器，按照页面上的说明进行具体设置。

连接器运行后，您应该单击公共主机名选项卡并添加公共主机名。

现在您应该看到类似这样的内容：

填写我所拥有的信息。服务类型应为 HTTP，url 应为 127.0.0.1:80 或 localhost:80

现在，如果您前往指定的域，您应该会看到您的应用程序已启动并正在运行。

恭喜！

如果您喜欢这篇文章并想支持我的（大部分是无偿的）工作，您可以在这里捐款。

加入我的免费时事通讯！

在这里加入