建議目錄（FastAPI 示例）：

/www/wwwroot/your_project
├─ app/
│  └─ main.py           # 入口（app = FastAPI()）
├─ requirements.txt
└─ .env                 # 可選，存放環(huán)境變量

六、安裝依賴(lài)（GUI）

進(jìn)入 Python 項(xiàng)目管理器 → 虛擬環(huán)境 → 選擇 venv，點(diǎn)擊安裝依賴(lài)，選擇項(xiàng)目 requirements.txt。

國(guó)內(nèi)環(huán)境可改為國(guó)內(nèi) PyPI 源以加速。

七、用“Python 項(xiàng)目管理器”創(chuàng)建運(yùn)行項(xiàng)目

1. 新增項(xiàng)目，填寫(xiě)：
   • 項(xiàng)目名稱(chēng)：fastapi-demo（示例）
   • 項(xiàng)目路徑：/www/wwwroot/your_project
   • 運(yùn)行用戶(hù)：www
   • 虛擬環(huán)境：選擇你的 venv（如 venv-fastapi）
   • 啟動(dòng)方式：ASGI（FastAPI/Starlette）或 WSGI（Flask/Django）
   • 啟動(dòng)命令：見(jiàn)附錄（不同框架不同）
   • 開(kāi)機(jī)自啟：勾選
2. 點(diǎn)擊保存并啟動(dòng)，應(yīng)看到“運(yùn)行中”。失敗請(qǐng)查看項(xiàng)目日志。

八、用 Nginx 反向代理到外網(wǎng)域名（含 SSL）

1. 網(wǎng)站 → 添加站點(diǎn)：
   • 域名：yourdomain.com
   • 網(wǎng)站目錄：任意（若僅反代，可為空目錄）
2. 進(jìn)入站點(diǎn)設(shè)置 → 反向代理：
   • 目標(biāo) URL：http://127.0.0.1:8000
   • 勾選啟用反向代理
3. 站點(diǎn) → SSL：
   • 選擇 Let’s Encrypt，驗(yàn)證域名并簽發(fā)
   • 開(kāi)啟強(qiáng)制 HTTPS

此時(shí)訪問(wèn) https://yourdomain.com 即轉(zhuǎn)發(fā)到后端服務(wù)。

九、靜態(tài)文件與跨域（可選）

靜態(tài)文件（Nginx）：

location /static/ {
    alias /www/wwwroot/your_project/app/static/;
    expires 30d;
    access_log off;
}

跨域（后端或 Nginx）：FastAPI 可用 CORS 中間件；或在 Nginx 添加響應(yīng)頭按需處理。

十、環(huán)境變量與密鑰（可選）

• 在“項(xiàng)目 → 啟動(dòng)命令”前添加：

  export ENV=prod SECRET_KEY='your-secret' && gunicorn ...
  

• 或放 .env，配合 python-dotenv 讀取。

十一、日志監(jiān)控與開(kāi)機(jī)自啟

• Python 項(xiàng)目管理器 → 日志 查看啟動(dòng)/錯(cuò)誤日志。
• 運(yùn)行狀態(tài)觀察資源使用。
• 勾選開(kāi)機(jī)自啟即可隨系統(tǒng)啟動(dòng)。

十二、數(shù)據(jù)庫(kù)與 Redis（可選）

• 在軟件商店安裝 MySQL/Redis。
• 數(shù)據(jù)庫(kù)菜單新建庫(kù)與用戶(hù)，將連接信息配置進(jìn)項(xiàng)目。

十三、常見(jiàn)問(wèn)題速查

1. 面板打不開(kāi)：檢查 8888 端口、云安全組與系統(tǒng)防火墻。
2. 項(xiàng)目啟動(dòng)失敗/502：確認(rèn)虛擬環(huán)境與依賴(lài)、啟動(dòng)命令模塊路徑是否正確，查看項(xiàng)目日志。
3. 超時(shí)/504：業(yè)務(wù)阻塞或 worker 較少，適當(dāng)提高 --workers、檢查數(shù)據(jù)庫(kù)/外部依賴(lài)。
4. 依賴(lài)安裝失敗：切換國(guó)內(nèi)源；有的庫(kù)需系統(tǒng)依賴(lài)（如 build-essential、python3-dev、libmysqlclient-dev）。
5. HTTPS 失敗：確保域名解析到當(dāng)前服務(wù)器，80/443 放通且未被占用。

附錄 A：FastAPI 可復(fù)制配置

假設(shè)：Python 3.8.19、項(xiàng)目在 /www/wwwroot/your_project。

目錄與示例代碼

/www/wwwroot/your_project
├─ app/
│  └─ main.py
├─ requirements.txt
└─ .env   (可選)

app/main.py

from fastapi import FastAPI
app = FastAPI()

@app.get("/")
def hello():
    return {"msg": "Hello from FastAPI on Baota!"}

requirements.txt

fastapi
uvicorn
gunicorn
python-dotenv

Python 項(xiàng)目管理器表單

• 項(xiàng)目名稱(chēng)：fastapi-demo
• 項(xiàng)目路徑：/www/wwwroot/your_project
• 運(yùn)行用戶(hù)：www
• 虛擬環(huán)境：選擇已創(chuàng)建的 venv（基于 Python 3.8.19）
• 啟動(dòng)方式：ASGI / 自定義命令
• 啟動(dòng)命令：

  gunicorn -k uvicorn.workers.UvicornWorker app.main:app -b 127.0.0.1:8000 --workers 2 --timeout 60
  

• 開(kāi)機(jī)自啟：勾選

Nginx 反代（站點(diǎn) → 反向代理）

• 目標(biāo) URL：http://127.0.0.1:8000
• 啟用反向代理：勾選
  （SSL 在站點(diǎn) → SSL 里申請(qǐng)并開(kāi)啟“強(qiáng)制 HTTPS”）

靜態(tài)（可選）

location /static/ {
    alias /www/wwwroot/your_project/app/static/;
    expires 30d;
    access_log off;
}

總結(jié) 

到此這篇關(guān)于寶塔（BT面板）部署Python項(xiàng)目的文章就介紹到這了,更多相關(guān)寶塔部署Python項(xiàng)目?jī)?nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！