Crescendo Lab

FastAPI 部署教學 · Agent Lab 部署

FastAPI 部署,
說一句就上線。

FastAPI 專案原樣上傳,不用寫 Dockerfile,或直接跟 Claude Code、Codex、Cursor 說「部署上去」。Agent Lab 把它建成一個常駐的 web service,每一版都有預覽網址、可以回退,上傳時先檢查外洩的金鑰;App 與資料庫跑在 Google Cloud 台灣。

免費開始看設定

為什麼把 FastAPI 放在 Agent Lab

不用自己顧主機,FastAPI 就能上線

Python 專案,直接從原始碼建置、不用 Dockerfile,部署成一個常駐的 web service。

不用寫 Dockerfile

平台從 requirements.txt / pyproject.toml 認出 FastAPI,自動決定建置與啟動指令,並列出程式讀的環境變數。

預覽、上線、回退

每次上傳都是新的一版,有自己的網址。先看過再上線,出問題一鍵切回任何一版。

外洩金鑰先擋下

上線前先檢查 API 金鑰與憑證;機密放在主控台,不放在程式碼裡。

一鍵加 PostgreSQL

建好資料庫接上去,連線自動寫進 App 的環境變數,密碼不會顯示。

怎麼選

FastAPI 放 Agent Lab,還是自己租 VPS

表格可以左右滑動。

在 Agent Lab 部署 FastAPI 與自己租 VPS 的比較
你在意的事Agent Lab 部署自己租 VPS
設定方式上傳或說一句話,不用 DockerfileSSH、裝執行環境、程序管理、反向代理
HTTPS 與網域自動;付費方案可接自訂網域自己弄 Certbot 與 DNS
預覽與回退每一版都有自己的網址,一鍵回退自己寫腳本
上線前檢查上傳時檢查外洩的金鑰自己沒設就沒有
資料庫一鍵建 PostgreSQL,連線自動寫進 App自己安裝、自己備份
起步費用Free 方案 NT$0,1 個 S 應用程式(閒置休眠)VPS 每月約 NT$200–600,加上你的時間

步驟

四步把 FastAPI 部署上線

  1. 準備專案

    requirements.txt / pyproject.toml 放在專案最上層,lockfile 要一起提交;不要帶 node_modules、.git、dist、.env。

  2. 上傳或說一句

    把資料夾拖進專案的部署分頁、從 GitHub 推送,或透過 Agent Lab MCP 叫 AI 工具做。

  3. 建置與檢查

    平台建置這一版並檢查外洩金鑰;它列出的機密到設定頁填。

  4. 預覽並上線

    第一版建好就上線;之後每一版先有預覽網址,確認後再上線。

設定

Agent Lab 怎麼跑 FastAPI

FastAPI 很常拿來做 AI 後端或 MCP server:一個常駐、網址固定的服務,AI 工具一句話就能部署。 入口不是 main.py 的 app 時,放一個 Procfile:web: uvicorn mypkg.api:app --host 0.0.0.0 --port $PORT。 /docs 的 Swagger UI 預設是公開的,不想公開可以把專案設成私人並加密碼。

自動偵測

建置與啟動

# Agent Lab 偵測到 FastAPI 後自動產生 ASGI 伺服器指令
# Agent Lab detects FastAPI and generates the ASGI server command
pip install -r requirements.txt   # 也支援 Poetry、uv
# 用 uvicorn 啟動,監聽 0.0.0.0:$PORT(預設 8080)
  • DATABASE_URL 接上 Agent Lab 的 PostgreSQL 時自動寫入。
  • OPENAI_API_KEY 這類第三方金鑰放 Secrets,只有你知道值。
提示詞

或叫 AI 工具做

讀 https://app.agentlab.cresclab.com/agent/deploy.md,把這個 FastAPI 專案部署到 Agent Lab。先給我建置計畫和需要的環境變數,機密告訴我去主控台哪裡填,上線前等我確認。

常見問題

FastAPI 部署常見問題

部署 FastAPI 需要 Dockerfile 嗎?
不用。FastAPI 專案帶著 requirements.txt / pyproject.toml 上傳,Agent Lab 會自動偵測、建置與啟動;如果最上層有 Dockerfile,就改用你的 Dockerfile。 看文件 →
FastAPI 要用哪個 Python 版本?
依序讀 .python-version、pyproject 的版本限制,都沒有就用 3.12;支援 3.10 到 3.14。也可以用 ALPACK_PYTHON_VERSION 指定。
API 金鑰這類機密要放哪?
放在專案設定的 Secrets,程式用環境變數讀。session secret 這類隨機值可以在主控台直接產生,沒有人看得到。上傳裡如果被找到金鑰,會在上線前擋下來。
可以用 Claude Code 或 Codex 部署 FastAPI 嗎?
可以。先接上 Agent Lab MCP(一行指令、瀏覽器登入、不用 API 金鑰),然後說「把這個 FastAPI 專案部署上去」。工具會建專案、上傳、等建置完成,上線前先問你。 接上 MCP →
FastAPI 可以免費部署嗎?
Free 方案 NT$0:1 個 S 應用程式(閒置 15 分鐘休眠)、1 個 S 資料庫、3 個靜態網頁、每月 100 分鐘建構、5 GB 流量,到上限就暫停、不會收費。要常駐、接自訂網域,Pro 每月 NT$990(未稅)。 看定價 →