宝塔面板部署Django项目的完整流程与配置详解

橘子海
橘子海
发布时间:2026-10-15| 6人浏览过
原创

本文详细记录了在CentOS 7服务器上使用宝塔面板成功部署Django项目的完整流程。内容涵盖Python版本管理、虚拟环境创建、requirements依赖导出、Nginx反向代理配置及uwsgi启动方式的选择。通过Python项目管理器简化配置步骤,解决环境差异导致的兼容性问题,并提供从本地开发到服务器上线的具体操作指南,帮助开发者避免常见踩坑。

Django项目上线部署概述

本文记录了将 Django 项目上线的具体过程,旨在提供超简单的操作指引,帮助开发者避免无意义的踩坑。

环境准备:安装Python管理器与版本适配

第一步:安装python管理器

在宝塔在线面板中安装“ python项目管理器 ”插件。

第二步:安装适配python版本

由于服务器 centos7 系统默认的 python 版本是 2.7

而我们的项目是基于最新版 Django 开发的,本地环境使用的是 python2.7。为了尽量保证服务器与本地环境的相似性,从而避免遇到无意义的兼容性问题,我们需要在服务器上也安装对应的Python版本。

依赖处理:导出requirements与本地配置调整

第三步:导出项目包到requirments.txt

由于 python 的安装时间较长,我们可以利用这段时间处理其他工作。

在本地项目目录下执行以下命令以导出依赖包列表:


python -m pip freeze > requirements.txt

导出的包列表可能包含较多内容,无需担心。尽管其中部分包看似未被直接使用,但在宝塔环境中,我们将使用虚拟环境运行项目,因此这些依赖会被正确隔离和管理。

请更改 settings.py 中对应内容如下:


DEBUG = True

ALLOWED_HOSTS = ['*']

STATIC_URL = '/static/'
# STATICFILES_DIRS = [
#   os.path.join(BASE_DIR, "static")
# ]
STATIC_ROOT = os.path.join(BASE_DIR, "static")

项目上传与Python项目管理器配置

第四步:上传本地项目到服务器

将本地项目文件上传至 www/wwwroot/ 目录下。

第五步:管理器中添加项目

在 python项目管理器 中进行配置,添加新项目。

按照类似图示进行配置即可。

此处需勾选“是否安装模块依赖”,该选项会自动读取项目下的 requirements.txt 文件,并安装相应的模块,因此此步骤耗时较长。

管理器默认使用 pip 安装项目根目录 requirements.txt 内的模块。如有其他特殊模块需要安装,请手动进入虚拟环境进行安装。

进入虚拟环境的方法如下:

在命令行输入 source 项目路径/项目名_venv/bin/activate

例如: source /data/python/project1_venv/bin/activate

域名映射与Nginx站点配置

第六步:映射域名

映射域名

我们需要一个易于记忆的域名,因此为项目绑定一个预留的域名 safe.top15.cn。

第七步:配置站点

配置 Nginx 反向代理。

映射成功后,可在面板侧边栏“网站”中,发现多了我们的 python 项目。

此时,即可显示对应项目的一些“ 站点配置 ”信息。


//指定静态文件

location /static/
{
  alias /www/wwwroot/ThreatScan/static/;
}

Nginx 的配置按照如下示例进行,注意上图可能存在错误:

项目重启与uwsgi启动方式确认

第八步:重启项目

由于修改了部分配置,我们需要在 python管理器 中重启项目。

务必使用 uwsgi 作为启动方式。

项目成功启动。

到此这篇关于宝塔面板成功部署Django项目流程(图文)的文章就介绍到这了,更多相关宝塔面板部署Django项目 内容请搜索本站以前的文章或继续浏览下面的相关文章希望大家以后多多支持本站!

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。