HostGator Turbo套餐如何在cPanel中安装Python部署Django项目

cPanel找不到Python入口的排查 #

• 直接用cPanel顶部搜索框搜Python，对应功能入口名为Setup Python App（旧版本叫Python Selector，归类在「软件」板块）
• 确认主机系统：Turbo套餐分Linux、Windows两类，Windows共享主机无内置Python管理工具，且无系统级软件安装权限
• 搜索仍无结果时，提交工单联系客服开通CloudLinux Python组件，新注册账户偶发默认未启用该功能

安装Python并配置Django #

1. 创建Python应用（自动生成隔离虚拟环境） #

• 进入「Setup Python App」，点击CREATE APPLICATION
• 按需求填写配置参数：
  • Python版本：选择3.8及以上（适配Django长期支持版本）
  • 应用根目录：设置独立存放文件夹，例如django_main（对应服务器绝对路径为/home/你的cPanel用户名/django_main）
  • 应用URL：选择要绑定的域名，根目录部署留空即可，子目录部署需填写对应子路径
  • 启动模式：固定选择Passenger（共享主机统一通过该模式解析WSGI请求）
  • 启动模块：填写你的Django项目名.wsgi
• 提交配置后，系统自动创建独立虚拟环境

2. 安装Django依赖 #

• 应用创建完成后，页面会显示虚拟环境激活命令，格式参考：source /home/用户名/virtualenv/应用标识/版本号/bin/activate
• 在cPanel搜索「SSH Access」登录服务器，粘贴上述命令激活虚拟环境
• 执行安装命令：pip install django
• 需指定稳定版本可执行：pip install django==4.2（4.2为长期支持版）

3. 项目适配与生效 #

• 将本地Django项目文件上传至此前设置的应用根目录
• 修改项目配置文件settings.py：
  • 给ALLOWED_HOSTS参数添加绑定的域名
  • 配置静态文件根路径，执行python manage.py collectstatic归集静态资源
• 若访问时报500错误，可在应用根目录新建passenger_wsgi.py，写入from 你的Django项目名.wsgi import application
• 返回「Setup Python App」页面，点击对应应用的重启按钮即可生效

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