使用 Cloudflare Pages 部署 Bolt.diy
让我们开始吧! ![]()
在本地计算机上
运行 Bolt.diy⚡ 需要一些依赖项。这些通常是构建和部署所必需的,但本教程将非常简单,我们将跳过所有噪音
。我们将使用 GitHub Actions 在云中构建所有内容
.最好的部分是什么?Bolt.diy 已经拥有了您需要设置的大部分内容,只是进行了一些细微的调整(基本上需要删除一些东西并设置一些标志)。![]()
无需
安装最新的 .NET 版本(在 Windows 上可能是一个问题),拥有 Node(npm 和 pnpm),甚至 Git。无需处理安全性
或任何类型的设置
.这就是这变得多么容易。所以,请密切关注所有步骤,让我们看看谁先到达终点线!![]()
先决条件:只有三个;如果您还没有 Cloudflare
、GitHub
和 HuggingFace
帐户,请注册它们。
它们都是完全免费的!![]()
设置 GitHub ![]()
- 浏览到 GitHub 页面并登录,或创建帐户
- 浏览至 Bolt.diy GitHub 页面
- 单击 Fork (分叉)


- 在 "Create a new fork" 对话框中,单击 "Create fork" 按钮

- 注意:不要选中 "Copy the branch only",以便我们稍后可以切换分支
- 稍等一会儿...
- 单击 "Code" 并浏览到 ".tool-verions"
- 从下拉列表中切换到分支
- 注意:在 0.0.3 版本中,Bolt.diy 被更改为具有一个分支
- 单击文件名将其打开并删除文件
- 注意:此文件会导致部署出现问题
- 将更改提交回您的 Fork
- 对 wrangler.toml 进行相同操作
- 注意:因为否则 Cloudflare 会检测到它,使用它来部署,然后在我们进入 Cloudflare 设置时覆盖环境变量
设置 Cloudflare⚙️
- 注册或登录 Cloudflare
- 在Cloudflare中点击"Workers & Pages"
- 点击 "Create"
- 点击 "Pages" 选项卡,然后点击 "Connect to Git"
- 注意:如果这是第一次连接 git,Cloudflare 将引导您完成该过程
- 选择您的 GitHub 帐户和存储库 (bolt.diy)
- 配置"设置和部署"选项
- 对于 Framework preset,从下拉列表中选择
- 对于 Build command,我们将修改为
- 注意:完全按照环境变量(.env 文件)中列出的方式添加环境变量
- 警告:如果您不使用 pnpm run build,页面样式会搞砸
- 单击"Setup and Deploy"按钮
- 注意:出于安全原因,我没有在图像中包含密钥
- 构建失败(冷静点,没事的!)
- 注意:我们不会使用 wrangler,因此初始部署将失败
- 单击"Continue to project"并同意警告提示
- 单击 Settings 并向下滚动到 Runtime
- 对于"兼容日期",单击"编辑",选择,然后单击"保存"
- 对于"兼容性标志",单击"编辑",设置为 nodejs_compat,然后单击"保存"
- 在"Branch control"中,点击编辑图标并将 branch 更改为 stable
- 单击 "Deployments" 选项卡,然后单击 "View Details"
- 单击 "Retry deployment"
- 等等......成功!所有设置和部署!
- 注意:由于缓存的原因,页面可能无法在第一次正确加载
可选步骤: ![]()
设置自定义 URL ![]()
- 如果您已经在 Cloudflare 上设置了域名,只需提供子域
- 让 Cloudflare 完成工作,然后单击"激活域"
- 等待几分钟,然后完成
更改时更新 Bolt.diy 部署
- 转到你分叉的 GitHub 存储库,将 branch 更改为 "Stable",然后单击 "Sync fork" 下拉菜单
- 点击下拉列表中的"更新分支"
- 注意:不要点击"放弃 X 提交"
- 更新分支会自动触发 Cloudflare Pages 重新构建和部署
故障 排除:
- Bolt.diy 页面样式被顶起
- 错误:pnpm plugin is not installed
- Safari 存在一些已知问题
- 不使用 stable 分支导致的错误
- 确保环境变量中没有等号
- 确保设置 compatability_flags 日期和 nodejs_compat
最后步骤:测试部署
- 打开 URL(生成或自定义)并测试一切是否正常
- 如果您遇到问题,请告诉我
- 我们非常感谢您通过 GitHub 页面放置问题项
最后的思考 ![]()
希望本教程看起来简单明了,但它需要大量的测试和流程改进,因为确实没有关于这方面的好文档。希望它对你有用,你只是感谢你的努力(表达一些爱 - 收藏🔖并给予一颗心❤️)。
本教程将来可能会有更新。
谢谢!![]()
P.S. PDF 版本
可通过我的 google drive 获得
(欢迎访问极光工具箱tool.520131445.xyz)