### 在 Django 项目中正确配置
uWSGI
为了使
uWSGI 能够与 Django 项目配合工作，需要完成几个关键步骤。以下是详细的配置方法：
#### 1. ### 创建 WSGI 文件
Django 默认会生成一个 `wsgi.py` 文件作为入口点。此文件位于项目的根目录下，通常命名为 `<project_name>/wsgi.py`。确保该文件存在并已正确配置。
示例内容如下：
```python
import os
from django.core.wsgi import get_wsgi_
application
os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'myproject.settings')
application = get_wsgi_
application()
```
这是
uWSGI 加载应用的关键部分[^3]。
---
#### 2. ### 安装
uWSGI 并测试基本功能
在虚拟环境中安装
uWSGI：
```bash
pip install
uwsgi
```
接着，可以通过简单的命令测试
uWSGI 是否能加载 Django 应用：
```bash
uwsgi --http :8001 --chdir /path/to/your/project -w myproject.wsgi
```
其中：
- `/path/to/your/project` 是 Django 项目的根目录。
- `myproject.wsgi` 是指向 `wsgi.py` 的模块名。
如果一切正常，应该可以在浏览器中访问 `http://localhost:8001` 来查看 Django 页面[^3]。
---
#### 3. ### 编写
uWSGI 配置文件
推荐使用 `.ini` 格式的配置文件来管理复杂的部署需求。以下是一个典型的配置示例：
```ini
[
uwsgi]
module
= myproject.wsgi:
application
master
= true
processes
= 4
threads
= 2
socket
= /tmp/
uwsgi.sock
chmod-socket
= 660
vacuum
= true
die-on-term
= true
logto
= /var/log/
uwsgi/myproject.log
```
解释各参数的作用：
- `module`: 指向 WSGI 入口点。
- `master`: 开启主进程模式。
- `processes`: 设置并发的工作进程数。
- `threads`: 每个工作进程的线程数量。
- `socket`: 使用 Unix Socket 方式通信（推荐用于生产环境）。
- `chmod-socket`: 修改套接字权限以允许 Nginx 访问。
- `vacuum`: 自动清理临时文件。
- `die-on-term`: 接收到终止信号时优雅关闭。
- `logto`: 日志保存路径[^2]。
将上述内容保存为 `
uwsgi.ini` 文件，并放置于项目根目录下。
---
#### 4. ### 测试
uWSGI 配置文件
通过以下命令启动
uWSGI：
```bash
uwsgi --ini
uwsgi.ini
```
检查日志输出是否正常。如果有错误提示，可以根据具体信息调整配置。
---
#### 5. ### 配置 Nginx 反向代理
为了让外部请求能够到达
uWSGI，需配置 Nginx 作为反向代理。编辑 Nginx 配置文件（通常位于 `/etc/nginx/sites-available/default` 或类似的路径），添加以下内容：
```nginx
server {
listen 80;
server_name yourdomain.com;
location
= /favicon.ico { access_log off; log_not_found off; }
location /static/ {
root /path/to/your/project/;
}
location / {
include
uwsgi_params;
uwsgi_pass unix:/tmp/
uwsgi.sock;
}
}
```
主要关注点：
- `location /static/`: 映射静态文件路径。
- `include
uwsgi_params`: 导入标准的
uWSGI 参数。
- `
uwsgi_pass`: 指定
uWSGI 套接字地址。
完成后重启 Nginx：
```bash
sudo systemctl restart nginx
```
---
#### 6. ### 系统服务化（可选）
为了实现自动启动和后台运行，可以将
uWSGI 注册为系统服务。创建一个新的 systemd 服务文件 `/etc/systemd/system/
uwsgi.service`，内容如下：
```ini
[Unit]
Description
=uWSGI instance to serve myproject
After
=network.target
[Service]
User
=<username>
Group
=<groupname>
WorkingDirectory
=/path/to/your/project/
Environment
="PATH
=/path/to/venv/bin"
ExecStart
=/usr/local/bin/
uwsgi --ini /path/to/your/project/
uwsgi.ini
[Install]
WantedBy
=multi-user.target
```
启用并启动服务：
```bash
sudo systemctl enable
uwsgi
sudo systemctl start
uwsgi
```
---
### 总结
以上步骤涵盖了从基础到高级的
uWSGI 配置过程，适用于大多数 Django 生产环境部署场景。每一步都经过精心设计，旨在提高稳定性和性能。
---
扫一扫
2328
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
