NoSignups (FckSignups)
部署 NoSignups:分开管理静态页面、实时目录和提交服务
弄清 Vite 构建产物、独立更新的目录地址和可选 Worker,避免把前端部署当成全部系统的发布。
你将学会
- 静态前端、目录来源和提交服务是独立产物。
- main 分支目录可以在前端不发布时发生变化。
- 分支发布必须检查身份信息和写入目标。
开始前需要
- 基础 JavaScript 和 JSON 知识
- 一个无敏感任务样本与目录测试记录
解释本章边界,并用建议样例或审查记录进行核验。
先看结论
- 静态前端、目录来源和提交服务是独立产物。
- main 分支目录可以在前端不发布时发生变化。
- 分支发布必须检查身份信息和写入目标。
把目录前端作为独立产物构建
根 package 使用 tsc && vite build。已检查的 Vite 配置启用 React,并把 WebSite 结构化数据注入 HTML,没有配置服务端渲染。在未修改的 Vite 默认配置下,dist 是静态前端产物;实际发布前仍应检查构建输出,而不是上传源码或把开发服务当作正式部署。
仓库还包含独立的 cloudflare-worker 目录,其 Worker 处理提交、举报和建议,并能创建 GitHub issue。只阅读卡片不需要这个写入服务,但启用表单的分支必须明确提交目标。只读部署应关闭或调整写操作,避免私有测试意外请求原项目的服务。
决定目录是否可以独立更新
PROD_JSON_URL 经 raw.githubusercontent.com 指向上游 main 分支的 tools.json,生产模式会先请求这个地址,再考虑内嵌回退数据。因此,前端不重新构建也能显示后来修改的目录。这有利于及时更新,却意味着回滚 JavaScript 不一定会恢复此前的工具清单。
受控分支需要明确选择移动目录地址、固定版本快照或同源数据。调整这一行为属于分支代码修改,本文没有把它描述成现成配置开关。把源码提交、目录哈希和部署标识一起记录,并单独验证回退场景;能够显示旧数据,不应该被报告成远程最新数据正常加载。
域名、元数据和表单都是发布输入
websiteSchema 写有 NoSignups 名称和 nosignups.net 网站地址。如果迁移到新域名而不检查这些内容,结构化数据可能描述错误的发布者。部署时应检查 HTML、JSON-LD、源码链接和表单端点,并查验实际依赖的运行环境要求,不要从 README 臆测最低 Node 版本。
若运行 Worker,GitHub 凭据只能放进服务端秘密配置,不能放入会暴露给浏览器的 Vite 变量。仓库配置列出了秘密名称和兼容日期,但并不能证明生产服务已经运行。集成测试应使用自己控制的仓库,创建 issue 前取得明确授权。本次文章没有部署 Worker,也没有向上游提交 issue。
实施步骤
- 1
审查脚本并在目标环境安装依赖。
- 2
运行构建,检查 dist 和注入元数据。
- 3
选择并记录目录版本策略。
- 4
发布分支前关闭或配置提交端点。
可复制示例
git clone https://github.com/BraveOPotato/FckSignups.git
cd FckSignups
git checkout 5c3da4a1934c7a4ce833ebafbeb500b6f52a4faf
npm install
npm run build
# 本地检查构建产物,不是生产服务。
npm run preview常见问题
前端回滚会恢复旧目录吗?
若仍请求上游 main 分支的移动 JSON 地址,就不一定。需要一致回滚时,应另外固定目录版本。
目录必须托管在 Cloudflare 吗?
已检查的根应用生成 Vite 前端。Cloudflare Worker 是独立的写入服务,不是浏览器本地筛选引擎。
资料来源
- README.md来源核查 2026-09-07
- package.json来源核查 2026-09-07
- vite.config.mts来源核查 2026-09-07
- src/hooks/useTools.ts来源核查 2026-09-07
- src/components/Home/Tools/Tools.tsx来源核查 2026-09-07
- src/components/Home/Tools/ToolCard/ToolCard.tsx来源核查 2026-09-07
- src/types/index.ts来源核查 2026-09-07
- src/constants/fallbackData.ts来源核查 2026-09-07
- src/data/schema.js来源核查 2026-09-07
- cloudflare-worker/worker.ts来源核查 2026-09-07
- cloudflare-worker/urlHandlers/handleSubmitTool.ts来源核查 2026-09-07
- cloudflare-worker/utils.ts来源核查 2026-09-07