Hono

Hono (opens in a new tab) （在日文中意為火焰🔥）是一個針對邊緣裝置設計的小型、簡單且超快的 Web 框架。

本文件將指導你如何在 Zeabur 上部署 Hono 專案。

判斷條件

如果你的服務符合以下所有條件，Zeabur 會識別為 Hono 專案並自動完成構建和部署：

1. 專案根目錄下有 bun.lockb 檔案。
2. 專案目錄下有 package.json 檔案。
3. package.json 檔案的 dependencies 欄位中有 hono 套件。

如果你有興趣參與開源貢獻，可以在 zbpack 的開源程式碼 (opens in a new tab) 中找到相關的部分。

步驟一：初始化專案

你可以按照 Hono 官方文件 (opens in a new tab) 的步驟來使用 Bun 初始化一個 Hono 專案。

安裝 Bun

curl https://bun.sh/install | bash

初始化 Hono 專案

bun create hono my-app

建立後，你可以進入 my-app 目錄，然後安裝依賴。

cd my-app
bun install

本地測試

bun run dev

現在，你可以造訪 http://localhost:3000 頁面，應該會看到 Hello, Bun!。

步驟二：部署

你可以選擇兩種方式部署你的 Hono 專案：使用 GitHub 或 使用 Zeabur CLI。

使用 Zeabur CLI 部署

使用 Zeabur CLI 是部署 Hono 專案的最簡單方式，你只需要先登入 Zeabur CLI：

npx zeabur auth login

這個指令會開啟瀏覽器並引導你完成登入。

接著，你可以使用 deploy 指令部署你的 Hono 專案：

npx zeabur deploy

這個指令會用互動式的方式詢問你要部署到哪個專案，你也可以選擇建立一個新的專案。

關於更多使用 Zeabur CLI 部署的說明，請查看 使用 CLI 部署服務。

使用 GitHub 部署

使用 GitHub 部署可以讓你的專案享有開箱即用的 CI/CD 服務，未來只要推送代碼到 GitHub，Zeabur 將自動幫你部署。

請在 GitHub 上建立一個新的儲存庫，然後將程式碼推送到儲存庫中即可，更詳細的說明請參考 GitHub 文件 (opens in a new tab)。

推送完畢後，點選 Deploy service，然後選擇 Deploy your source code。

搜尋你的儲存庫，點選匯入，你的 Hono 服務將自動開始部署。

步驟三：設定網域

當部署完成後，你可能需要為你的 Hono 網站設定一個網域。

打開服務頁面的 "Domain" 分頁，然後點選 "Generate Domain" 或 "Custom Domain"。

關於如何為你的服務綁定網域的更多資訊，請參考 綁定網域。