【免费下载链接】FuckClaude
想快速部署FuckClaude吗？这个项目是一个基于Astro 7构建的中英双语"中国用户"检测工具——扫描浏览器时区、语言、字体等信号，判断你是否会被 Claude Code 标记为中国用户，全程 100% 本地运行、不上传任何数据。本文带你 10 分钟内完成 Fork、本地开发、构建与 Vercel 上线的全流程部署。
一、项目亮点：为什么值得部署
在动手之前，先了解你要部署的是什么，这能帮你更快定位配置文件：
- 🕵️浏览器本地扫描：点击即逐项检测 10 个环境信号（系统时区、浏览器语言、中文字体、WebRTC IP 泄露等），权重合计 100 分并给出低/中/高风险结论
- 🌐中英双语：英文在
/，中文在/zh/，由 Astro 内置 i18n 驱动 - ⚡静态 + 一个接口：所有页面预渲染为静态 HTML，只有
/api/check以 Vercel Function 运行，供curl做服务端估算 - 📦零 UI 框架依赖：仅 3 个运行时依赖，构建快、体积小、易于维护
二、技术栈速览
| 组件 | 作用 | 关键文件 |
|---|---|---|
Astro 7（output: 'static'） | 静态站点框架 | package.json |
@astrojs/vercel | 让唯一动态路由跑成 Vercel Function | astro.config.mjs |
@astrojs/sitemap | 自动生成双语 sitemap | astro.config.mjs |
| pnpm | 包管理器 | package.json |
核心配置在 astro.config.mjs：site指向真实部署域名、adapter: vercel()、i18n 双语言路由，这是后面部署前必须修改的地方。
三、一键安装步骤：Fork 并克隆仓库
1. Fork 到你的账号
先在 GitCode 上 Fork 本项目（点击仓库页的 Fork 按钮），得到一个属于你的仓库副本。
2. 克隆到本地
git clone https://gitcode.com/gh_mirrors/fu/FuckClaude cd FuckClaude部署自己的副本时，请改用你 Fork 后的仓库地址。项目基于 MIT 协议，LICENSE 要求保留原始版权与署名声明。
3. 安装依赖
项目使用pnpm管理依赖（未安装可执行npm i -g pnpm）：
pnpm install依赖极少——运行时只有astro、@astrojs/vercel、@astrojs/sitemap三个，几秒即可装完。
四、最快配置方法：本地开发验证
1. 启动开发服务器
pnpm dev访问 http://localhost:4321 即可看到首页：中英切换、扫描动效、分数环、吉祥物各状态图（位于public/mascot/）全部可用。客户端扫描逻辑全部集中在 src/scripts/detect.ts，检测信号定义与权重在 src/config/signals.ts。
2. 生产构建与预览
pnpm build # 产物输出到 dist/ pnpm preview # 本地模拟线上环境构建成功会生成dist/静态目录。此时可顺便检查两个生成产物：双语sitemap-index.xml和public/og.png社交分享卡片（可用node scripts/gen-assets.mjs重新生成，见 scripts/gen-assets.mjs）。
⚠️ 本地没有 Vercel 的 geo 请求头，因此
/api/check在preview下返回的是"缺少 geo 头"的提示，这属于正常现象，不代表部署会失败。
五、上线前关键配置：修改 site 与 robots.txt
部署前只需改两处，就能保证 canonical URL、hreflang与 sitemap 指向你的真实域名：
修改 astro.config.mjs 中的
sitesite: 'https://your-own-domain.vercel.app',提交到 Vercel 部署后，可再把这里更新为你绑定的正式自定义域名。
修改 public/robots.txt 中的 Sitemap 地址
Sitemap: https://your-own-domain.vercel.app/sitemap-index.xml
六、Vercel 一键部署流程
1. 导入项目
在 Vercel 控制台选择Add New → Project，导入你 Fork 的仓库，保持默认检测即可（Vercel 会自动识别 Astro 框架与output: 'static'）。
2. 触发构建
默认构建命令pnpm build无需改动。构建完成后：
- 所有页面预渲染为静态 HTML，全球 CDN 加速
- 唯一
prerender = false的路由 src/pages/api/check.ts 自动部署为 Vercel Function，可读取x-vercel-ip-timezone、x-vercel-ip-country等 geo 请求头做服务端估算
3. 验证上线
部署完成后做三项验收：
# 浏览器访问首页与 /zh/ 中文页，确认双语正常 # curl 测试服务端接口（响应语言跟随 Accept-Language） curl -H "Accept-Language: zh" https://你的域名/api/check # 打开 sitemap-index.xml，确认站点地图指向正确域名看到/api/check返回一份带风险分档的文本报告，就标志着部署成功 🎉
七、常见问题 FAQ
| 问题 | 原因与解决 |
|---|---|
本地/api/check无 geo 数据 | 正常。geo 请求头只在 Vercel 部署环境存在（见 src/pages/api/check.ts 注释） |
| 部署后 sitemap / 分享卡片域名错误 | 忘了改site与robots.txt，按第五节修改后重新部署即可 |
| 能否部署到其他静态托管？ | 可以（Cloudflare Pages、Netlify 等），页面功能完整，仅/api/check接口为 Vercel 特有 |
八、小结
整套流程回顾：Fork →pnpm install→pnpm dev本地验证 → 改site/robots.txt→ Vercel 导入部署 → curl 验收，熟练后 10 分钟即可跑通。
值得继续探索的模块：检测信号与权重 src/config/signals.ts、防封指南资料库 src/content/guides/（18 篇双语指南）、新增/调整信号的操作手册 skills/detection-signals/SKILL.md。
【免费下载链接】FuckClaude
相关推荐
零基础玩转SaaS开发：Next.js+Postgres全栈项目从本地到Vercel的极速部署指南
零基础玩转SaaS开发：Next.js+Postgres全栈项目从本地到Vercel的极速部署指南 SaaS开发入门不再困难！本文将带你零基础上手GitHub推
后端前端5分钟上手Express.js Serverless部署：从开发到上线全流程
5分钟上手Express.js Serverless部署：从开发到上线全流程 你还在为Express应用的服务器运维烦恼吗？服务器配置、扩容、成本控制是不是让你
后端Web框架5分钟上手Avalonia容器化：从本地开发到Docker部署全流程
5分钟上手Avalonia容器化：从本地开发到Docker部署全流程 你还在为跨平台UI应用的部署兼容性头疼吗？本文将带你用Docker容器化Avalonia应
前端跨平台UI组件桌面应用
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
