NGINX与Gunicorn部署Netbox时静态资源加载失败求助

首先明确几个核心前提：Gunicorn本身不处理静态文件，生产环境下Django的DEBUG=False时也不会自动提供静态文件服务，所以静态文件必须由Nginx（或Apache）直接接管处理。你提到直接访问Gunicorn端口时也出现静态文件404，这其实是正常现象——问题的核心还是在反向代理服务器是否正确拦截了静态文件请求，以及Django静态文件的收集配置是否准确。

下面是具体的排查步骤：

1. 确认Netbox静态文件的配置与收集是否正确 #

Netbox通过configuration.py覆盖Django默认设置，先重点检查这个文件：

• 核实STATIC_URL = '/static/'（默认配置通常是这个，但最好确认没有被修改）
• 确认STATIC_ROOT的路径和你Nginx配置里的完全一致：STATIC_ROOT = '/opt/netbox/netbox/static/'
• 务必确认执行过静态文件收集命令：

  cd /opt/netbox/netbox
  python manage.py collectstatic
  

  执行时会提示是否覆盖现有文件，输入yes即可。这个命令会把Netbox所有应用的静态文件统一复制到STATIC_ROOT目录，哪怕你说目录里已有文件，也可能存在文件不全或路径不匹配的情况。

2. 检查Nginx的权限与路径配置 #

2.1 验证Nginx配置的有效性 #

先确保你的Nginx配置没有语法错误：

nginx -t

如果提示test is successful，再重新加载配置使其生效：

sudo systemctl reload nginx

2.2 确认Nginx运行用户的访问权限 #

Nginx默认以www-data（Ubuntu）或nginx（CentOS）用户运行，要确保这个用户能访问静态文件目录：

• 查看Nginx运行用户：ps aux | grep nginx，观察输出第一列的用户名
• 检查目录及文件权限：

  # 检查静态文件目录权限
  ls -ld /opt/netbox/netbox/static/
  # 检查父目录权限（必须允许Nginx用户进入）
  ls -ld /opt/netbox/netbox/
  

  目录权限至少为755，文件权限至少为644。如果权限不足，执行以下命令修正：

  sudo chmod -R 755 /opt/netbox/netbox/static/
  # Ubuntu用www-data，CentOS替换为nginx
  sudo chown -R root:www-data /opt/netbox/netbox/static/
  

2.3 验证Nginx的location配置逻辑 #

你使用的alias配置格式是正确的，但要注意：alias后的路径必须以/结尾，否则会导致路径拼接错误。你的配置alias /opt/netbox/netbox/static/;符合要求，但可以通过日志验证实际请求路径：

• 在nginx.conf的http块中临时开启debug日志：error_log /var/log/nginx/error.log debug;
• 重新加载Nginx后，访问一个静态文件（比如https://netbox.example.com/static/css/base.css）
• 查看error.log，确认Nginx实际尝试访问的文件路径是否和你预期一致。

3. 排查SELinux限制（针对CentOS/RHEL系统） #

CentOS默认开启SELinux，可能会阻止Nginx访问/opt/netbox这类非标准目录：

• 临时关闭SELinux测试：

  sudo setenforce 0
  

  如果关闭后静态文件能正常加载，说明是SELinux的问题，需要设置正确的文件上下文：

  sudo chcon -R system_u:object_r:httpd_sys_content_t:s0 /opt/netbox/netbox/static/
  # 永久设置上下文（需先安装policycoreutils-python-utils）
  sudo semanage fcontext -a -t httpd_sys_content_t "/opt/netbox/netbox/static(/.*)?"
  sudo restorecon -R /opt/netbox/netbox/static/
  

4. Apache配置排查（如果你尝试过Apache替代方案） #

如果用Apache部署时也出现相同问题，需确认：

• 已启用mod_proxy和mod_proxy_http模块
• 静态文件的Alias配置正确且优先级高于反向代理：

  Alias /static/ /opt/netbox/netbox/static/
  <Directory /opt/netbox/netbox/static/>
      Require all granted
  </Directory>
  

  Apache的配置顺序很重要，Alias必须放在反向代理配置之前，才能优先拦截静态文件请求。

5. 通过日志定位具体问题 #

日志是排查问题的核心依据，重点查看以下日志：

• Nginx：访问日志/var/log/nginx/access.log（查看静态文件请求的状态码），错误日志/var/log/nginx/error.log（查看是否有文件找不到、权限拒绝等报错）
• Gunicorn：如果用systemd管理，通过journalctl -u gunicorn查看日志，确认动态请求是否正常处理
• Django：Netbox的Django日志默认在/opt/netbox/netbox/logs/，查看是否有静态文件相关的错误信息

内容的提问来源于stack exchange，提问作者packetferret