# Fastify 部署， 說一句就上線。

> Fastify 怎麼部署上線：原樣上傳、不用寫 Dockerfile，或在 Claude Code、Codex 說一句就部署。每版可預覽，一鍵加 PostgreSQL。

Web page: https://agentlab.cresclab.com/deploy/fastify  
English (Markdown): https://agentlab.cresclab.com/en/deploy/fastify.md

Fastify 部署教學 · Agent Lab 部署

Fastify 專案原樣上傳，不用寫 Dockerfile，或直接跟 Claude Code、Codex、Cursor 說「部署上去」。Agent Lab 把它建成一個常駐、含後端的網站，每一版都有預覽網址，上傳時先檢查外洩的金鑰。

[免費開始](https://app.agentlab.cresclab.com/?lang=zh-Hant&intent=deploy) [看設定](https://agentlab.cresclab.com/deploy/fastify#recipe)

AI 寫程式工具把 Fastify 專案部署到 Agent Lab：建立專案、上傳、等建置完成，回報上線網址。

為什麼把 Fastify 放在 Agent Lab

## 不用自己顧主機，Fastify 就能上線

JavaScript／TypeScript 專案，直接從原始碼建置、不用 Dockerfile，部署成一個常駐、含後端的網站。

### 不用寫 Dockerfile

平台從 package.json 認出 Fastify，自動決定建置與啟動指令，並列出程式讀的環境變數。

### 先預覽，再上線

每次上傳都是新的一版，有自己的網址。先看過再上線。

### 外洩金鑰先擋下

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

### 一鍵加 PostgreSQL

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

怎麼選

## Fastify 放 Agent Lab，還是自己租 VPS

在 Agent Lab 部署 Fastify 與自己租 VPS 的比較

| 你在意的事 | Agent Lab 部署 | 自己租 VPS |
| --- | --- | --- |
| 設定方式 | 上傳或說一句話，不用 Dockerfile | SSH、裝執行環境、程序管理、反向代理 |
| HTTPS 與網域 | 自動；付費方案可接自訂網域 | 自己弄 Certbot 與 DNS |
| 上線前檢查 | 上傳時檢查外洩的金鑰 | 自己沒設就沒有 |
| 資料庫 | 一鍵建 PostgreSQL，連線自動寫進專案 | 自己安裝、自己備份 |
| 起步費用 | Free 方案 NT$0，1 個含後端的網站（S 規格，閒置休眠） | VPS 每月約 NT$200–600，加上你的時間 |

步驟

## 四步把 Fastify 部署上線

1. ### 準備專案
   package.json 放在專案最上層，lockfile 要一起提交；不要帶 node_modules、.git、dist、.env。
2. ### 上傳或說一句
   把資料夾拖進專案的部署分頁、從 GitHub 推送，或透過 Agent Lab MCP 叫 AI 工具做。
3. ### 建置與檢查
   平台建置這一版並檢查外洩金鑰；它列出的金鑰到專案的「環境變數」填，勾「機敏值」。
4. ### 預覽並上線
   第一版建好就上線；之後每一版先有預覽網址，確認後再上線。

設定

## Agent Lab 怎麼跑 Fastify

最常見的錯：Fastify 預設只監聽 127.0.0.1，平台連不到，版本會一直不就緒。listen 時一定要給 host: "0.0.0.0"。 package.json 要有 start script。

自動偵測

### 建置與啟動

```
// Fastify 預設只聽 127.0.0.1，要改成 0.0.0.0
// Fastify listens on 127.0.0.1 by default; make it 0.0.0.0
await app.listen({ port: Number(process.env.PORT ?? 8080), host: "0.0.0.0" });

# Agent Lab 執行 / Agent Lab runs
npm ci
npm start
```

- `PORT` 平台給的連接埠（預設 8080），伺服器要監聽它。
- `DATABASE_URL` 接上 Agent Lab 的 PostgreSQL 時自動寫入。

提示詞

### 或叫 AI 工具做

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

常見問題

## Fastify 部署常見問題

**部署 Fastify 需要 Dockerfile 嗎？**

不用。Fastify 專案帶著 package.json 上傳，Agent Lab 會自動偵測、建置與啟動；如果最上層有 Dockerfile，就改用你的 Dockerfile。 [看文件 →](https://agentlab.cresclab.com/docs/zh-tw/deploy/source-build)

**Fastify 一定要監聽 PORT 嗎？**

要。平台把連接埠放在 PORT 環境變數（預設 8080），伺服器要監聽它，並且監聽所有網路介面（0.0.0.0），不能只聽 localhost。版本一直沒有就緒，最常見的原因就是連接埠不對。

**API 金鑰這類機密要放哪？**

在專案的「環境變數」新增並勾「機敏值」，程式照樣從環境變數讀。session secret 這類隨機值可以在主控台直接產生，沒有人看得到。上傳的檔案裡有金鑰，平台會在上線前擋下來。

**可以用 Claude Code 或 Codex 部署 Fastify 嗎？**

可以。先接上 Agent Lab MCP（一行指令、瀏覽器登入、不用 API 金鑰），然後說「把這個 Fastify 專案部署上去」。工具會建專案、上傳、等建置完成，上線前先問你。 [接上 MCP →](https://agentlab.cresclab.com/mcp)

**Fastify 可以免費部署嗎？**

Free 方案 NT$0：1 個含後端的網站（S 規格，閒置 15 分鐘休眠）、1 個 S 資料庫、3 個靜態網站、每月 100 分鐘建置、5 GB 流量，到上限就暫停、不會收費。要常駐、接自訂網域，Pro 每月 NT$990（未稅）。 [看定價 →](https://agentlab.cresclab.com/deploy#pricing)
