教程
Hono

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/cli auth login

这个指令会打开浏览器并引导你完成登录。

接着,你可以使用 deploy 指令部署你的 Hono 项目:

npx @zeabur/cli deploy

这个指令会用交互式的方式询问你要部署到哪个项目,你也可以选择创建一个新的项目。

关于更多使用 Zeabur CLI 部署的说明,请查看 使用 CLI 部署服务

使用 GitHub 部署

使用 GitHub 部署可以让你的项目享有开箱即用的 CI/CD 服务,未来只要推送代码到 GitHub,Zeabur 将自动帮你部署。

请在 GitHub 上建立一个新的仓库,然后将代码推送到仓库中即可,更详细的说明请参考 GitHub 文档 (opens in a new tab)

推送完毕后,点击 Deploy service,然后选择 Deploy your source code

deploy

搜索你的仓库,点击导入,你的 Hono 服务将自动开始部署。

步骤三:设置域名

当部署完成后,你可能需要为你的 Hono 网站设置一个域名。

打开服务页面的 "Domain" 分页,然后点击 "Generate Domain" 或 "Custom Domain"。

关于如何为你的服务绑定域名的更多信息,请参考 绑定域名

Domain Binding