[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-95903":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":15,"stars7d":15,"stars30d":16,"stars90d":15,"forks30d":15,"starsTrendScore":15,"compositeScore":17,"rankGlobal":10,"rankLanguage":10,"license":10,"archived":18,"fork":18,"defaultBranch":19,"hasWiki":20,"hasPages":18,"topics":21,"createdAt":10,"pushedAt":10,"updatedAt":22,"readmeContent":23,"aiSummary":24,"trendingCount":15,"starSnapshotCount":15,"syncStatus":25,"lastSyncTime":26,"discoverSource":27},95903,"usque-custom-pro","KJGX66F\u002Fusque-custom-pro","KJGX66F","基于 Cloudflare WARP \u002F MASQUE 的可视化注册、配置生成与多客户端转换工具。 生成、Clash\u002FMihomo 智能分流、Shadowrocket、sing-box、本地 VLESS 桥接，以及可选的 WARP 出口检测。","https:\u002F\u002Fusque-custom-pro.pages.dev\u002F",null,"JavaScript",734,1121,138,0,596,13.15,false,"main",true,[],"2026-09-21 02:04:28","# Usque MASQUE Pro v6.7\n\n> 基于 Cloudflare WARP \u002F MASQUE 的可视化注册、配置生成与多客户端转换工具。  \n> 支持 **Cloudflare Pages + Cloudflare Workers 双部署**，浏览器完成 Usque 注册、原生配置保存、MASQUE 多节点生成、Clash\u002FMihomo 智能分流、Shadowrocket、sing-box、本地 VLESS 桥接，以及可选的 WARP 出口检测。\n>\n> # YouTube视频教程 [点击查看](https:\u002F\u002Fyoutu.be\u002FeRIjgiVHsbs)\n\n---\n\n## 目录\n\n- [项目介绍](#项目介绍)\n- [核心功能](#核心功能)\n- [项目原理](#项目原理)\n- [目录结构](#目录结构)\n- [部署方式一：Cloudflare Pages（推荐）](#部署方式一cloudflare-pages推荐)\n- [部署方式二：Cloudflare Workers](#部署方式二cloudflare-workers)\n- [首次使用教程](#首次使用教程)\n- [Clash \u002F Mihomo 使用教程](#clash--mihomo-使用教程)\n- [ChatGPT \u002F OpenAI 简单模式](#chatgpt--openai-简单模式)\n- [节点数量与 H2 扩展池](#节点数量与-h2-扩展池)\n- [其它输出格式](#其它输出格式)\n- [WARP 出口国家检测（高级）](#warp-出口国家检测高级)\n- [升级项目](#升级项目)\n- [常见问题](#常见问题)\n- [安全与隐私](#安全与隐私)\n- [重要说明](#重要说明)\n\n---\n\n# 项目介绍\n\n**Usque MASQUE Pro v6.7** 是一个面向 Cloudflare WARP \u002F MASQUE 的浏览器可视化工具。\n\n它解决的主要问题是：\n\n```text\n手动注册 WARP \u002F MASQUE\n        ↓\n配置字段复杂\n        ↓\n不同客户端格式不一致\n        ↓\n需要手工写 Clash \u002F sing-box \u002F VLESS 配置\n```\n\n本项目把整个流程整理成：\n\n```text\n打开网页\n  ↓\n一键注册 Usque \u002F WARP MASQUE\n  ↓\n自动下载原生 config.json\n  ↓\n按需要设置 Endpoint \u002F Port \u002F SNI \u002F DNS \u002F 节点数量\n  ↓\n一键生成客户端配置\n  ↓\nClash \u002F Mihomo \u002F Shadowrocket \u002F sing-box \u002F VLESS 本地桥接\n```\n\n项目重点面向：\n\n- 第一次接触 Usque \u002F MASQUE 的用户\n- 不想手工编辑大量 YAML \u002F JSON 的用户\n- 需要批量生成 MASQUE 候选节点的用户\n- 需要 Clash \u002F Mihomo 智能分流的用户\n- 想把原生 Usque 配置长期保存、以后重复使用的用户\n\n---\n\n# 核心功能\n\n## 1. 一键注册 Usque \u002F WARP MASQUE\n\n浏览器中完成：\n\n- WARP 设备注册\n- P-256 MASQUE 密钥生成\n- MASQUE 公钥 enroll\n- 自动整理原生 Usque `config.json`\n\n注册成功后可以立即下载：\n\n```text\nusque-config.json\n```\n\n以后只需要重新导入这个文件，不必每次重新注册。\n\n---\n\n## 2. 原生配置作为唯一源文件\n\n项目不会要求你每次重新创建账户。\n\n推荐流程：\n\n```text\n第一次：注册 → 保存 config.json\n以后：导入 config.json → 修改参数 → 重新生成\n```\n\n原生配置通常包含：\n\n```text\nprivate_key\nendpoint_v4\nendpoint_v6\nendpoint_h2_v4\nendpoint_h2_v6\nendpoint_pub_key\nlicense\nid\naccess_token\nipv4\nipv6\n```\n\n> `config.json` 包含私钥与设备凭据，请勿上传到 GitHub、网盘、公开群组或公开网页。\n\n---\n\n## 3. 多节点生成\n\n支持：\n\n```text\n13 节点\n32 节点\n64 节点\n100 节点\n自定义 1～500 节点\n```\n\n生成方式包括：\n\n- 精选 Endpoint + Port\n- Endpoint × Port 组合\n- 均衡分布\n- 全排列\n- 稳定打散\n- 自动去重\n- 自定义附加 Endpoint\n\n---\n\n## 4. QUIC \u002F H3 与 H2\n\n支持：\n\n```text\nQUIC \u002F H3\nH2 \u002F TCP\n```\n\nH2 模式提供扩展地址池，适合生成大量候选节点进行测速筛选。\n\n> 节点数量多不代表每个节点都一定可用。不同网络、地区、运营商对不同入口和端口的可达性会不同。\n\n---\n\n## 5. Clash \u002F Mihomo 智能分流\n\n自动生成：\n\n- MASQUE 节点\n- 自动测速 `url-test`\n- PROXY 策略组\n- AI\n- YouTube\n- Emby\n- TikTok\n- Netflix\n- Disney+\n- Spotify\n- GitHub\n- Telegram\n- Google\n- Twitter \u002F X\n- Instagram\n- Facebook\n- Apple\n- Microsoft\n- Steam\n- Xbox\n- PlayStation\n- Nintendo\n- Bilibili\n- 国外网站\n- 漏网之鱼\n\n并使用 MetaCubeX MRS 规则集进行智能分流。\n\n---\n\n## 6. ChatGPT \u002F OpenAI 简单模式\n\nv6.7 默认推荐：\n\n```text\nChatGPT \u002F OpenAI → DIRECT\n其它国外流量     → WARP \u002F MASQUE\n```\n\n目的是避免某些共享 WARP 出口被 ChatGPT 拒绝时，整个代理配置都不可用。\n\n网页中可以切换：\n\n```text\nDIRECT 直连\nWARP · AI 自动选择\nWARP · 地区优选\nWARP · PROXY\nAI 策略组\n```\n\n---\n\n## 7. 多格式输出\n\n当前支持：\n\n```text\n原生 Usque config.json\nClash \u002F Mihomo\nShadowrocket\nsing-box\nVLESS 本地桥接\n```\n\n---\n\n## 8. WARP 出口检测\n\n高级功能可以通过本机 Mihomo API：\n\n- 逐节点切换 MASQUE 节点\n- 检测实际出口 IP\n- 检测国家 \u002F 地区 \u002F 城市\n- 检测 Cloudflare PoP\n- 测试延迟\n- 测试 ChatGPT HTTP 可达性\n- 输出 JSON \u002F CSV 报告\n- 根据国家偏好自动选择候选节点\n\n这个功能默认折叠，新手可以完全不使用。\n\n---\n\n# 项目原理\n\n## 整体架构\n\n### Cloudflare Pages 版\n\n```text\n浏览器\n  │\n  ├─ index.html \u002F app.js \u002F usque-register.js\n  │\n  ├─ 浏览器本地生成 P-256 私钥\n  │\n  └─ POST \u002Fapi\u002Fwarp\u002F*\n          ↓\n      Pages _worker.js\n          ↓\n Cloudflare WARP 注册 API\n```\n\nPages 中：\n\n```text\n静态页面 → Pages 直接提供\n\u002Fapi\u002F*   → _worker.js\n```\n\n由 `_routes.json` 控制：\n\n```json\n{\n  \"version\": 1,\n  \"include\": [\"\u002Fapi\u002F*\"],\n  \"exclude\": []\n}\n```\n\n这样静态页面不会经过 API Worker。\n\n---\n\n### Cloudflare Workers 版\n\n```text\n浏览器\n   ↓\nWorkers Static Assets\n   ├─ public\u002Findex.html\n   ├─ public\u002Fapp.js\n   └─ public\u002Fstyle.css\n\n\u002Fapi\u002F*\n   ↓\nsrc\u002Fworker.js\n   ↓\nCloudflare WARP 注册 API\n```\n\nWorkers 版通过：\n\n```text\nwrangler.jsonc\n```\n\n配置：\n\n```jsonc\n\"assets\": {\n  \"directory\": \".\u002Fpublic\",\n  \"binding\": \"ASSETS\",\n  \"run_worker_first\": [\"\u002Fapi\u002F*\"]\n}\n```\n\n因此：\n\n```text\n普通静态资源 → Static Assets\n\u002Fapi\u002F*       → Worker\n```\n\n---\n\n## 注册原理\n\n### 第一步：创建设备\n\n浏览器生成注册所需随机信息，并请求：\n\n```text\n\u002Fapi\u002Fwarp\u002Fregister\n```\n\nWorker 只把固定格式请求转发到 Cloudflare WARP 注册接口。\n\n---\n\n### 第二步：浏览器生成 P-256 MASQUE 密钥\n\nMASQUE 私钥使用浏览器 WebCrypto：\n\n```text\nECDSA\nP-256 \u002F secp256r1\n```\n\n生成。\n\n项目会把私钥转换成 Usque 所需的 SEC1 DER Base64 格式。\n\n关键点：\n\n```text\nP-256 私钥在浏览器本地生成\n```\n\nWorker enroll 时只需要 MASQUE 公钥。\n\n---\n\n### 第三步：Enroll MASQUE\n\n浏览器请求：\n\n```text\n\u002Fapi\u002Fwarp\u002Fenroll\n```\n\nWorker 将 P-256 公钥提交给 WARP API，并获取：\n\n```text\nMASQUE endpoint\nendpoint public key\ninterface IPv4 \u002F IPv6\n设备信息\n```\n\n随后浏览器把这些信息与本地私钥组合成：\n\n```text\nusque-config.json\n```\n\n---\n\n## MASQUE 多节点原理\n\n这里生成的 13 \u002F 32 \u002F 64 \u002F 100 \u002F 500 个节点，并不是注册 500 个账户。\n\n核心逻辑是：\n\n```text\n同一套 Usque \u002F WARP 凭据\n          +\n不同 Endpoint\n          +\n不同 Port\n          ↓\n多个 MASQUE 候选连接\n```\n\n例如：\n\n```text\nEndpoint A : 443\nEndpoint A : 500\nEndpoint A : 4500\nEndpoint B : 443\nEndpoint B : 500\n...\n```\n\n因此：\n\n- 节点数量 ≠ WARP 账号数量\n- 节点数量 ≠ 独立出口数量\n- 节点数量 ≠ 每个节点都有独立流量额度\n\n大量候选主要用于：\n\n```text\n测速\n自动选择\n寻找当前网络更稳定的入口组合\n```\n\n---\n\n## WARP 入口与出口不是一回事\n\n这是本项目最容易误解的地方。\n\n```text\nMASQUE Endpoint\n      ↓\nCloudflare 入口\n      ↓\nCloudflare 网络\n      ↓\nWARP 出口 IP\n```\n\n修改：\n\n```text\nEndpoint\nPort\nSNI\n```\n\n主要改变的是 **如何进入 Cloudflare 网络**，并不能保证把最终 WARP 出口强制切换成美国、日本、新加坡等国家。\n\n因此项目中的“出口国家优选”是：\n\n```text\n检测现有节点的真实出口\n        ↓\n从已经出现的出口中选择更符合偏好的节点\n```\n\n不是：\n\n```text\n强制 Cloudflare 生成指定国家出口\n```\n\n---\n\n# 目录结构\n\nv6.7 双部署版：\n\n```text\nusque-custom-pro-v67-dual\u002F\n│\n├─ README.md\n│\n├─ pages\u002F\n│  ├─ index.html\n│  ├─ app.js\n│  ├─ style.css\n│  ├─ usque-register.js\n│  ├─ _worker.js\n│  ├─ _routes.json\n│  ├─ _headers\n│  └─ warp-egress-selector.py\n│\n└─ workers\u002F\n   ├─ package.json\n   ├─ wrangler.jsonc\n   ├─ deploy-windows.bat\n   ├─ deploy-linux-macos.sh\n   ├─ src\u002F\n   │  └─ worker.js\n   └─ public\u002F\n      ├─ index.html\n      ├─ app.js\n      ├─ style.css\n      ├─ usque-register.js\n      ├─ _headers\n      └─ warp-egress-selector.py\n```\n\n---\n\n# 部署方式一：Cloudflare Pages（推荐）\n\n如果你是第一次使用，推荐 Pages。\n\n## 方法 A：GitHub + Cloudflare Pages\n\n这是最推荐的部署方式，因为以后更新代码只需要 Git Push。\n\n### 第 1 步：上传项目到 GitHub\n\nGitHub 仓库建议保持：\n\n```text\nusque-custom-pro\u002F\n├─ README.md\n├─ pages\u002F\n└─ workers\u002F\n```\n\n如果使用 GitHub Desktop：\n\n```text\n1. Add Local Repository\n2. 选择项目仓库目录\n3. Commit to main\n4. Publish repository \u002F Push origin\n```\n\n上传完成后 GitHub 首页应该能看到：\n\n```text\npages\u002F\nworkers\u002F\nREADME.md\n```\n\n---\n\n### 第 2 步：Cloudflare 创建 Pages\n\n进入 Cloudflare：\n\n```text\nWorkers & Pages\n→ Create application\n→ Pages\n→ Connect to Git\n```\n\n选择你的 GitHub 仓库。\n\n建议配置：\n\n```text\nProduction branch:\nmain\n\nFramework preset:\nNone\n\nRoot directory:\npages\n\nBuild command:\n留空\n\nBuild output directory:\n.\n```\n\n> Cloudflare 控制台不同版本的字段名称可能略有变化。核心原则是：**项目根目录必须指向 `pages\u002F`，最终发布目录必须让 `index.html` 与 `_worker.js` 位于发布根目录。**\n\n然后点击：\n\n```text\nSave and Deploy\n```\n\n---\n\n### 第 3 步：测试 Pages API\n\n部署完成后会获得：\n\n```text\nhttps:\u002F\u002F你的项目.pages.dev\n```\n\n先测试首页。\n\n然后打开：\n\n```text\nhttps:\u002F\u002F你的项目.pages.dev\u002Fapi\u002Fhealth\n```\n\n正常应返回：\n\n```json\n{\n  \"ok\": true,\n  \"service\": \"usque-register-relay\",\n  \"worker\": \"running\"\n}\n```\n\n如果 `\u002Fapi\u002Fhealth` 正常，说明：\n\n```text\n静态页面 ✅\n_worker.js ✅\n_routes.json ✅\nAPI 路由 ✅\n```\n\n---\n\n## 方法 B：Pages 直接上传\n\n如果不想连接 GitHub，可以使用 Pages 直接上传。\n\n只上传 `pages\u002F` 目录中的内容。\n\n最终发布根目录必须直接看到：\n\n```text\nindex.html\napp.js\nstyle.css\nusque-register.js\n_worker.js\n_routes.json\n_headers\nwarp-egress-selector.py\n```\n\n不要上传成：\n\n```text\n\u002Fpages\u002Findex.html\n```\n\n否则首页路径会错误。\n\n---\n\n# 部署方式二：Cloudflare Workers\n\nv6.7 同时提供完整 Workers Static Assets 版本。\n\n进入：\n\n```text\nworkers\u002F\n```\n\n---\n\n## Windows 一键部署\n\n### 第 1 步：安装 Node.js\n\n电脑需要安装 Node.js LTS。\n\n安装完成后重新打开终端或资源管理器。\n\n### 第 2 步：运行部署脚本\n\n双击：\n\n```text\ndeploy-windows.bat\n```\n\n脚本会依次运行：\n\n```bash\nnpm install\nnpx wrangler login\nnpx wrangler deploy\n```\n\n第一次会打开浏览器要求授权 Cloudflare。\n\n部署完成后 Wrangler 会显示类似：\n\n```text\nhttps:\u002F\u002Fusque-masque-pro-v67.xxxxx.workers.dev\n```\n\n---\n\n## Linux \u002F macOS\n\n进入 `workers\u002F`：\n\n```bash\nchmod +x deploy-linux-macos.sh\n.\u002Fdeploy-linux-macos.sh\n```\n\n或者手动：\n\n```bash\nnpm install\nnpx wrangler login\nnpx wrangler deploy\n```\n\n---\n\n## Workers 本地预览\n\n```bash\nnpm install\nnpx wrangler dev\n```\n\n然后打开 Wrangler 输出的本地地址。\n\n---\n\n## Workers 部署后测试\n\n首页：\n\n```text\nhttps:\u002F\u002F你的项目.workers.dev\u002F\n```\n\nAPI：\n\n```text\nhttps:\u002F\u002F你的项目.workers.dev\u002Fapi\u002Fhealth\n```\n\n正常返回：\n\n```json\n{\n  \"ok\": true,\n  \"service\": \"usque-register-relay\",\n  \"worker\": \"running\"\n}\n```\n\n---\n\n# 首次使用教程\n\n## 第 1 步：打开项目网页\n\n访问：\n\n```text\nhttps:\u002F\u002F你的项目.pages.dev\n```\n\n或：\n\n```text\nhttps:\u002F\u002F你的项目.workers.dev\n```\n\n---\n\n## 第 2 步：一键注册\n\n点击网页上的 Usque \u002F WARP 注册按钮。\n\n注册过程通常包括：\n\n```text\n1. 创建 WARP 设备\n2. 浏览器生成 P-256 MASQUE 密钥\n3. Enroll MASQUE 公钥\n4. 生成原生 config.json\n```\n\n注册成功后建议第一时间下载：\n\n```text\nusque-config.json\n```\n\n这是以后重复使用的核心文件。\n\n---\n\n## 第 3 步：妥善保存 config.json\n\n建议保存在：\n\n```text\n本机私人文件夹\n加密备份\n私人云盘\n```\n\n不要上传到：\n\n```text\nGitHub 公共仓库\n公开网盘链接\nTelegram \u002F Discord 公共频道\n论坛\n视频简介\n```\n\n因为里面包含：\n\n```text\nprivate_key\naccess_token\n设备 id\nWARP 账户相关凭据\n```\n\n---\n\n## 第 4 步：以后直接导入\n\n以后再打开网页，不需要重新注册。\n\n直接：\n\n```text\n导入 config.json\n→ 修改设置\n→ 应用设置并重新生成\n```\n\n即可。\n\n---\n\n# Clash \u002F Mihomo 使用教程\n\n这是本项目最推荐的使用方式。\n\n## 推荐新手设置\n\n第一次建议：\n\n```text\n节点数量：13 或 32\n网络 \u002F 传输：QUIC \u002F H3\nEndpoint：IPv4 + IPv6 自动选择\nPort：推荐端口\nSNI：www.microsoft.com\nDNS：Cloudflare + Google IPv4 + IPv6\nMTU：1280\n规则模式：完整智能分流\n自动测速：开启\n策略组图标：开启\n节点自动去重：开启\n```\n\n然后点击：\n\n```text\n应用设置并重新生成\n```\n\n---\n\n## 生成 Clash 配置\n\n顶部选择：\n\n```text\nClash \u002F Mihomo\n```\n\n下载 YAML。\n\n---\n\n## 导入 Clash Verge Rev\n\nClash Verge Rev 中：\n\n```text\n订阅 \u002F 配置\n→ 导入本地配置\n→ 选择生成的 YAML\n→ 启用配置\n```\n\n然后进入：\n\n```text\n代理\n```\n\n应该可以看到：\n\n```text\n地区优选\n自动选择\nAI自动选择\nPROXY\nAI\nYouTube\nEmby\nTikTok\nNetflix\nDisney\n...\n```\n\n其中每个主要服务组都可以展开查看原始 MASQUE 节点。\n\n---\n\n## 自动测速\n\n`自动选择` 使用 `url-test` 对节点做延迟筛选。\n\n推荐日常使用：\n\n```text\nPROXY → 自动选择\nYouTube → 自动选择\nNetflix → 自动选择\nTelegram → 自动选择\n```\n\n如果某个服务无法访问，可以进入对应策略组手动切换节点测试。\n\n---\n\n# ChatGPT \u002F OpenAI 简单模式\n\nv6.7 默认推荐：\n\n```text\nChatGPT \u002F OpenAI 出口 → DIRECT\n```\n\n规则会把关键 OpenAI 域名单独处理，例如：\n\n```text\nchatgpt.com\nopenai.com\noaistatic.com\noaiusercontent.com\noaistatsig.com\nopenaimerge.com\nworkos.com\nworkoscdn.com\nchallenges.cloudflare.com\n```\n\n这样：\n\n```text\nChatGPT \u002F OpenAI → DIRECT\nYouTube \u002F Netflix \u002F Telegram \u002F 其它国外流量 → WARP\n```\n\n适合本地网络本身能够访问 ChatGPT，但共享 WARP 出口被拒绝的情况。\n\n---\n\n## DIRECT 仍打不开怎么办？\n\n可以把：\n\n```text\nChatGPT \u002F OpenAI 出口\n```\n\n依次尝试：\n\n```text\nAI 自动选择\n地区优选\nPROXY\nAI 策略组\n```\n\n如果 WARP 页面显示：\n\n```text\nUnable to load site\nIf you are using a VPN, try turning it off.\n```\n\n通常说明当前 WARP 出口并不适合 ChatGPT。\n\n增加 MASQUE 节点数量不一定能解决，因为多个入口可能仍然对应同一类 WARP 出口。\n\n---\n\n# 节点数量与 H2 扩展池\n\n## 为什么选择 64 个，实际可能不足 64？\n\n节点生成会自动去重。\n\n例如：\n\n```text\n7 个 Endpoint × 7 个 Port = 49 个唯一组合\n```\n\n那么即使目标选择：\n\n```text\n64\n```\n\n也不会复制相同的 `Endpoint:Port` 来伪造 64 个节点。\n\n网页会提示：\n\n```text\n唯一组合不足\n```\n\n---\n\n## 想要 100～500 节点\n\n建议：\n\n```text\n网络 \u002F 传输：H2 \u002F TCP\nH2 扩展地址池：开启\nPort：全部常用\n节点数量：100 \u002F 200 \u002F 500\n```\n\nH2 模式会从扩展 IPv4 地址池生成更多唯一候选组合。\n\n> 大量节点主要适合测速筛选。500 个候选节点会增加 Clash 启动、测速、UI 渲染和规则组展开的压力，日常使用通常 13～64 个已经足够。\n\n---\n\n# 其它输出格式\n\n## 原生 Usque\n\n下载：\n\n```text\nusque-config.json\n```\n\nWindows 运行 Usque SOCKS 示例：\n\n```bash\nusque.exe -c usque-config.json socks -b 127.0.0.1 -p 1080\n```\n\n---\n\n## sing-box\n\n项目生成的 sing-box 配置使用：\n\n```text\nsing-box\n   ↓\n127.0.0.1:1080 SOCKS\n   ↓\nUsque\n   ↓\nWARP MASQUE\n```\n\n因此先启动 Usque：\n\n```bash\nusque.exe -c usque-config.json socks -b 127.0.0.1 -p 1080\n```\n\n然后：\n\n```bash\nsing-box run -c sing-box-usque.json\n```\n\n---\n\n## VLESS 本地桥接\n\n请特别注意：\n\n```text\nCloudflare MASQUE ≠ VLESS\n```\n\n项目不会伪造一个远程 Cloudflare VLESS 服务器。\n\n生成的是：\n\n```text\nVLESS 127.0.0.1:2081\n        ↓\nsing-box 本地 VLESS inbound\n        ↓\nSOCKS 127.0.0.1:1080\n        ↓\nUsque\n        ↓\nWARP MASQUE\n```\n\n所以生成的 VLESS 链接地址是：\n\n```text\n127.0.0.1:2081\n```\n\n它只能在本机使用。\n\n如果直接导入 v2rayN 而没有启动桥接服务，测速会显示：\n\n```text\n-1\n```\n\n这是正常的。\n\nWindows 最简单方式：\n\n```text\n1. 下载 usque-config.json\n2. 下载 usque-vless-bridge.json\n3. 下载 Windows 一键启动 BAT\n4. 把 usque.exe 与 sing-box.exe 放在同一目录\n5. 双击 BAT\n6. 再在 v2rayN 测试 127.0.0.1:2081\n```\n\n---\n\n## Shadowrocket\n\n选择：\n\n```text\nShadowrocket\n```\n\n生成适用于支持 MASQUE 配置的客户端格式。\n\n如果客户端版本不识别相关字段，请优先使用 Clash\u002FMihomo，或确认客户端本身是否支持当前 MASQUE 配置。\n\n---\n\n# WARP 出口国家检测（高级）\n\n这个功能不是使用项目的必要条件。\n\n默认建议保持折叠。\n\n如果确实需要检查不同 MASQUE 节点实际对应的 WARP 出口，可以使用：\n\n```text\nwarp-egress-selector.py\n```\n\n网页还可以下载：\n\n```text\nWindows 一键检测 BAT\n出口偏好 JSON\n```\n\n---\n\n## 使用条件\n\n需要：\n\n```text\nClash \u002F Mihomo 已运行\nPython 3\nMihomo Controller API 可访问\nMixed Proxy 可访问\n```\n\n默认：\n\n```text\nController:\nhttp:\u002F\u002F127.0.0.1:9090\n\nMixed Proxy:\nhttp:\u002F\u002F127.0.0.1:7890\n```\n\n如果 Clash Verge 使用不同端口或 Secret，需要在网页里改成实际值。\n\n---\n\n## 检测流程\n\n```text\n隐藏“出口检测”策略组\n        ↓\n脚本逐个切换 MASQUE 节点\n        ↓\n通过本地代理查询真实出口\n        ↓\n记录 IP \u002F 国家 \u002F 地区 \u002F 城市 \u002F PoP\n        ↓\n测试 ChatGPT HTTP 可达性\n        ↓\n按偏好与延迟排序\n        ↓\n设置“地区优选”节点\n```\n\n结果会输出：\n\n```text\nwarp-egress-report-时间.json\nwarp-egress-report-时间.csv\n```\n\n---\n\n# 升级项目\n\n如果通过 GitHub + Pages 部署，升级最方便。\n\n例如以后发布 v6.8：\n\n```text\n1. 下载新版本\n2. 覆盖本地 pages\u002F 与 workers\u002F\n3. 打开 GitHub Desktop\n4. 填写 Summary\n5. Commit to main\n6. Push origin\n```\n\nCloudflare Pages 如果已经绑定 GitHub，会自动重新部署。\n\n---\n\n# 常见问题\n\n## 1. `\u002Fapi\u002Fhealth` 打不开\n\n先检查部署结构。\n\nPages 根目录必须包含：\n\n```text\n_worker.js\n_routes.json\nindex.html\n```\n\n测试：\n\n```text\n\u002Fapi\u002Fhealth\n```\n\n如果首页正常、API 404，通常是 Worker \u002F 路由文件没有部署到正确根目录。\n\n---\n\n## 2. 注册提示 1015 \u002F 429\n\n这是 Cloudflare WARP 注册接口限流。\n\n项目会显示等待时间。\n\n不要连续点击注册。\n\n建议：\n\n```text\n等待倒计时结束\n再尝试一次\n```\n\n已经保存 `config.json` 的用户无需重新注册。\n\n---\n\n## 3. Clash 显示节点，但全部失败\n\n依次检查：\n\n```text\n网络 \u002F 传输模式\nEndpoint\nPort\nIPv4 \u002F IPv6 可达性\nUDP 是否可用\n运营商是否限制 QUIC\n```\n\n如果 QUIC 全部失败，可以尝试：\n\n```text\nH2 \u002F TCP\n```\n\n---\n\n## 4. 为什么节点很多，但出口 IP 一样？\n\n因为：\n\n```text\nMASQUE 节点 = Cloudflare 入口候选\nWARP IP      = 最终出口\n```\n\n不同入口可以最终使用相同或相近的 WARP 出口。\n\n这是正常现象。\n\n---\n\n## 5. ChatGPT 还是无法访问\n\n先把：\n\n```text\nChatGPT \u002F OpenAI 出口 → DIRECT\n```\n\n然后重新打开浏览器测试。\n\n如果 DIRECT 正常，而 WARP 不正常，说明当前问题主要在 WARP 出口。\n\n此时无需继续增加 100 \u002F 500 个 MASQUE 节点。\n\n---\n\n## 6. VLESS 为什么是 `127.0.0.1`？\n\n因为这是本地协议桥接，不是远程 VLESS。\n\n必须同时运行：\n\n```text\nUsque SOCKS 127.0.0.1:1080\nsing-box VLESS 127.0.0.1:2081\n```\n\n否则 v2rayN 会显示 `-1`。\n\n---\n\n## 7. 为什么分流组节点很多？\n\nv6.7 会把原始 MASQUE 节点加入主要服务策略组，方便：\n\n```text\n自动测速\n手动切换\n排查单个服务可达性\n```\n\n如果生成 64 个节点，每个服务组可能出现六十多个选项，这是预期行为。\n\n---\n\n## 8. 500 节点是不是速度更快？\n\n不是。\n\n500 节点只是更多候选入口。\n\n它可能帮助找到：\n\n```text\n更低延迟\n更稳定端口\n更适合当前网络的 Cloudflare 入口\n```\n\n但也会增加：\n\n```text\n测速时间\nClash 内存占用\nUI 渲染压力\n配置体积\n```\n\n日常更推荐：\n\n```text\n13 \u002F 32 \u002F 64\n```\n\n---\n\n# 安全与隐私\n\n项目采用以下原则：\n\n## 私钥本地生成\n\nMASQUE P-256 私钥由浏览器 WebCrypto 本地生成。\n\n---\n\n## 固定上游\n\nWorker 只用于项目需要的 WARP 注册接口，不作为通用代理。\n\n---\n\n## Same-Origin 检查\n\nAPI 会检查来源，拒绝明显跨站请求。\n\n---\n\n## 请求体限制\n\nAPI 对 JSON 大小和字段格式进行校验。\n\n---\n\n## 不使用数据库保存凭据\n\n默认不使用：\n\n```text\nKV\nD1\nR2\nlocalStorage\nsessionStorage\n```\n\n保存 Usque 私钥或账户凭据。\n\n---\n\n## 仍然需要你自己保护 config.json\n\n下载到本机后的：\n\n```text\nusque-config.json\n```\n\n由你自行保管。\n\n建议把以下内容加入 `.gitignore`：\n\n```gitignore\nnode_modules\u002F\n.wrangler\u002F\n.dev.vars\n.env\n*.log\n\nusque-config.json\nwarp-egress-report-*.json\nwarp-egress-report-*.csv\n```\n\n---\n\n# 重要说明\n\n1. 本项目是 **WARP \u002F MASQUE 配置与客户端转换工具**，不是 VPN 服务提供商。\n2. Endpoint 数量增加不等于拥有更多独立 WARP 账户或独立出口。\n3. 普通 WARP 无法通过本项目保证指定最终出口国家。\n4. 流媒体、AI、网站可达性会受到出口 IP、地区、运营商、服务商策略等影响，不能保证永久解锁。\n5. H2 扩展池中的大量地址是候选连接，需要实际测速，不代表全部可用。\n6. VLESS 输出属于 **本地桥接**，不是把 MASQUE 直接转换成远程 VLESS 服务器。\n7. 请遵守所在地法律法规、Cloudflare 服务条款及所访问服务的使用规则。\n\n---\n\n# 推荐配置速查\n\n## 新手日常使用\n\n```text\n节点：13 \u002F 32\n传输：QUIC \u002F H3\n规则：完整智能分流\n自动测速：开\nChatGPT：DIRECT\n```\n\n## 想多测速一些入口\n\n```text\n节点：64\n传输：QUIC \u002F H3\n端口：全部常用\n自动测速：开\n```\n\n## 想生成 100～500 个候选\n\n```text\n传输：H2 \u002F TCP\nH2 扩展池：开\n节点：100 \u002F 200 \u002F 500\n用途：批量测速筛选\n```\n\n## ChatGPT 无法访问\n\n```text\n第一选择：ChatGPT → DIRECT\n第二选择：AI 自动选择\n第三选择：高级 WARP 出口检测\n```\n\n---\n\n# 一句话使用流程\n\n```text\n部署 Pages \u002F Workers\n      ↓\n首次注册并保存 config.json\n      ↓\n以后直接导入 config.json\n      ↓\n设置节点 \u002F SNI \u002F DNS \u002F 分流\n      ↓\n生成 Clash \u002F Mihomo\n      ↓\n导入客户端\n      ↓\n自动测速并使用\n```\n\n---\n\n**Usque MASQUE Pro v6.7** 重点是把注册、保存、配置、转换、分流和部署整合在一个页面中；第一次完成部署和注册后，后续绝大多数操作都只需要“导入 `config.json` → 调整设置 → 重新生成”。\n","Usque MASQUE Pro 是一个基于浏览器的可视化工具，用于简化 Cloudflare WARP 与 MASQUE 协议的注册、配置管理及多客户端适配流程。它支持一键完成 WARP 设备注册与 MASQUE 密钥生成，以原生 config.json 为唯一配置源，提供多节点批量生成（含 H2\u002FQUIC\u002FH3 模式）、Clash\u002FMihomo 智能分流规则（集成 MetaCubeX MRS）、Shadowrocket\u002Fsing-box\u002FVLESS 等主流客户端格式转换，以及可选的 WARP 出口 IP 与国家检测功能。项目采用 Cloudflare Pages + Workers 无服务部署，全程在浏览器端运行，无需本地安装或暴露敏感凭证，适用于需要快速部署、批量测试 MASQUE 节点或规避手动配置 YAML\u002FJSON 的网络代理用户。",2,"2026-09-05 02:30:09","CREATED_QUERY"]