【宝塔✨】宝塔（BT 面板）部署 Python 项目

宝塔（BT 面板）部署 Python 项目：图形化完整教程

适用于：Linux 服务器（Ubuntu/CentOS 等）+ 宝塔面板（Linux 版）。全程 GUI 操作为主， FastAPI 可复制配置。

---

目录

• 一、准备工作
• 二、安装宝塔面板（一次性命令）
• 三、首次进入宝塔面板（GUI）
• 四、创建 Python 运行环境（GUI）
• 五、上传或获取项目代码（GUI）
• 六、安装依赖（GUI）
• 七、用“Python 项目管理器”创建运行项目
• 八、用 Nginx 反向代理到外网域名（含 SSL）
• 九、静态文件与跨域（可选）
• 十、环境变量与密钥（可选）
• 十一、日志监控与开机自启
• 十二、数据库与 Redis（可选）
• 十三、常见问题速查
• 附录 A：FastAPI 可复制配置

---

一、准备工作

• 一台云服务器（推荐：Ubuntu 20.04/22.04 或 CentOS 7/8）。
• 放通安全组端口：22（SSH）、8888（面板首次登录口）、80/443（网站）。
• 有域名并完成解析（可选，用于 HTTPS）。

---

二、安装宝塔面板（一次性命令）

这一步需 SSH 进入服务器；安装成功后其余基本用 GUI。若下述命令失效，请到宝塔官网下载最新脚本。

1. # Ubuntu/Debian 常见
2. wget -O install.sh http://download.bt.cn/install/install_6.0.sh && bash install.sh
4. # CentOS 常见
5. yum install -y wget && wget -O install.sh http://download.bt.cn/install/install_6.0.sh && bash install.sh

复制代码

安装完成后终端会显示：面板地址（如 http://你的IP:8888）、初始账号/密码或初始化向导。若 8888 访问不到，检查云安全组与系统防火墙。

---

🟢 查看宝塔面板信息命令

1. bt default

复制代码

运行后会显示类似如下信息：

1. 外网面板地址: http://xxx.xxx.xxx.xxx:8888/xxxxxx
2. 内网面板地址: http://xxx.xxx.xxx.xxx:8888/xxxxxx
3. username: xxxxxxxx
4. password: xxxxxxxx

复制代码

---

三、首次进入宝塔面板（GUI）

1. 浏览器打开 http://你的IP:8888
2. 设置面板账号与密码。建议：
   • 修改默认端口（面板设置里）
   • 开启二次验证与登录提醒
3. 进入软件商店安装常用组件：
   • Nginx
   • Python 项目管理器 / Python 管理
   • （按需）MySQL、Redis
   • （站点里内置）Let’s Encrypt 证书

---

四、创建 Python 运行环境（GUI）

1. 打开软件商店 → Python 管理，安装所需 Python 版本（如 3.8/3.10/3.11）。
2. 打开Python 项目管理器，点击创建虚拟环境，选择上面安装的 Python 版本，命名如 venv-fastapi。

---

五、上传或获取项目代码（GUI）

• 方式一（上传压缩包）：面板 文件 → 上传 → 解压到 /www/wwwroot/your_project
• 方式二（Git 拉取）：在面板终端或 Git 插件中执行 git clone 到上述目录

建议目录（FastAPI 示例）：

1. /www/wwwroot/your_project
2. ├─ app/
3. │ └─ main.py # 入口（app = FastAPI()）
4. ├─ requirements.txt
5. └─ .env # 可选，存放环境变量

复制代码

---

六、安装依赖（GUI）

进入 Python 项目管理器 → 虚拟环境 → 选择 venv，点击安装依赖，选择项目 requirements.txt。
国内环境可改为国内 PyPI 源以加速。

---

七、用“Python 项目管理器”创建运行项目

1. 新增项目，填写：
   • 项目名称：fastapi-demo（示例）
   • 项目路径：/www/wwwroot/your_project
   • 运行用户：www
   • 虚拟环境：选择你的 venv（如 venv-fastapi）
   • 启动方式：ASGI（FastAPI/Starlette）或 WSGI（Flask/Django）
   • 启动命令：见附录（不同框架不同）
   • 开机自启：勾选
2. 点击保存并启动，应看到“运行中”。失败请查看项目日志。

---

八、用 Nginx 反向代理到外网域名（含 SSL）

1. 网站 → 添加站点：
   • 域名：yourdomain.com
   • 网站目录：任意（若仅反代，可为空目录）
2. 进入站点设置 → 反向代理：
   • 目标 URL：http://127.0.0.1:8000
   • 勾选启用反向代理
3. 站点 → SSL：
   • 选择 Let’s Encrypt，验证域名并签发
   • 开启强制 HTTPS

此时访问 https://yourdomain.com 即转发到后端服务。

---

九、静态文件与跨域（可选）

静态文件（Nginx）：

1. location /static/ {
2. alias /www/wwwroot/your_project/app/static/;
3. expires 30d;
4. access_log off;
5. }

复制代码

跨域（后端或 Nginx）：FastAPI 可用 CORS 中间件；或在 Nginx 添加响应头按需处理。

---

十、环境变量与密钥（可选）

• 在“项目 → 启动命令”前添加：
  1. export ENV=prod SECRET_KEY='your-secret' && gunicorn ...

  复制代码
• 或放 .env，配合 python-dotenv 读取。

---

十一、日志监控与开机自启

• Python 项目管理器 → 日志 查看启动/错误日志。
• 运行状态观察资源使用。
• 勾选开机自启即可随系统启动。

---

十二、数据库与 Redis（可选）

• 在软件商店安装 MySQL/Redis。
• 数据库菜单新建库与用户，将连接信息配置进项目。

---

十三、常见问题速查

1. 面板打不开：检查 8888 端口、云安全组与系统防火墙。
2. 项目启动失败/502：确认虚拟环境与依赖、启动命令模块路径是否正确，查看项目日志。
3. 超时/504：业务阻塞或 worker 较少，适当提高 --workers、检查数据库/外部依赖。
4. 依赖安装失败：切换国内源；有的库需系统依赖（如 build-essential、python3-dev、libmysqlclient-dev）。
5. HTTPS 失败：确保域名解析到当前服务器，80/443 放通且未被占用。

---

附录 A：FastAPI 可复制配置

假设：Python 3.8.19、项目在 /www/wwwroot/your_project。

目录与示例代码

1. /www/wwwroot/your_project
2. ├─ app/
3. │ └─ main.py
4. ├─ requirements.txt
5. └─ .env (可选)

复制代码

app/main.py

1. from fastapi import FastAPI
2. app = FastAPI()
4. @app.get("/")
5. def hello():
6. return {"msg": "Hello from FastAPI on Baota!"}

复制代码

requirements.txt

1. fastapi
2. uvicorn
3. gunicorn
4. python-dotenv

复制代码

Python 项目管理器表单

• 项目名称：fastapi-demo
• 项目路径：/www/wwwroot/your_project
• 运行用户：www
• 虚拟环境：选择已创建的 venv（基于 Python 3.8.19）
• 启动方式：ASGI / 自定义命令
• 启动命令：
  1. gunicorn -k uvicorn.workers.UvicornWorker app.main:app -b 127.0.0.1:8000 --workers 2 --timeout 60

  复制代码
• 开机自启：勾选

Nginx 反代（站点 → 反向代理）

• 目标 URL：http://127.0.0.1:8000
• 启用反向代理：勾选
  （SSL 在站点 → SSL 里申请并开启“强制 HTTPS”）

静态（可选）

1. location /static/ {
2. alias /www/wwwroot/your_project/app/static/;
3. expires 30d;
4. access_log off;
5. }

复制代码

---