{"id":28714433,"url":"https://github.com/cmliu/cf-workers-checksocks5","last_synced_at":"2025-06-15T01:07:10.885Z","repository":{"id":295751562,"uuid":"989692648","full_name":"cmliu/CF-Workers-CheckSocks5","owner":"cmliu","description":"一个基于 Cloudflare Workers 的高性能代理检测服务，支持 SOCKS5 和 HTTP 代理的连通性测试和 IP 信息查询。","archived":false,"fork":false,"pushed_at":"2025-05-27T06:56:27.000Z","size":1457,"stargazers_count":11,"open_issues_count":0,"forks_count":5,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-05-27T07:44:08.719Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://Check.Socks5.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}},"created_at":"2025-05-24T16:19:21.000Z","updated_at":"2025-05-27T07:35:50.000Z","dependencies_parsed_at":"2025-05-27T07:54:11.306Z","dependency_job_id":null,"html_url":"https://github.com/cmliu/CF-Workers-CheckSocks5","commit_stats":null,"previous_names":["cmliu/cf-workers-checksocks5"],"tags_count":0,"template":true,"template_full_name":null,"purl":"pkg:github/cmliu/CF-Workers-CheckSocks5","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cmliu%2FCF-Workers-CheckSocks5","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cmliu%2FCF-Workers-CheckSocks5/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cmliu%2FCF-Workers-CheckSocks5/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cmliu%2FCF-Workers-CheckSocks5/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cmliu","download_url":"https://codeload.github.com/cmliu/CF-Workers-CheckSocks5/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cmliu%2FCF-Workers-CheckSocks5/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259906123,"owners_count":22929973,"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","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-06-15T01:07:09.976Z","updated_at":"2025-06-15T01:07:10.871Z","avatar_url":"https://github.com/cmliu.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# CF-Workers-CheckSocks5\n![demo](./demo.png)\n一个基于 Cloudflare Workers 的高性能代理检测服务，支持 SOCKS5 和 HTTP 代理的连通性测试和 IP 信息查询。\n\n## ✨ 功能特性\n\n- 🚀 **代理检测**：支持 SOCKS5 和 HTTP 代理的连通性测试\n- 🌍 **IP 信息查询**：获取 IP 地址的地理位置、ASN、风险评分等详细信息\n- 🔒 **安全认证**：支持用户名/密码认证的代理\n- 📱 **响应式界面**：现代化的 Web 界面，支持移动端访问\n- 🎯 **域名解析**：自动解析域名并支持多 IP 切换\n- ⚡ **高性能**：基于 Cloudflare Workers 边缘计算平台\n- 🔧 **易部署**：一键部署，无需服务器维护\n\n## 🏃 快速开始\n\n### 在线体验\n\n访问在线演示：[Demo](https://check.socks5.cmliussss.net)\n\n## 🚀 部署方式\n\n- **Workers** 部署：复制 [_worker.js](https://github.com/cmliu/CF-Workers-CheckSocks5/blob/main/_worker.js) 代码，`保存并部署`即可\n- **Pages** 部署：`Fork` 后 `连接GitHub` 一键部署即可\n\n## 🔧 环境变量配置\n\n在 Cloudflare Workers 控制台中设置以下环境变量：\n\n| 变量名 | 说明 | 示例 | 必需 |\n|--------|------|------|------|\n| `TOKEN` | API 访问令牌，用于保护接口（设置`TOKEN`之后，首页会变成**nginx**，避免变成公共服务） | `your-secret-token` | 否 |\n| `URL302` | 302跳转伪装首页 | `https://example.com` | 否 |\n| `URL` | 反向代理伪装首页 | `https://example.com` | 否 |\n| `ICO` | 网站图标 URL | `https://example.com/favicon.ico` | 否 |\n| `IMG` | 背景图片 URL，支持多个（用逗号分隔） | `https://example.com/bg.jpg` | 否 |\n| `BEIAN` | 网站备案信息 | `ICP备案号` | 否 |\n\n## 📖 API 文档\n\n### 代理检测接口\n\n**端点**：`/check`\n\n**请求方式**：`GET`\n\n**参数**：\n- `proxy`：代理 URL（支持 socks5:// 和 http:// 前缀）\n- `token`：访问令牌（如果设置了 TOKEN 环境变量）\n\n**代理 URL 格式**：\n```\n# SOCKS5 代理\nsocks5://username:password@host:port\nsocks5://host:port\n\n# HTTP 代理\nhttp://username:password@host:port\nhttp://host:port\n\n# IPv6 地址需要用方括号括起来\nsocks5://username:password@[2001:db8::1]:1080\n```\n\n**响应示例**：\n```json\n{\n    \"success\": true,\n    \"proxy\": \"socks5://username:password@host:port\",\n    \"ip\": \"8.8.8.8\",\n    \"rir\": \"APNIC\",\n    \"is_bogon\": false,\n    \"is_mobile\": false,\n    \"is_satellite\": false,\n    \"is_crawler\": false,\n    \"is_datacenter\": true,\n    \"is_tor\": false,\n    \"is_proxy\": false,\n    \"is_vpn\": true,\n    \"is_abuser\": false,\n    \"datacenter\": {\n        \"network\": \"8.213.144.0/20\",\n        \"datacenter\": \"alibaba\"\n    },\n    \"company\": {\n        \"name\": \"Alibabacom Singapore E-Commerce Private Limited a\",\n        \"abuser_score\": \"0.01 (Elevated)\",\n        \"domain\": \"alibabacloud.com\",\n        \"type\": \"hosting\",\n        \"network\": \"8.213.128.0 - 8.213.159.255\",\n        \"whois\": \"https://api.ipapi.is/?whois=8.213.128.0\"\n    },\n    \"abuse\": {\n        \"name\": \"ABUSE ASEPLSG\",\n        \"address\": \"1 Raffles Place # 59-00 One Raffles Place, Tower One Singapore, Singapore\",\n        \"email\": \"abuse@alibaba-inc.com\",\n        \"phone\": \"+000000000\"\n    },\n    \"asn\": {\n        \"asn\": 45102,\n        \"abuser_score\": \"0.0015 (Low)\",\n        \"route\": \"8.213.144.0/20\",\n        \"descr\": \"ALIBABA-CN-NET Alibaba US Technology Co., Ltd., CN\",\n        \"country\": \"cn\",\n        \"active\": true,\n        \"org\": \"Alibaba (US) Technology Co., Ltd.\",\n        \"domain\": \"alibaba.com\",\n        \"abuse\": \"didong.jc@alibaba-inc.com\",\n        \"type\": \"business\",\n        \"updated\": \"2021-10-27\",\n        \"rir\": \"APNIC\",\n        \"whois\": \"https://api.ipapi.is/?whois=AS45102\"\n    },\n    \"location\": {\n        \"is_eu_member\": false,\n        \"calling_code\": \"82\",\n        \"currency_code\": \"KRW\",\n        \"continent\": \"AS\",\n        \"country\": \"South Korea\",\n        \"country_code\": \"KR\",\n        \"state\": \"서울특별시\",\n        \"city\": \"Seoul\",\n        \"latitude\": 37.566,\n        \"longitude\": 126.9784,\n        \"zip\": \"04524\",\n        \"timezone\": \"Asia/Seoul\",\n        \"local_time\": \"2025-05-27T15:52:11+09:00\",\n        \"local_time_unix\": 1748328731,\n        \"is_dst\": false\n    },\n    \"elapsed_ms\": 1.07,\n    \"timestamp\": \"2025-05-27T06:52:11.856Z\"\n}\n```\n\n## 💡 使用示例\n\n### cURL 示例\n\n```bash\n# 检测 SOCKS5 代理\ncurl \"https://your-worker.workers.dev/check?proxy=socks5://user:pass@proxy.example.com:1080\"\n\n# 检测 HTTP 代理\ncurl \"https://your-worker.workers.dev/check?proxy=http://proxy.example.com:8080\"\n\n```\n\n## 🔍 字段说明\n\n### 风险评估字段\n\n- `is_datacenter`：是否为数据中心 IP\n- `is_proxy`：是否为代理服务器\n- `is_vpn`：是否为 VPN 服务器\n- `is_tor`：是否为 Tor 出口节点\n- `is_crawler`：是否为网络爬虫\n- `is_abuser`：是否有滥用行为记录\n- `abuser_score`：滥用风险评分（0-1，数值越高风险越大）\n\n### 地理位置字段\n\n- `country_code`：国家代码（ISO 3166-1 alpha-2）\n- `city`：城市名称\n\n### ASN 字段\n\n- `asn`：自治系统编号\n- `org`：所属组织/ISP 名称\n\n## 🛠️ 技术架构\n\n- **运行环境**：Cloudflare Workers\n- **网络协议**：支持 SOCKS5 和 HTTP CONNECT\n- **DNS 解析**：Cloudflare DNS over HTTPS\n- **IP 信息 API**：ipapi.is\n\n## 📄 许可证\n\n本项目采用 GNU General Public License v3.0 - 查看 [LICENSE](LICENSE) 文件了解详情\n\n## 🙏 致谢\n\n- [Cloudflare Workers](https://workers.cloudflare.com/) - 无服务器计算平台\n- [ipapi.is](https://ipapi.is/) - IP 地理位置查询服务\n- [Cloudflare DNS](https://cloudflare-dns.com/) - DNS over HTTPS 服务\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcmliu%2Fcf-workers-checksocks5","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcmliu%2Fcf-workers-checksocks5","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcmliu%2Fcf-workers-checksocks5/lists"}