如何本地调试 FckSignups 的 Cloudflare Worker:wrangler 开发指南

如何本地调试 FckSignups 的 Cloudflare Worker:wrangler 开发指南 如何本地调试 FckSignups 的 Cloudflare Workerwrangler 开发指南【免费下载链接】FckSignupsA list of tools that are open-source, in-browser, and require no-signups!项目地址: https://gitcode.com/GitHub_Trending/fc/FckSignupsFckSignups 是一个收录免注册开源工具的导航站点它的后端是一个跑在 Cloudflare Workers 上的提交服务。本文带你用 wrangler 在本地把 FckSignups 的 Cloudflare Worker 完整跑起来覆盖环境搭建、密钥配置、路由测试到前端联调几分钟即可上手中。Worker 在 FckSignups 里负责什么在前端页面点击提交工具 / 举报 / 建议后请求会打到 Worker 的三个路由上Worker 校验参数后调用 GitHub API 自动创建一个 Issue路由处理函数作用POST /submit-toolhandleSubmitTool.ts提交新工具生成 IssuePOST /report-toolhandleReportTool.ts举报失效/不合规工具POST /suggest-toolhandleSuggestTool.ts建议补充工具信息所有请求统一从 worker.ts 的fetch入口分发非 POST 请求一律返回 404OPTIONS预检请求返回 204 并携带 CORS 头。一键搭建本地调试环境1️⃣ 克隆仓库并进入 Worker 目录git clone https://gitcode.com/GitHub_Trending/fc/FckSignups.git cd FckSignups/cloudflare-worker npm install2️⃣ 确认 wrangler.toml 关键配置入口文件为worker.ts并开启了nodejs_compat兼容标志本地调试无需改动。配置本地密钥.dev.vars 文件怎么写Worker 依赖三个环境变量定义在 utils.ts 的Env接口中GITHUB_TOKEN带repo权限的 GitHub 令牌GITHUB_REPO_OWNER仓库所有者GITHUB_REPO_NAME仓库名本地调试时在cloudflare-worker/目录下新建.dev.vars文件已被 gitignore不会误提交GITHUB_TOKENghp_你的令牌 GITHUB_REPO_OWNERBraveOPotato GITHUB_REPO_NAMEFckSignups wrangler dev 会自动加载.dev.vars。如果只调试参数校验逻辑可以填占位值只有真正调用 GitHub API 创建 Issue 时令牌才必须有效。启动本地开发服务器wrangler dev 最快启动方法在cloudflare-worker/目录下执行npm run dev即 package.json 中定义的wrangler dev。启动后终端会打印类似http://localhost:8787/v1/worker的本地地址代码每次保存都会热更新无需重启。验证 Worker用 curl 测试三个路由启动后用 curl 直接打路由最快确认服务是否正常# 测试提交工具 curl -X POST http://localhost:8787/submit-tool \ -H Content-Type: application/json \ -d {name:My Tool,description:A demo tool,url:https://example.com,category:productivity,tags:[demo],github:}预期结果对照场景预期响应参数齐全且令牌有效200返回{ok:true}GitHub 上新增一条带tool-submission标签的 Issue缺少必填字段400提示Missing required field: xxxGET 请求或未知路径404字段校验逻辑集中在 handleValidate 函数name、description、url、category必填URL 必须合法name最长 100 字符。前端 Worker 联调CORS 白名单怎么配本地联调无需改代码CORS 白名单在 utils.ts 中已经放行了http://localhost:5173Vite 默认端口和http://localhost:4173vite preview所以只需两个终端并行# 终端 1前端仓库根目录 npm install npm run dev # 终端 2Worker cd cloudflare-worker npm run dev然后打开http://localhost:5173直接点击页面上的提交按钮即可真实走通表单 → Worker → GitHub Issue全链路。从本地调试到部署上线本地验证通过后发布前先把密钥写入 Cloudflare 侧密钥不存进代码库见 wrangler.toml 注释npx wrangler secret put GITHUB_TOKEN npx wrangler secret put GITHUB_REPO_OWNER npx wrangler secret put GITHUB_REPO_NAME最后执行npm run deploy一键上线。常见问题排查清单现象原因与解法返回 502Failed to create GitHub issue令牌无效或权限不足确认令牌带reposcope且 OWNER/NAME 拼写正确浏览器报 CORS 错误确认前端跑在 5173/4173 端口或按 corsHeaders 把 Origin 加入白名单请求返回 404Worker 只接受 POST检查请求方法与路径是否匹配三个路由修改.dev.vars不生效文件必须放在cloudflare-worker/目录下并重启wrangler dev搞定以上步骤你就可以在本地自由调试 FckSignups 的 Cloudflare Worker 了改代码、看热更新、打 curl、联调前端整个过程不到十分钟。【免费下载链接】FckSignupsA list of tools that are open-source, in-browser, and require no-signups!项目地址: https://gitcode.com/GitHub_Trending/fc/FckSignups创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考