部署教程#

首先fork我的github项目

当然你fork上游也是可以的,不过部署到worker要在根目录下额外创建wrangler.jsonc文件

1
{
2
  "name": "fuwari",
3
  "compatibility_date": "2025-10-06",
4
  "assets": {
5
    "directory": "./dist",
6
    "not_found_handling": "404-page" // 如果你有自定义的 /src/pages/404.astro 页面
7
  }
8
}

注册一个cloudflare账号,从计算和 AI选项卡进入Workers 和 Pages页面,创建应用程序在Workers选项卡中点击导入存储库(你用pages也是可以的,但是默认分的ip慢慢的,优选也很麻烦)

授权cloudflare访问你的github账号,然后选择你的仓库,项目名称填好之后,构建命令pnpm build,部署命令默认的npx wrangler deploy即可,剩下不用管,点击创建和部署

NOTE

如果在最后部署失败了,但是构建是正常的,那么请检查一下wrangler.jsonc中的项目名称是否均为小写字母,大写及其他不可以哦

进入项目设置,在域和路由中可以看到默认分了两个地址,一个已启用的workers.dev,这个域名在国内是被封禁了的,正常网络环境下无法访问,和vercel.app一样

点击添加路由,选择你的区域,路由是动态表达式,失败模式任意,然后添加即可通过这个域名访问你的fuwari博客了

假设你要部署的域名是fuwari.oh1.top,那么就在路由框里填写fuwari.oh1.top/*,后面的/*是必要的,如果没有则只有**fuwari.oh1.top*这一个URL的请求会被转发到worker

(可选)PR预览#

在项目设置,构建选项卡中的分支控制中启用拉取请求预览,这样cloudflare将会为你仓库中的每一个PR请求部署一个预览URL,不过也是worker.dev的,国内无法直连,并且由于CF构建缓存的原因部署也比较慢,所以一般使用netlify进行预览