Hono
Hono是一个小型、简单、超快的网络框架,适用于 Cloudflare Pages 和 Workers、Deno 和 Bun。在本指南中,你将创建一个新的 Hono 应用程序,并使用 Cloudflare Pages 进行部署。
创建一个新项目
使用
create-cloudflare
CLI (C3) 创建新项目。C3 将创建一个新的项目目录,启动 Hono 的官方设置工具,并提供即时部署选项。
要使用 create-cloudflare
创建一个新的 Hono 项目,请运行以下命令:
打开项目并创建一个 src/server.js
文件(如果使用的是 TypeScript,则为 src/server.ts
)。在文件中添加以下内容:
要提供 CSS、图像或 JavaScript 文件等静态文件,请在 src/server.js/ts
文件中添加以下内容:
这将导致在应用程序中提供 dist
中 public
文件夹中的所有文件。
打开 package.json
文件,更新 scripts
部分:
然后,运行以下命令。
安装 npm-run-all
后,你就可以使用一条命令(npm run dev
)在观察模式下同时运行 npm run dev:wrangler
和 npm run dev:esbuild
。
在本地开发环境中运行
运行
你应该可以在 http://localhost:8788
查看生成的网络应用程序。
在你继续之前
所有框架指南都假定你已经对 Git 有了基本了解。如果你是 Git 的新手,请参考这本 Git 手册摘要,了解如何在本地机器上设置 Git。
如果使用 SSH 克隆,则必须在每台用于从 GitHub 推送或拉取的计算机上 生成 SSH 密钥。
创建 GitHub 仓库
访问 repo.new,创建一个新的 GitHub 仓库。创建新仓库后,进入新创建的项目目录,准备并在终端运行以下命令将本地应用程序推送到 GitHub:
使用 Cloudflare 页面部署
通过 create-cloudflare
CLI (C3) 进行部署
如果使用
create-cloudflare
(C3)创建新的 Hono 项目,C3 将安装项目所需的所有依赖项,并提示你通过 CLI 部署项目。如果你进行了部署,你的网站就会上线,并向你提供一个部署 URL。
通过 Cloudflare 控制面板部署
- 登录 Cloudflare 仪表板 并选择你的账户。
- 在账户主页,选择 工作者和页面> 创建应用程序> 页面> 连接到 Git。
- 选择创建的新 GitHub 仓库,并在
**设置构建和部署**
部分提供以下信息:
Configuration option | Value |
---|---|
Production branch | main |
Build command | npm run build |
Build directory | dist |
配置好网站后,你就可以开始首次部署了。你应该会看到 Cloudflare 页面正在安装 my-hono-app
、你的项目依赖项,并在部署前构建你的网站。
部署网站后,你将在 *.pages.dev
上为你的项目收到一个唯一的子域。
每次你向 Hono 网站提交新代码时,Cloudflare Pages 都会自动重建你的项目并进行部署。你还可以在新的拉取请求中访问 预览部署,这样你就可以在将更改部署到生产环境之前预览网站的外观。
相关教程
有关 Hono 的更多教程,请参考以下资源: