跳转到内容
搜索文档

Hono

最后更新 查看 MarkdownAgent 设置

从 CLI 开始 — 使用 Hono API、React SPA 和 Cloudflare Vite 插件 搭建全栈应用,获得极速开发体验。

npm create cloudflare@latest -- my-hono-app --template=cloudflare/templates/vite-react-template

或直接部署 — 使用 Hono、React 和 Vite 创建全栈应用,CI/CD 与预览均已为你配置好。

Deploy to Workers

什么是 Hono?

Hono 是一个超轻量、高性能的 Web 应用框架,与 Cloudflare Workers 配合极佳。 配合 Workers Assets,你可以轻松将在 Workers 上运行的 Hono API 与 SPA 结合,创建全栈应用。

使用 React SPA 创建全栈 Hono 应用

  1. 使用 create-cloudflare CLI (C3) 创建新项目

    npm create cloudflare@latest -- my-hono-app --template=cloudflare/templates/vite-react-template

    此项目是如何设置的?

    以下是项目的简化文件树。

    • my-hono-app
      • src
        • worker/
          • index.ts
        • react-app/
      • index.html
      • vite.config.ts
      • wrangler.jsonc

    wrangler.jsonc 是你的 Wrangler 配置文件。 在此文件中:

    • main 指向 src/worker/index.ts。这是你的 Hono 应用,将在 Worker 中运行。
    • assets.not_found_handling 设置为 single-page-application,意味着由 SPA 处理的路由不会进入 Worker,因此免费。
    • 若要为 Cloudflare 开发者平台资源添加绑定(binding),在此配置。阅读更多关于绑定(binding)的信息。

    vite.config.ts 配置为使用 Cloudflare Vite 插件。这会在 Cloudflare Workers 运行时中运行 Worker,确保本地开发环境尽可能接近生产环境。

    src/worker/index.ts 是你的 Hono 应用,初始包含单个端点 /api。 在 src/react-app/src/App.tsx 中,React 应用调用此端点获取消息并在 SPA 中显示。

  2. 使用 Cloudflare Vite 插件 在本地开发

    创建项目后,在项目目录中运行以下命令以启动本地开发服务器。

    npm run dev

    本地开发中发生了什么?

    此项目使用 Vite 进行本地开发和构建,因此具备 Vite 的所有功能,包括热模块替换(HMR)。

    此外,vite.config.ts 配置为使用 Cloudflare Vite 插件。这会在 Cloudflare Workers 运行时中运行应用,与生产环境一致,并支持访问绑定的本地模拟。

  3. 部署项目

    你可以从本地机器或任何 CI/CD 系统(包括 Cloudflare 自有的 Workers Builds)将项目部署到 *.workers.dev 子域或自定义域名

    以下命令将构建并部署项目。若使用 CI,请确保相应更新你的 「deploy command」 配置。

    npm run deploy

绑定(binding)

Hono 文档 介绍了如何在 Hono 应用中访问绑定(binding)。

通过绑定(binding),你的应用程序可以与 Cloudflare Developer Platform 完全集成,让你访问计算、存储、AI 等功能。

Bindings

访问计算、存储、AI 等功能。

这篇文档对您有帮助吗?