部署在Cpanel的Django网站图片无法加载求助

• 确认INSTALLED_APPS配置
  打开settings.py，确保以下两项存在：

  INSTALLED_APPS = [
      # 其他默认应用
      'django.contrib.staticfiles',
      'users',  # 你的应用必须在此列表中
  ]
  

  Django仅会扫描INSTALLED_APPS内应用下的static目录，缺失配置会导致无法识别应用内的静态资源。

• 执行静态文件收集命令
  在Cpanel终端中，切换到mainfolder/mydjango目录，激活Python虚拟环境后运行：

  python manage.py collectstatic
  

  该命令会将所有应用中的静态资源（包括users/static/images/main.png）复制到STATIC_ROOT指定的staticfiles文件夹中，执行时输入yes确认即可。

• 配置Cpanel静态资源映射

  1. 打开Cpanel的「Setup Python App」工具，找到你的Django应用
  2. 滚动到「Static Files」区域，点击「Add Path」
  3. 填写配置项：
     • URL：/static/
     • Directory：填写staticfiles的绝对路径，例如/home/你的Cpanel用户名/mainfolder/staticfiles
  4. 保存配置并重启Python应用

• 检查文件权限
  确保staticfiles文件夹及内部文件权限符合Web服务器读取要求：

  • 文件夹权限设为755
  • 文件权限设为644
    可在Cpanel文件管理器中右键修改，或用终端命令：

  chmod -R 755 /home/你的Cpanel用户名/mainfolder/staticfiles
  chmod -R 644 /home/你的Cpanel用户名/mainfolder/staticfiles/*
  

• 验证资源路径
  检查staticfiles/images/main.png是否存在，若缺失说明collectstatic命令未正确执行，需排查虚拟环境激活状态或路径拼写问题。

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