Ubuntu 22.04下宝塔面板安装Python和Django的步骤？

2026-07-09 18:05:19 分类：服务器

在 Ubuntu 22.04 上通过宝塔面板（BT Panel）安装 Python 和 Django，主要依赖于宝塔自带的“网站”和“软件商店”功能。宝塔面板会自动处理依赖关系和环境隔离，因此不需要手动使用 pip 或 venv 创建复杂的环境。

以下是详细的操作步骤：

第一步：安装宝塔面板及基础环境

如果你尚未安装宝塔面板，请先确保服务器已运行并安装了最新版宝塔面板。

  1. 执行安装命令（以 CentOS/Ubuntu 为例）： 
    yum install -y wget && wget -O install.sh http://download.bt.cn/install/install_ubuntu.sh && sudo bash install.sh ed8484bec

    注意：如果是 Ubuntu 22.04，建议使用 install_ubuntu.sh 脚本。

  2. 登录面板：安装完成后，根据提示访问面板地址、用户名和密码。

第二步：在软件商店安装 Python 版本

宝塔面板支持多版本共存，建议为每个项目安装独立的 Python 版本（如 Python 3.9 或 3.10）。

  1. 登录宝塔面板，点击左侧菜单的 【软件商店】。
  2. 在搜索框输入 Python。
  3. 找到 Python 应用（通常由宝塔官方维护），点击 【安装】。
  4. 在安装界面中，选择你需要的版本（推荐 Python 3.9 或 3.10，Django 4.x 对 Python 3.8+ 支持良好）。
  5. 等待安装完成。安装成功后，你可以在面板首页看到该 Python 版本的图标变为绿色。

第三步：创建网站并绑定 Python 环境

这是最关键的一步，需要将你的 Django 代码与刚才安装的 Python 环境关联起来。

  1. 点击左侧菜单 【网站】 -> 【添加站点】。
  2. 填写域名（如果没有域名可以填本地 IP 或留空测试）、数据库（可选，先跳过或创建 MySQL）。
  3. 关键设置：
    • 在 “运行环境” 区域，勾选 【Python】。
    • 在下拉菜单中选择刚才安装的 Python 版本（例如 Python-3.9）。
    • 点击 【提交】。
  4. 创建完成后，点击该网站右侧的 【设置】 按钮。

第四步：配置 Django 项目目录

你需要将 Django 代码上传到服务器的网站根目录，并指定启动文件。

  1. 上传代码：

    • 进入网站的 【文件】 管理。
    • 默认根目录通常是 /www/wwwroot/你的域名。
    • 将你的 Django 项目文件夹（包含 manage.py, requirements.txt, wsgi.py 等）上传到这里。
    • 注意：如果项目结构是 project_name/manage.py，请确保 manage.py 位于根目录下，或者在后续步骤中调整路径。

  2. 配置启动参数：

    • 在网站设置页面，找到 【Python 路径】 或 【项目路径】（不同版本面板位置略有差异，通常在“其他”或“项目配置”里）。
    • 项目路径：填写 Django 项目的绝对路径（即 manage.py 所在的一级目录）。例如：/www/wwwroot/example.com/my_django_project。
    • 入口文件：通常填写 wsgi.py（这是 Django 的标准 WSGI 入口）。
    • 进程数：建议设置为 2 或 4（根据服务器 CPU 核心数调整）。

第五步：安装依赖包 (requirements.txt)

宝塔面板会自动创建一个虚拟环境（Virtualenv），但不会自动安装 requirements.txt 中的库。

  1. 在网站设置页面，找到 【终端】 或 【命令行】 标签页（部分版本在“文件”页面的顶部工具栏有“终端”按钮）。
  2. 确保当前目录是你的项目根目录。

  3. 执行以下命令安装依赖：

    # 激活虚拟环境（宝塔通常会自动识别，但显式执行更稳妥）
source /www/server/panel/vhost/python/3.9/bin/activate 
# 注意：路径中的 3.9 需替换为你实际安装的 Python 版本号

# 安装依赖
pip install -r requirements.txt

    如果不方便查具体路径，可以直接在项目目录下运行 pip install -r requirements.txt，宝塔的虚拟环境通常会优先于系统环境被调用。

第六步：迁移数据库与启动服务

  1. 数据库迁移：
    在终端中执行：

    python manage.py migrate

    如果有初始数据，还需执行 python manage.py createsuperuser。

  2. 启动服务：

    • 回到网站设置的 【Python】 选项卡。
    • 点击 【保存】 按钮（这通常会触发 Nginx + uWSGI/Gunicorn 的重新加载）。
    • 或者，你可以直接在面板的 【网站】 列表中找到该站点，点击 【重启】 或 【启动】 按钮。

常见问题排查

  • 502 Bad Gateway：
    • 检查 uWSGI/Gunicorn 进程是否存活。
    • 查看日志：在网站设置 -> 【日志】 -> 【错误日志】 中查看具体报错（通常是 ImportError 缺少某个库，或者端口冲突）。
  • 权限问题：
    • 如果上传的文件无法写入，请在文件管理中右键点击项目文件夹，选择 【权限】，所有者改为 www，权限设为 755 或 777（仅限测试）。
  • Nginx 配置：
    • 确保 Nginx 配置中 uwsgi_pass 指向正确的 socket 地址（宝塔通常自动配置为 unix:/tmp/... 或 127.0.0.1:port）。

通过以上步骤，你的 Django 项目应该已经成功运行在 Ubuntu 22.04 的宝塔面板上了。

未经允许不得转载：云知识CLOUD » Ubuntu 22.04下宝塔面板安装Python和Django的步骤？