django nginx 静态

### 配置 Django 和 Nginx 处理静态文件 #### 1. 设置 `STATIC_ROOT` 并收集静态文件 在 Django 的 `settings.py` 文件中，定义 `STATIC_ROOT` 路径用于存储所有的静态文件。通常的做法是在项目的根目录下创建一个名为 `static` 的文件夹，并将其路径赋值给 `STATIC_ROOT`。 ```python import os BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__))) STATIC_URL = '/static/' STATIC_ROOT = os.path.join(BASE_DIR, 'static') ``` 完成上述设置后，运行以下命令以将所有应用中的静态文件复制到 `STATIC_ROOT` 指定的位置： ```bash python manage.py collectstatic ``` 此命令会将项目中所有已注册的应用程序的静态资源集中存放到 `STATIC_ROOT` 所指向的目录中[^1]。 --- #### 2. 配置 Nginx 来服务静态文件 编辑 Nginx 的配置文件（通常是 `/etc/nginx/sites-available/your_project_name` 或者 `/etc/nginx/conf.d/default.conf`），并添加针对静态文件的服务规则。以下是典型的配置示例： ```nginx server { listen 80; server_name your_domain.com; location / { proxy_pass http://127.0.0.1:8000; # 将请求转发至Django开发服务器或Gunicorn/uWSGI proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; } location /static/ { alias /path/to/your/project/static/; # 替换为实际的STATIC_ROOT路径 autoindex on; # 可选：允许浏览目录结构 } } ``` 注意，在 `location /static/ {}` 中使用的 `alias` 关键字表示的是具体的物理路径，而不是相对路径。确保替换其中的占位符为真实的路径[^2]。 --- #### 3. 解决权限问题 如果遇到静态文件无法访问的情况（例如返回 HTTP 403 Forbidden 错误），可能是由于 Nginx 用户没有足够的权限去读取这些静态文件所在的目录。可以通过修改 Nginx 的用户配置解决这一问题。 打开 Nginx 的主配置文件 `/etc/nginx/nginx.conf`，找到类似以下的一行： ```nginx user www-data; ``` 将其更改为当前运行 Django 应用的用户名，比如 `root` 或其他自定义用户： ```nginx user root; ``` 保存更改后，测试 Nginx 配置的有效性： ```bash sudo service nginx configtest ``` 如果没有错误提示，则重新加载 Nginx 服务使新配置生效： ```bash sudo service nginx reload ``` 最后重启 Nginx 确保一切正常运作： ```bash sudo service nginx restart ``` 这样可以有效避免因为权限不足而导致的静态文件不可见问题[^3]。 --- #### 4. 测试配置效果 启动 Django 开发服务器或者 WSGI 容器（如 Gunicorn 或 uWSGI）。随后尝试通过浏览器访问您的域名下的某个静态文件 URL 地址，验证其是否能够成功下载或显示出来。例如，如果您有一个 CSS 文件位于 `/static/css/style.css` 下面，那么应该可以直接通过 `http://your_domain.com/static/css/style.css` 访问它。 --- ### 注意事项 当您使用子域或者其他复杂的路由逻辑时，请特别留意 Nginx 对于不同路径模式匹配顺序的影响。必要情况下调整 `location` 块优先级以满足需求[^4]。