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

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

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

SvelteKit 部署教學 · Agent Lab 部署

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

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

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

為什麼把 SvelteKit 放在 Agent Lab

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

JavaScript／TypeScript 專案，直接從原始碼建置、不用 Dockerfile，部署成含後端的網站，全站靜態時則是放在 CDN 的靜態網站。

### 不用寫 Dockerfile

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

### 先預覽，再上線

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

### 外洩金鑰先擋下

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

### 一鍵加 PostgreSQL

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

怎麼選

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

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

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

步驟

## 四步把 SvelteKit 部署上線

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

設定

## Agent Lab 怎麼跑 SvelteKit

要伺服器端功能（form actions、+server.ts）請用 @sveltejs/adapter-node；只要靜態頁面就用 adapter-static。 機密放 $env/dynamic/private，在專案環境變數設定並勾「機敏值」，不會寫進建置產物。

自動偵測

### 建置與啟動

```
# Agent Lab 偵測到 SvelteKit 後執行
# What Agent Lab runs once it detects SvelteKit
npm ci
npm run build      # vite build
node build         # adapter-node，監聽 $PORT（預設 8080）

# adapter-static → 改成靜態網站，放 CDN
```

- `PORT` 平台給的連接埠（預設 8080），伺服器要監聽它。
- `PUBLIC_*` $env/static/public 的值會送到瀏覽器，不能放金鑰。
- `DATABASE_URL` 接上 Agent Lab 的 PostgreSQL 時自動寫入。

提示詞

### 或叫 AI 工具做

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

常見問題

## SvelteKit 部署常見問題

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

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

**SvelteKit 要用哪個 adapter？**

有伺服器端邏輯就用 adapter-node，部署成含後端的網站；全站靜態就用 adapter-static，部署成放在 CDN 的網頁。adapter-auto 在 Agent Lab 不會自動選到合適的目標，建議明確指定。

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

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

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

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

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

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