{"id":30936129,"url":"https://github.com/cmliu/cf-workers-bpsub","last_synced_at":"2025-09-15T21:09:32.809Z","repository":{"id":313973769,"uuid":"1053164151","full_name":"cmliu/CF-Workers-BPSUB","owner":"cmliu","description":"适配白嫖哥的自定义订阅生成器","archived":false,"fork":false,"pushed_at":"2025-09-09T22:27:20.000Z","size":147,"stargazers_count":30,"open_issues_count":0,"forks_count":23,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-09T22:32:14.037Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://BP.SUB.CMLiussss.net","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cmliu.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-09T04:42:47.000Z","updated_at":"2025-09-09T22:29:54.000Z","dependencies_parsed_at":"2025-09-09T22:32:16.502Z","dependency_job_id":"a60438c4-99af-4934-89fe-ad1d7b9b6f1c","html_url":"https://github.com/cmliu/CF-Workers-BPSUB","commit_stats":null,"previous_names":["cmliu/cf-workers-bpsub"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/cmliu/CF-Workers-BPSUB","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cmliu%2FCF-Workers-BPSUB","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cmliu%2FCF-Workers-BPSUB/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cmliu%2FCF-Workers-BPSUB/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cmliu%2FCF-Workers-BPSUB/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cmliu","download_url":"https://codeload.github.com/cmliu/CF-Workers-BPSUB/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cmliu%2FCF-Workers-BPSUB/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274490559,"owners_count":25295111,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-10T02:00:12.551Z","response_time":83,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-09-10T16:49:18.743Z","updated_at":"2025-09-15T21:09:31.014Z","avatar_url":"https://github.com/cmliu.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🚀 CF-Workers-BPSUB\n[![Cloudflare Workers](https://img.shields.io/badge/Cloudflare-Workers-orange)](https://workers.cloudflare.com/)\n[![Telegram](https://img.shields.io/badge/Telegram-@bestip_one-blue)](https://t.me/bestip_one)\n\n\u003e **一个运行在 Cloudflare Workers 上的智能 VLESS 订阅生成器，专为白嫖哥节点服务优化**\n\n## ✨ 项目简介\n\nCF-Workers-BPSUB 是一个基于 Cloudflare Workers 的轻量级 VLESS 代理订阅生成器。它能够：\n\n- 🌐 **智能节点管理**：自动获取白嫖哥提供的高质量节点\n- 🔄 **多格式支持**：支持生成 Clash、SingBox、V2Ray 等多种客户端格式\n- 📱 **用户友好**：提供美观的 Web 界面和二维码分享功能  \n- ⚡ **高性能**：基于 Cloudflare 全球 CDN，响应速度极快\n- 🛡️ **安全稳定**：支持 TLS 加密和多种传输协议\n\n## 🎯 核心功能\n\n### 订阅生成\n- **智能优选IP**：支持自定义优选IP列表，提升连接质量\n- **批量节点**：一键获取多个高质量节点\n- **格式转换**：自动适配不同客户端的订阅格式\n\n### 高级配置\n- **代理IP设置**：自定义代理IP，优化网络路径\n- **订阅转换**：集成订阅转换服务，支持规则分流\n- **环境变量**：通过环境变量灵活配置各项参数\n\n### 用户体验\n- **响应式界面**：适配桌面和移动设备\n- **一键复制**：快速复制订阅链接\n- **二维码生成**：手机扫码快速导入\n\n## 🚀 快速开始\n\n### 1. 部署到 Cloudflare Workers\n1. 访问 [Cloudflare Workers 控制台](https://dash.cloudflare.com/workers)\n2. 创建新的 Worker\n3. 复制 `_worker.js` 中的代码到 Worker 编辑器\n4. 保存并部署\n\n### 2. 配置环境变量（可选）\n\n在 Cloudflare Workers 控制台的「设置」→「变量」中添加：\n\n| 变量名 | 说明 |  示例 |\n|--------|------|---------------|\n| `SUBAPI` | 订阅转换后端地址 | `SUBAPI.CMLiussss.net` |\n| `SUBCONFIG` | 订阅转换配置文件 | `https://example.com/config.ini` |\n| `PROXYIP` | 默认代理IP地址 |  `proxyip.fxxk.dedyn.io:443` |\n| `ADD` | 默认优选IP列表，多元素使用`换行`或`,`做间隔 | `1.1.1.1:443#CF`,`8.8.8.8:443#Google` |\n| `SUBNAME` | 订阅文件名称 |  `BPSUB` |\n| `PS` | 节点备注后缀 | `感谢白嫖哥` |\n\n## 📖 使用指南\n\n### 基础使用\n\n1. **访问 Web 界面**\n   ```\n   https://your-worker.your-subdomain.workers.dev/\n   ```\n\n2. **生成订阅链接**\n   - 在界面中配置优选IP列表\n   - 设置代理参数（可选）\n   - 点击「生成订阅链接」\n\n3. **导入客户端**\n   - 复制生成的订阅链接\n   - 在代理客户端中添加订阅\n   - 或扫描二维码快速导入\n\n### API 使用\n\n#### 获取订阅\n```bash\n# 基础订阅（Base64编码）\ncurl \"https://your-worker.workers.dev/sub\"\n\n# 自定义优选IP\ncurl \"https://your-worker.workers.dev/sub?ips=1.1.1.1:443#CF|8.8.8.8:443#Google\"\n\n# 设置代理IP  \ncurl \"https://your-worker.workers.dev/sub?proxyip=cdn.example.com:443\"\n\n# Clash 格式（需要 UA 包含 clash）\ncurl -H \"User-Agent: clash\" \"https://your-worker.workers.dev/sub\"\n```\n\n#### 获取节点数据\n```bash\n# 查看原始节点数据\ncurl \"https://your-worker.workers.dev/uuid.json\"\n```\n\n### 高级配置\n\n#### 优选IP格式\n```\n# 基本格式\n域名或IP:端口#备注\n\n# 示例\nvisa.cn#优选域名\n127.0.0.1:1234#本地测试  \n[2606:4700::]:2053#IPv6地址\n\n# API 格式（自动获取IP列表）\nhttps://example.com/api/ips.txt\n```\n\n#### SOCKS5 代理\n```bash\n# 单个节点使用 SOCKS5\ncurl \"https://your-worker.workers.dev/sub?socks5=127.0.0.1:1080\"\n\n# 全局 SOCKS5 代理\ncurl \"https://your-worker.workers.dev/sub?socks5=127.0.0.1:1080\u0026global=true\"\n```\n\n## 🛠️ 开发指南\n\n### 本地开发\n\n```bash\n# 安装依赖\nnpm install\n\n# 启动开发服务器\nnpm run dev\n\n# 本地访问\n# http://localhost:8787\n```\n\n### 项目结构\n\n```\nCF-Workers-BPSUB/\n├── _worker.js          # 主要业务逻辑\n├── package.json        # 项目配置和依赖\n├── wrangler.toml       # Wrangler 配置文件\n└── README.md          # 项目文档\n```\n\n### 核心模块\n\n- **订阅生成**：处理 VLESS 链接生成和格式转换\n- **节点获取**：从白嫖哥 API 获取可用节点信息\n- **优选IP处理**：解析和管理用户自定义的优选IP列表\n- **Web界面**：提供用户友好的配置和管理界面\n\n## 📋 客户端兼容性\n\n### 完全支持\n- ✅ **V2Ray** / V2RayN / V2RayNG\n- ✅ **Clash** / Clash for Windows / ClashX\n- ✅ **SingBox** / SFI\n- ✅ **Shadowrocket** (iOS)\n\n### 自动识别\n程序会根据客户端 User-Agent 自动选择最佳订阅格式：\n- `clash` → Clash 格式\n- `sing-box` → SingBox 格式  \n- `v2ray` → V2Ray 格式\n- 其他 → 自动检测\n\n## 🔧 故障排除\n\n### 常见问题\n\n**Q: 订阅链接无法访问？**\nA: 检查 Worker 域名是否正确，确认服务已成功部署\n\n**Q: 节点连接失败？**  \nA: 尝试更换优选IP，或检查本地网络环境\n\n**Q: 订阅转换失败？**\nA: 检查 `SUBAPI` 环境变量是否配置正确\n\n**Q: 如何自定义节点备注？**\nA: 设置 `PS` 环境变量，或在优选IP中使用 `#备注` 格式\n\n### 调试技巧\n\n1. **查看节点数据**：访问 `/uuid.json` 端点\n2. **检查环境变量**：在 Workers 控制台确认配置\n3. **使用开发模式**：`npm run dev` 本地调试\n\n## 🤝 贡献指南\n\n欢迎提交 Issue 和 Pull Request！\n\n1. Fork 本仓库\n2. 创建特性分支：`git checkout -b feature/amazing-feature`\n3. 提交更改：`git commit -m 'Add amazing feature'`\n4. 推送分支：`git push origin feature/amazing-feature`\n5. 提交 Pull Request\n\n## 📞 支持与反馈\n\n- 🐛 **Bug 报告**：[GitHub Issues](https://github.com/cmliu/CF-Workers-BPSUB/issues)\n- 💡 **功能建议**：[GitHub Discussions](https://github.com/cmliu/CF-Workers-BPSUB/discussions)  \n- 📢 **交流群组**：[白嫖哥频道](https://t.me/bestip_one)\n\n## 🙏 致谢\n\n- **Cloudflare Workers**：提供优秀的 Serverless 平台\n- **[白嫖哥](https://t.me/bestip_one)**：提供高质量的免费节点服务\n- [肥羊短链](https://suburl.v1.mk/)：感谢提供免费短链服务","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcmliu%2Fcf-workers-bpsub","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcmliu%2Fcf-workers-bpsub","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcmliu%2Fcf-workers-bpsub/lists"}