diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..e87f24b --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,30 @@ +# Repository Guidelines + +## Project Structure & Module Organization +`main.go` starts Wails and embeds `frontend/dist`. Backend code lives in `internal/`; keep Wails-callable methods in `internal/app/app_*.go` and domain logic in packages such as `client`, `seckill`, `config`, `logger`, and `image`. The Vue 3/TypeScript UI is under `frontend/src`, organized into `components/`, `composables/`, `styles/`, and `utils/`. Go tests sit beside source as `*_test.go`. `docs/` and `work/` hold reference material; `build/`, `frontend/dist/`, and generated `frontend/wailsjs/` are ignored. + +## Build, Test, and Development Commands +- `./build.sh install`: install frontend dependencies. +- `./build.sh dev`: run the Wails app with frontend hot reload. +- `cd frontend && npm run type-check`: type-check Vue/TypeScript after `frontend/wailsjs/` exists. +- `go test ./internal/...`: run backend tests; the root package requires `frontend/dist` for embedding. +- `./build.sh build`: type-check and build the current platform into `build/bin/`. +- `./build.sh win|mac-arm|linux|release`: build target-specific releases. +- `./build.sh clean`: remove generated build artifacts. + +Use `gofmt` on changed Go files. There is no configured frontend linter. + +## Coding Style & Naming Conventions +Go follows standard `gofmt` style: tabs, short package names, `PascalCase` for exported identifiers, and `camelCase` for locals. Protect shared `App` state with the existing mutexes, and place frontend bindings method-by-domain in `app_*.go`. TypeScript/Vue uses two-space indentation, single quotes, and no semicolons. Use `PascalCase.vue` component filenames and `useX` names for composables. Prefer the configured `@/` and `@wails/` import aliases. Regenerate, but never edit or commit, generated `frontend/wailsjs/` bindings. + +## Testing Guidelines +Backend tests use Go's `testing` package and are named `TestBehavior`. Prefer table-driven cases plus `t.TempDir()` and `httptest` for filesystem and HTTP isolation. Add regression tests for retry, scheduling, config, and Wails method changes. No frontend unit test framework or coverage threshold is configured; run `go test ./internal/...` and the frontend type check before submitting. + +## Commit & Pull Request Guidelines +Most history uses concise Chinese descriptions; newer commits also use Conventional Commits prefixes. Prefer forms such as `feat(scope): summarize change`, `fix(scope): ...`, or `chore(version): ...`. Keep commits focused. Pull requests should explain behavior and risk, list verification commands, link related issues, and include screenshots for visible UI changes when available. + +## Configuration & Security +Runtime data, cookies, account files, logs, `config.json`, and fonts must remain untracked. Use `DOUYU_DATA_DIR`, `DOUYU_CONFIG`, `DOUYU_USERS`, `DOUYU_LOG_DIR`, and related environment variables for local overrides. + +## Agent-Specific Instructions +Do not launch browsers or browser automation for UI validation unless explicitly requested. Use type checks, builds, and existing tests. diff --git a/docs/品赞代理/API文档.md b/docs/品赞代理/API文档.md new file mode 100644 index 0000000..ff13c6e --- /dev/null +++ b/docs/品赞代理/API文档.md @@ -0,0 +1,275 @@ +# 品赞代理 API 文档 + +> 来源: +> 抓取日期:2026-11-19 + +## 接口概览 + +| 接口 | 请求地址 | 请求方法 | +| --- | --- | --- | +| 提取 IP | `https://service.ipzan.com/core-extract` | `GET` | +| 添加白名单 | `https://service.ipzan.com/whiteList-add` | `GET`、`POST` | +| 删除白名单 | `https://service.ipzan.com/whiteList-del` | `GET`、`DELETE` | +| 白名单列表 | `https://service.ipzan.com/whiteList-get` | `GET` | +| 校验白名单是否存在 | `https://service.ipzan.com/whiteList-verify` | `GET` | +| 余量、余额查询 | `https://service.ipzan.com/userProduct-get` | `GET` | + +## 提取 IP + +```http +GET https://service.ipzan.com/core-extract +``` + +### 请求参数 + +| 参数名称 | 含义 | 是否必填 | +| --- | --- | --- | +| `no` | 套餐购买编号 | 是 | +| `secret` | 提取的套餐密钥 | 是 | +| `num` | 提取数量 | 是 | +| `mode` | IP 授权方式,可选值为 `whitelist` 和 `auth`,分别为白名单授权方式或账号密码授权,默认 `whitelist` | 否 | +| `minute` | 占用时长,值为 `1`、`3`、`5`、`10`、`15`、`30` | 是(仅按量提取需要,包量不需要) | +| `format` | 返回格式,可选 `txt`、`json`。如果使用 `txt`,固定使用 `\r\n` 分割 | 否 | +| `area` | 提取的地区城市编码 | 否 | +| `net` | 代理 IP 网络:`1` 电信、`2` 移动、`3` 联通 | 否(默认随机) | +| `pool` | 提取的 IP 类型:优质 IP 为 `quality`,普通 IP 池为 `ordinary` | 是(除按量套餐需要传之外,其他套餐都不需要传,`pool` 会根据创建套餐时的选项为准) | +| `protocol` | 使用协议:`http`/`https` 为 `1`,`socket5` 为 `3` | 否(默认 `1`) | +| `intPort` | 端口类型统一为 int。不指定时仅返回 `port` 字段,`port` 为 int 和 string 混淆 | 否(默认 `0`) | +| `library` | 优先提取哪个库的 IP,可选 `1`、`2`、`3` | 否(默认 `0`) | + +### 响应 + +响应分两种情况。 + +#### `format` 为 `json` + +| 字段 | 含义 | +| --- | --- | +| `code`(number) | 如果提取到了 IP,则为 `0`,否则均为 `-1`。判断是否提取到 IP 示例:`if (code === 0)` | +| `status`(number) | 请求状态,成功为 `200`,但并不代表获取 IP 成功;是否获得 IP 请使用 `code` 判断 | +| `data`(object) | 响应结果。如果提取到了 IP,其中会包含 `list` 属性,为提取到的 IP 列表 | +| `message`(string) | 如果未成功获取到 IP,则为提示信息。客户端常见提示:`"secret密匙错误"`、`"套餐余量不足"`、`"套餐已过期"`、`"套餐被禁用"`、`"提取频率过快"`、`"余额不足"`、`"用户被禁用"`、`"身份未认证"`。判断余额是否不足示例:`if (message === '余额不足' && code === -1)` | + +#### `format` 为 `txt` + +如果成功提取到了 IP,会直接返回 IP 文本,IP 分隔符固定为 `"\r\n"`。 + +如果 `txt` 格式提取出现错误,会返回上述 JSON 格式。 + +## 添加白名单 + +```http +GET|POST https://service.ipzan.com/whiteList-add +``` + +### 请求参数 + +| 参数名称 | 含义 | 是否必填 | +| --- | --- | --- | +| `no` | 套餐购买编号 | 是 | +| `sign` | AES 加密签名,详见下方“签名算法” | 是 | +| `ip` | 需要添加的 IP。如果白名单数量超出,将会自动替换老的白名单 | 是 | +| `replace` | 如果白名单已满,是否替换(删除一个最早添加的,然后再添加当前的):`1` 是、`0` 否 | 否(默认 `0`) | + +### 签名算法 + +`sign` 的加密内容为 `"登录密码:套餐提取密匙:linux时间戳"`,三种信息使用英文冒号 `:` 连接,时间戳单位为秒,有效期为 24 小时。 + +AES 加密详细配置: + +- 加密模式:ECB +- 填充:pkcs7padding +- 数据块:128 位 +- 密钥:品赞的签名密钥,请在“控制台” > “控制台”中查看 +- 偏移量:空,不用填 +- 输出:hex +- 字符集:utf8 编码 / unicode 编码 + +Node.js 示例: + +```javascript +// 安装 crypto-js +const CryptoJS = require('crypto-js') + +// 加签的内容 +const data = `登录密码:套餐提取密匙:${Date.now() / 1000}` + +// 解析签名密钥,密钥请在 "控制台" > "控制台" 中查看 +const key = CryptoJS.enc.Utf8.parse(签名密匙) + +// 进行签名 +const encryptedData = CryptoJS.AES.encrypt(data, key, { + mode: CryptoJS.mode.ECB, + padding: CryptoJS.pad.Pkcs7, +}) + +// 获得签名好的字符串,在请求添加白名单 API 时上传 +const sign = encryptedData.ciphertext.toString() + +// 添加白名单 +axios({ + method: 'POST', + url: 'https://service.ipzan.com/whiteList-add', + data: { + no: 'xxxxxxxxxxx', + ip: 'xxx.xxx.xxx.xxx', + sign: sign, + }, +}) +``` + +其他语言: + +- [Python AES](https://blog.csdn.net/chouzhou9701/article/details/122019967) +- [JAVA AES](https://www.jianshu.com/p/7f17792609cc) +- [PHP AES](https://blog.csdn.net/fangkang7/article/details/94607123) +- [AES 在线加密解密测试](http://tool.chacuo.net/cryptaes) + +### 请求示例 + +```http +GET https://service.ipzan.com/whiteList-add?no=xxxxx&sign=xxxxx&ip=xxxxx +``` + +### 响应 + +```text +{"code": xxx,"data":xxx,"status":200,"message":"xxxx"} +``` + +其中 `code` 为数字 `0` 表示操作成功。 + +## 删除白名单 + +```http +GET|DELETE https://service.ipzan.com/whiteList-del +``` + +### 请求参数 + +| 参数名称 | 含义 | 是否必填 | +| --- | --- | --- | +| `ip` | 需要添加的 IP | 是 | +| `userId` | 用户 ID | 是 | +| `no` | 套餐 no。仅删除当前套餐下的此白名单;如果未填,将删除当前 `userId` 下面所有等于 `ip` 的白名单 | 否 | + +### 请求示例 + +```http +GET https://service.ipzan.com/whiteList-del?no=xxxxx&userId=xxxxx&ip=xxxxx +``` + +### 响应 + +```text +{"code": xxx,"data":xxx,"status":200,"message":"xxxx"} +``` + +其中 `code` 为数字 `0` 表示操作成功。 + +## 白名单列表 + +```http +GET https://service.ipzan.com/whiteList-get +``` + +### 请求参数 + +| 参数名称 | 含义 | 是否必填 | +| --- | --- | --- | +| `no` | 套餐购买编号 | 是 | +| `userId` | 用户 ID | 是 | + +### 返回字段 + +| 字段 | 含义 | +| --- | --- | +| `id` | 即 IP | +| `user_id` | 当前用户 | +| `no` | 当前套餐 | +| `time` | 添加时间 | + +所有字段均会存在。 + +### 请求示例 + +```http +GET https://service.ipzan.com/whiteList-get?no=xxxxx&userId=xxxxx +``` + +### 响应 + +```text +{"code": xxx,"data":xxx,"status":200,"message":"xxxx"} +``` + +其中 `code` 为数字 `0` 表示操作成功。 + +## 校验白名单是否存在 + +```http +GET https://service.ipzan.com/whiteList-verify +``` + +### 请求参数 + +| 参数名称 | 含义 | 是否必填 | +| --- | --- | --- | +| `ip` | IP 白名单 | 是 | +| `no` | 套餐购买编号 | 是 | + +### 返回字段 + +- `false`:不存在 +- `true`:已存在 + +### 请求示例 + +```http +GET https://service.ipzan.com/whiteList-verify?no=xxxxx&ip=xxxxx +``` + +### 响应 + +```text +{"code": xxx,"data":xxx,"status":200,"message":"xxxx"} +``` + +其中 `code` 为数字 `0` 表示操作成功。 + +## 余量、余额查询 + +```http +GET https://service.ipzan.com/userProduct-get +``` + +### 请求参数 + +| 参数名称 | 含义 | 是否必填 | +| --- | --- | --- | +| `no` | 套餐购买编号 | 是 | +| `userId` | 用户 ID | 是 | + +### 返回字段 + +| 字段 | 含义 | +| --- | --- | +| `balance` | 钱包余额 | +| `limitDaySurplus` | 包时长套餐今天余量 | +| `totalSurplus` | 包总量套餐当前余量 | + +不会每个字段都存在,具体根据当前查询的套餐类型决定。 + +### 请求示例 + +```http +GET https://service.ipzan.com/userProduct-get?no=xxxxx&userId=xxxxx +``` + +### 响应 + +```text +{"code": xxx,"data":xxx,"status":200,"message":"xxxx"} +``` + +其中 `code` 为数字 `0` 表示操作成功。 diff --git a/docs/品赞代理/IP检测与安全.md b/docs/品赞代理/IP检测与安全.md new file mode 100644 index 0000000..c0bf2a7 --- /dev/null +++ b/docs/品赞代理/IP检测与安全.md @@ -0,0 +1,80 @@ +# 品赞代理 IP 检测与安全 + +> 来源: +> +> +> 抓取日期:2026-11-19 +> 页面截图已保存到 `assets/常见问题/`。 + +## IP 检测 + +### 使用系统工具检测 + +不借助其他工具,可以使用系统命令行的 `curl` 命令检测代理 IP。打开终端后,按下方格式输入命令并回车即可查看结果。 + +#### 如何打开终端 + +- Windows 用户请按 `Win + R` 键,再输入 `cmd` 并回车。 +- macOS 用户请在“应用程序” > “实用工具”中打开终端。 + +### 白名单方式 + +在终端输入以下格式的命令: + +```bash +curl --proxy IP:端口 http://www.baidu.com +``` + +例如: + +```bash +curl --proxy 222.111.66.11:8080 "http://www.baidu.com" +``` + +### 账号密码方式 + +在终端输入以下格式的命令: + +```bash +curl --proxy 账号:密码@IP:端口 http://www.baidu.com +``` + +例如: + +```bash +curl --proxy addfsa:232322222@222.111.66.11:8080 "http://www.baidu.com" +``` + +如果使用 SOCKS5,将命令中的 `--proxy` 换成 `--socks5`。 + +如果出现下图内容,则表示代理 IP 配置成功。命令中的 `http://www.baidu.com` 可以换成您想访问的任意地址。 + +![curl 检测示例](assets/常见问题/04-curl检测示例.png) + +## IP 被盗用 + +如果您的 IP 出现被盗用的嫌疑,请按照以下步骤进行设置。 + +### 1. 开启 IP 提取控制并关闭自动加白名单 + +请在“个人中心” > “账号安全”板块中开启“IP 提取控制”,并关闭“自动加白名单”功能。 + +![IP 提取控制设置](assets/常见问题/01-IP提取控制设置.jpg) + +### 2. 重置套餐提取密钥 + +请在套餐管理页面中找到对应的套餐,并重置提取密钥。 + +![重置套餐提取密钥](assets/常见问题/02-重置套餐提取密钥.jpg) + +### 3. 检查白名单 + +检查使用中套餐的白名单。如果发现未知的白名单,请将其删除。 + +![检查白名单](assets/常见问题/03-检查白名单.jpg) + +### 4. 修改账号密码 + +这是可选操作。请修改品赞的账号密码。 + +> 品赞不会泄露任何用户的任何信息。请各位用户保管好自己的账号信息,请勿轻易在 QQ、微信、不知名网页和软件中泄露自己的提取 API、添加白名单等链接,以免 IP 被盗用。 diff --git a/docs/品赞代理/README.md b/docs/品赞代理/README.md new file mode 100644 index 0000000..f054a2f --- /dev/null +++ b/docs/品赞代理/README.md @@ -0,0 +1,19 @@ +# 品赞代理文档 + +> 来源: +> 抓取日期:2026-11-19 + +## 文档目录 + +- [API 文档](API文档.md) +- [使用教程](使用教程.md) +- [代码示例](代码示例.md) +- [IP 检测与安全](IP检测与安全.md) +- [使用协议](使用协议.md) +- [免责声明](免责声明.md) + +## 本地资源 + +- `assets/使用教程/`:使用教程操作截图 +- `assets/常见问题/`:IP 检测和 IP 被盗用处理截图 +- `assets/代码示例/`:易语言示例压缩包 diff --git a/docs/品赞代理/assets/代码示例/易语言示例.rar b/docs/品赞代理/assets/代码示例/易语言示例.rar new file mode 100644 index 0000000..193636f Binary files /dev/null and b/docs/品赞代理/assets/代码示例/易语言示例.rar differ diff --git a/docs/品赞代理/assets/使用教程/01-注册登录页面.png b/docs/品赞代理/assets/使用教程/01-注册登录页面.png new file mode 100644 index 0000000..23e96d5 Binary files /dev/null and b/docs/品赞代理/assets/使用教程/01-注册登录页面.png differ diff --git a/docs/品赞代理/assets/使用教程/02-注册登录表单.png b/docs/品赞代理/assets/使用教程/02-注册登录表单.png new file mode 100644 index 0000000..3b9476c Binary files /dev/null and b/docs/品赞代理/assets/使用教程/02-注册登录表单.png differ diff --git a/docs/品赞代理/assets/使用教程/03-实名认证入口.png b/docs/品赞代理/assets/使用教程/03-实名认证入口.png new file mode 100644 index 0000000..fd9fed4 Binary files /dev/null and b/docs/品赞代理/assets/使用教程/03-实名认证入口.png differ diff --git a/docs/品赞代理/assets/使用教程/04-实名认证页面.png b/docs/品赞代理/assets/使用教程/04-实名认证页面.png new file mode 100644 index 0000000..820695e Binary files /dev/null and b/docs/品赞代理/assets/使用教程/04-实名认证页面.png differ diff --git a/docs/品赞代理/assets/使用教程/05-套餐购买入口.jpg b/docs/品赞代理/assets/使用教程/05-套餐购买入口.jpg new file mode 100644 index 0000000..9c32ea2 Binary files /dev/null and b/docs/品赞代理/assets/使用教程/05-套餐购买入口.jpg differ diff --git a/docs/品赞代理/assets/使用教程/06-包时长套餐购买.jpeg b/docs/品赞代理/assets/使用教程/06-包时长套餐购买.jpeg new file mode 100644 index 0000000..c7d36fb Binary files /dev/null and b/docs/品赞代理/assets/使用教程/06-包时长套餐购买.jpeg differ diff --git a/docs/品赞代理/assets/使用教程/07-包总量套餐购买.jpeg b/docs/品赞代理/assets/使用教程/07-包总量套餐购买.jpeg new file mode 100644 index 0000000..f597a9f Binary files /dev/null and b/docs/品赞代理/assets/使用教程/07-包总量套餐购买.jpeg differ diff --git a/docs/品赞代理/assets/使用教程/08-金币充值.jpeg b/docs/品赞代理/assets/使用教程/08-金币充值.jpeg new file mode 100644 index 0000000..3eb7fa5 Binary files /dev/null and b/docs/品赞代理/assets/使用教程/08-金币充值.jpeg differ diff --git a/docs/品赞代理/assets/使用教程/09-已购套餐列表.jpeg b/docs/品赞代理/assets/使用教程/09-已购套餐列表.jpeg new file mode 100644 index 0000000..6ecc9a8 Binary files /dev/null and b/docs/品赞代理/assets/使用教程/09-已购套餐列表.jpeg differ diff --git a/docs/品赞代理/assets/使用教程/10-套餐详情.jpeg b/docs/品赞代理/assets/使用教程/10-套餐详情.jpeg new file mode 100644 index 0000000..297379a Binary files /dev/null and b/docs/品赞代理/assets/使用教程/10-套餐详情.jpeg differ diff --git a/docs/品赞代理/assets/使用教程/11-白名单管理入口.png b/docs/品赞代理/assets/使用教程/11-白名单管理入口.png new file mode 100644 index 0000000..ab2e6a4 Binary files /dev/null and b/docs/品赞代理/assets/使用教程/11-白名单管理入口.png differ diff --git a/docs/品赞代理/assets/使用教程/12-添加白名单.png b/docs/品赞代理/assets/使用教程/12-添加白名单.png new file mode 100644 index 0000000..24502a1 Binary files /dev/null and b/docs/品赞代理/assets/使用教程/12-添加白名单.png differ diff --git a/docs/品赞代理/assets/使用教程/13-白名单列表.png b/docs/品赞代理/assets/使用教程/13-白名单列表.png new file mode 100644 index 0000000..4bde31f Binary files /dev/null and b/docs/品赞代理/assets/使用教程/13-白名单列表.png differ diff --git a/docs/品赞代理/assets/使用教程/14-生成API入口.jpeg b/docs/品赞代理/assets/使用教程/14-生成API入口.jpeg new file mode 100644 index 0000000..9e72300 Binary files /dev/null and b/docs/品赞代理/assets/使用教程/14-生成API入口.jpeg differ diff --git a/docs/品赞代理/assets/使用教程/15-生成API配置.jpeg b/docs/品赞代理/assets/使用教程/15-生成API配置.jpeg new file mode 100644 index 0000000..e047c8b Binary files /dev/null and b/docs/品赞代理/assets/使用教程/15-生成API配置.jpeg differ diff --git a/docs/品赞代理/assets/使用教程/16-提取IP页面.png b/docs/品赞代理/assets/使用教程/16-提取IP页面.png new file mode 100644 index 0000000..bc8580f Binary files /dev/null and b/docs/品赞代理/assets/使用教程/16-提取IP页面.png differ diff --git a/docs/品赞代理/assets/使用教程/17-提取IP结果.png b/docs/品赞代理/assets/使用教程/17-提取IP结果.png new file mode 100644 index 0000000..a9bff73 Binary files /dev/null and b/docs/品赞代理/assets/使用教程/17-提取IP结果.png differ diff --git a/docs/品赞代理/assets/使用教程/18-浏览器代理设置入口.png b/docs/品赞代理/assets/使用教程/18-浏览器代理设置入口.png new file mode 100644 index 0000000..6bfa31c Binary files /dev/null and b/docs/品赞代理/assets/使用教程/18-浏览器代理设置入口.png differ diff --git a/docs/品赞代理/assets/使用教程/19-浏览器代理配置.png b/docs/品赞代理/assets/使用教程/19-浏览器代理配置.png new file mode 100644 index 0000000..67bb33e Binary files /dev/null and b/docs/品赞代理/assets/使用教程/19-浏览器代理配置.png differ diff --git a/docs/品赞代理/assets/使用教程/20-浏览器网络设置.png b/docs/品赞代理/assets/使用教程/20-浏览器网络设置.png new file mode 100644 index 0000000..54fe901 Binary files /dev/null and b/docs/品赞代理/assets/使用教程/20-浏览器网络设置.png differ diff --git a/docs/品赞代理/assets/使用教程/21-curl代理测试.png b/docs/品赞代理/assets/使用教程/21-curl代理测试.png new file mode 100644 index 0000000..2080e2b Binary files /dev/null and b/docs/品赞代理/assets/使用教程/21-curl代理测试.png differ diff --git a/docs/品赞代理/assets/使用教程/22-账号密码授权入口.png b/docs/品赞代理/assets/使用教程/22-账号密码授权入口.png new file mode 100644 index 0000000..5b1a87c Binary files /dev/null and b/docs/品赞代理/assets/使用教程/22-账号密码授权入口.png differ diff --git a/docs/品赞代理/assets/使用教程/23-账号密码授权设置.png b/docs/品赞代理/assets/使用教程/23-账号密码授权设置.png new file mode 100644 index 0000000..b01ca4c Binary files /dev/null and b/docs/品赞代理/assets/使用教程/23-账号密码授权设置.png differ diff --git a/docs/品赞代理/assets/常见问题/01-IP提取控制设置.jpg b/docs/品赞代理/assets/常见问题/01-IP提取控制设置.jpg new file mode 100644 index 0000000..2d9adaa Binary files /dev/null and b/docs/品赞代理/assets/常见问题/01-IP提取控制设置.jpg differ diff --git a/docs/品赞代理/assets/常见问题/02-重置套餐提取密钥.jpg b/docs/品赞代理/assets/常见问题/02-重置套餐提取密钥.jpg new file mode 100644 index 0000000..1039742 Binary files /dev/null and b/docs/品赞代理/assets/常见问题/02-重置套餐提取密钥.jpg differ diff --git a/docs/品赞代理/assets/常见问题/03-检查白名单.jpg b/docs/品赞代理/assets/常见问题/03-检查白名单.jpg new file mode 100644 index 0000000..fb6ed76 Binary files /dev/null and b/docs/品赞代理/assets/常见问题/03-检查白名单.jpg differ diff --git a/docs/品赞代理/assets/常见问题/04-curl检测示例.png b/docs/品赞代理/assets/常见问题/04-curl检测示例.png new file mode 100644 index 0000000..b899b89 Binary files /dev/null and b/docs/品赞代理/assets/常见问题/04-curl检测示例.png differ diff --git a/docs/品赞代理/代码示例.md b/docs/品赞代理/代码示例.md new file mode 100644 index 0000000..0b00c9b --- /dev/null +++ b/docs/品赞代理/代码示例.md @@ -0,0 +1,468 @@ +# 品赞代理代码示例 + +> 来源: +> 抓取日期:2026-11-19 +> 以下代码按原页面整理,未对示例中的旧版本语法或占位参数做现代化修正。 + +## Java (HTTP/HTTPS) + +```java +package com.example; + +import java.io.IOException; +import java.net.InetSocketAddress; +import java.net.Proxy; +import java.nio.charset.StandardCharsets; + +import org.apache.http.HttpHost; +import org.apache.http.auth.AuthScope; +import org.apache.http.auth.UsernamePasswordCredentials; +import org.apache.http.client.CredentialsProvider; +import org.apache.http.client.methods.CloseableHttpResponse; +import org.apache.http.client.methods.HttpGet; +import org.apache.http.impl.client.BasicCredentialsProvider; +import org.apache.http.impl.client.CloseableHttpClient; +import org.apache.http.impl.client.HttpClients; +import org.apache.http.util.EntityUtils; + +import okhttp3.Authenticator; +import okhttp3.Credentials; +import okhttp3.OkHttpClient; +import okhttp3.Request; +import okhttp3.Response; +import okhttp3.Route; + +public final class App { + + public static void main(String[] args) throws IOException { + String ip = "218.95.37.208"; // 代理主机地址 + int port = 12540; // 代理主机端口 + + // 使用OKHttp库 + // OKHttpProxy.build(ip, port).test(); + // 账号密码认证 + OKHttpProxy.build(ip, port, "aaaaaa", "bbbbbb").test(); + + // 使用HttpClient库 + // HttpClientProxy.build(ip, port).test(); + // 账号密码认证 + // HttpClientProxy.build(ip, port, "aaaaaa", "bbbbbb").test(); + } + + /** + * OKHttp库使用代理 + */ + static class OKHttpProxy { + + String proxyHost; + int proxyPort; + String proxyAccount; + String proxyPwd; + + /** + * @param host 代理主机地址 + * @param port 代理主机端口 + */ + public static OKHttpProxy build(String host, int port) { + OKHttpProxy proxy = new OKHttpProxy(); + proxy.proxyHost = host; + proxy.proxyPort = port; + return proxy; + } + + /** + * @param host 代理主机地址 + * @param port 代理主机端口 + * @param acc 代理认证账号 + * @param pwd 代理认证口令 + */ + public static OKHttpProxy build(String host, int port, String acc, String pwd) { + OKHttpProxy proxy = new OKHttpProxy(); + proxy.proxyHost = host; + proxy.proxyPort = port; + proxy.proxyAccount = acc; + proxy.proxyPwd = pwd; + return proxy; + } + + public void test() throws IOException { + String targetUrl = "http://www.baidu.com"; + + OkHttpClient client = null; + if (proxyAccount == null || proxyPwd == null) { + client = getHttpClient(proxyHost, proxyPort); + } else { + // 账号密码验证 + client = getHttpClient(proxyHost, proxyPort, proxyAccount, proxyPwd); + } + + Request request = new Request.Builder() + .url(targetUrl) + .build(); + Response response = client.newCall(request).execute(); + System.out.println(response.body().string()); + } + + /** + * 代理不需要账号密码认证的httpClient + */ + private static OkHttpClient getHttpClient(String proxyHost, int proxyPort) { + Proxy proxy = new Proxy(Proxy.Type.HTTP, new InetSocketAddress(proxyHost, proxyPort)); + return new OkHttpClient.Builder() + .proxy(proxy) + .build(); + } + + /** + * 代理需要账号密码认证的httpClient + */ + private static OkHttpClient getHttpClient(String proxyHost, int proxyPort, final String acc, final String pwd) { + Proxy proxy = new Proxy(Proxy.Type.HTTP, new InetSocketAddress(proxyHost, proxyPort)); + // 账号密码验证 + Authenticator authenticator = new Authenticator() { + @Override + public Request authenticate(Route route, Response resp) throws IOException { + String credential = Credentials.basic(acc, pwd); + return resp.request().newBuilder().header("Proxy-Authorization", credential).build(); + } + }; + return new OkHttpClient.Builder() + .proxy(proxy) + .proxyAuthenticator(authenticator) + .build(); + } + + } + + /** + * HttpClient库使用代理 + */ + static class HttpClientProxy { + String proxyHost; + int proxyPort; + String proxyAccount; + String proxyPwd; + + /** + * @param host 代理主机地址 + * @param port 代理主机端口 + */ + public static HttpClientProxy build(String host, int port) { + HttpClientProxy proxy = new HttpClientProxy(); + proxy.proxyHost = host; + proxy.proxyPort = port; + return proxy; + } + + /** + * @param host 代理主机地址 + * @param port 代理主机端口 + * @param acc 代理认证账号 + * @param pwd 代理认证口令 + */ + public static HttpClientProxy build(String host, int port, String acc, String pwd) { + HttpClientProxy proxy = new HttpClientProxy(); + proxy.proxyHost = host; + proxy.proxyPort = port; + proxy.proxyAccount = acc; + proxy.proxyPwd = pwd; + return proxy; + } + + public void test() throws IOException { + String targetUrl = "http://www.baidu.com"; + + CloseableHttpClient client = null; + if (proxyAccount == null || proxyPwd == null) { + client = getHttpClient(proxyHost, proxyPort); + } else { + // 账号密码验证 + client = getHttpClient(proxyHost, proxyPort, proxyAccount, proxyPwd); + } + HttpGet httpGet = new HttpGet(targetUrl); + CloseableHttpResponse response = client.execute(httpGet); + String resultStr = EntityUtils.toString(response.getEntity(), StandardCharsets.UTF_8); + System.out.println(resultStr); + } + + /** + * 代理不需要账号密码认证的httpClient + */ + private static CloseableHttpClient getHttpClient(String proxyHost, int proxyPort) { + HttpHost proxy = new HttpHost(proxyHost, proxyPort, "HTTP"); + return HttpClients.custom() + .setProxy(proxy) + .build(); + } + + /** + * 代理需要账号密码认证的httpClient + */ + private static CloseableHttpClient getHttpClient(String proxyHost, int proxyPort, String acc, String pwd) { + HttpHost proxy = new HttpHost(proxyHost, proxyPort, "HTTP"); + CredentialsProvider provider = new BasicCredentialsProvider(); + provider.setCredentials(new AuthScope(proxy), new UsernamePasswordCredentials(acc, pwd)); + + return HttpClients.custom() + .setProxy(proxy) + .setDefaultCredentialsProvider(provider) + .build(); + } + + } + +} +``` + +## Java (SOCKS5) + +```java +// 本示例展示socks5使用账号密码授权的方式 如果是白名单那么不需要填账号密码 + +package com.example; + +import java.net.InetSocketAddress; +import java.net.PasswordAuthentication; +import java.net.Proxy; +import java.util.concurrent.TimeUnit; +import okhttp3.OkHttpClient; +import okhttp3.Request; +import okhttp3.Response; + +public class App +{ + public static void main(String[] args) throws Exception + { + // -------------------------------------------------------------设置socks代理服务器ip端口 + Proxy proxy = new Proxy(Proxy.Type.SOCKS, new InetSocketAddress("222.187.239.60", 12475)); + System.out.println(proxy); + java.net.Authenticator.setDefault(new java.net.Authenticator() + { + // ------------------------------------------------------------------------设置代理IP的账号密码 账号密码在提取API的返回数据中 每个ip的账号密码不同 + // ------------------------------------------------------------------------如果使用白名单那么不需要填账号密码 + private PasswordAuthentication authentication = new PasswordAuthentication("aaaaaaaa", "bbbbbbbbbbb".toCharArray()); + + @Override + protected PasswordAuthentication getPasswordAuthentication() + { + return authentication; + } + }); + OkHttpClient client = new OkHttpClient.Builder().connectTimeout(150, TimeUnit.SECONDS).proxy(proxy).build(); + // ----------------------------------------------通过代理访问百度 + Request request = new Request.Builder().url("http://www.baidu.com").get().build(); + Response response = client.newCall(request).execute(); + System.out.println(response.body().string()); + } +} +``` + +## Python (HTTP/HTTPS) + +```python +#! /usr/bin/python +# coding=utf-8 +import requests +import time + +# 请求地址 +targetUrl = "http://www.baidu.com" + +# 代理服务器 +proxyHost = "代理IP" +proxyPort = 代理端口 + +# 非账号密码验证 +proxyMeta = "http://%(host)s:%(port)s" % { + "host": proxyHost, + "port": proxyPort, +} + +# 账号密码验证 +# proxyMeta = "http://账号:密码@%(host)s:%(port)s" % { +# "host": proxyHost, +# "port": proxyPort, +# } + +proxies = { + "http": proxyMeta, + "https": proxyMeta +} + +start = int(round(time.time() * 1000)) +resp = requests.get(targetUrl, proxies=proxies, timeout=10, verify=False) +costTime = int(round(time.time() * 1000)) - start +print resp.text +print("耗时:" + str(costTime) + "ms") +``` + +## Python (SOCKS5) + +```python +# -*- coding: utf-8 -*- +import socket +import socks +import requests + +# 非账号密码 +socks.set_default_proxy(socks.SOCKS5, "xxx.xxx.xxx.xxx", xxxx) + +# 账号密码 +# socks.set_default_proxy(socks.SOCKS5, "xxx.xxx.xxx.xxx", xxxx, True, 'account', 'password') + +socket.socket = socks.socksocket + +response = requests.get("http://www.baidu.com") +print (response.text) +``` + +## Go + +```go +package main + +import ( + "fmt" + "io/ioutil" + "log" + "net/http" + "net/url" + "time" +) + +func main() { + proxyAddr := "http://代理服务器ip:代理服务器http端口/" + //账号密码验证 + //proxyAddr := "http://用户名:密码@代理服务器ip:代理服务器http端口/" + + //proxyAddr := "socks5://代理服务器ip:代理服务器http端口/" + //proxyAddr := "socks5://用户名:密码@代理服务器ip:代理服务器http端口/" + httpUrl := "http://www.baidu.com" + proxy, err := url.Parse(proxyAddr) + if err != nil { + log.Fatal(err) + } + netTransport := &http.Transport{ + Proxy:http.ProxyURL(proxy), + MaxIdleConnsPerHost: 10, + ResponseHeaderTimeout: time.Second * time.Duration(5), + } + httpClient := &http.Client{ + Timeout: time.Second * 10, + Transport: netTransport, + } + res, err := httpClient.Get(httpUrl) + if err != nil { + log.Println(err) + return + } + defer res.Body.Close() + if res.StatusCode != http.StatusOK { + log.Println(err) + return + } + c, _ := ioutil.ReadAll(res.Body) + fmt.Println(string(c)) +} +``` + +## C# + +```csharp +using System; +using System.IO; +using System.Net; +using System.Net.Http; +using System.Text; +using System.Threading.Tasks; + +namespace ProxySample { + internal class Program { + public static async Task Run() { + var proxy = new WebProxy("代理IP", 代理端口); //这里替换为你的代理地址和端口 + //如使用账号密码验证,反注释此行 + //proxy.Credentials = new NetworkCredential(userName: "账号", password: "密码"); //这里替换成你的验证用户名和密码 + + //HttpWebRequest用法 + var req = HttpWebRequest.Create("https://baidu.com"); + req.Proxy = proxy; + req.Method = "GET"; + var response = req.GetResponse(); + Stream stream = response.GetResponseStream(); + StreamReader sr = null; + sr = new StreamReader(stream, Encoding.Default); + var html = sr.ReadToEnd(); + sr.Close(); + sr.Dispose(); + Console.WriteLine(html); + + //HttpClient用法 + var httpClientHandler = new HttpClientHandler { + Proxy = proxy, + }; + HttpClient client = new HttpClient(httpClientHandler); + var ret = await client.GetStringAsync("https://baidu.com"); + Console.WriteLine(ret); + } + + public static void Main(string[] args) { + Task.Run(async () => { await Program.Run(); }).Wait(); + } + } +} +``` + +## PHP + +```php +// 设置代理,格式 ip:port +$proxyServer = "ip:port"; + +$ch = curl_init(); +// 设置请求地址 +curl_setopt($ch, CURLOPT_URL, "http://www.baidu.com"); +// 设置代理,格式 http://ip:port +curl_setopt($ch, CURLOPT_PROXY, "http://$proxyServer"); +// https请求 不验证证书和hosts +curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE); +//账号密码验证 +//curl_setopt($ch, CURLOPT_PROXYUSERPWD, "账号:密码"); + +$output = curl_exec($ch); +if ($output === FALSE) { + echo "CURL Error:" . curl_error($ch); +} else { + echo $output; +} +curl_close($ch); +``` + +## Node.js + +```javascript +// npm install superagent +// npm install superagent-proxy +let request = require('superagent') +require('superagent-proxy')(request) + +let targetUrl = 'http://www.baidu.com' + +let proxyServer = '代理IP:代理端口' +let proxyUrl = 'http://' + proxyServer +//账号密码验证 +//let proxyUrl = 'http://' + '账号:密码' + '@' + proxyServer + +request.get(targetUrl) + .proxy(proxyUrl) + .then(res => { + console.log(res.text || res.body) + }).catch(err => { + console.log(err.message) + }) +``` + +## 易语言 + +原页面提供压缩包下载,已保存到本地: + +[易语言示例.rar](assets/代码示例/易语言示例.rar) diff --git a/docs/品赞代理/使用协议.md b/docs/品赞代理/使用协议.md new file mode 100644 index 0000000..cfffb70 --- /dev/null +++ b/docs/品赞代理/使用协议.md @@ -0,0 +1,44 @@ +# 品赞代理使用协议 + +> 来源: +> 抓取日期:2026-11-19 + +本协议是您与品赞代理相关事宜所订立的契约,请您仔细阅读本注册协议,您点击“注册”后,本协议即构成对双方有约束力的法律文件。 + +## 第 1 条 用户注册 + +1. 用户注册是指用户登录品赞代理,按要求填写相关信息并确认同意本服务协议的过程。 +2. 品赞代理用户必须是具有完全民事行为能力的自然人。 +3. 本产品一经售出,概不退款。 + +## 第 2 条 用户帐号 + +用户一旦注册成功,成为本站的合法用户。品赞代理将对用户名和密码安全负全部责任,若是因个人行为造成的密码用户安全问题,本公司不负责任。此外,每个用户都要对以其用户名进行的所有活动和事件负全责。用户若发现任何非法使用用户帐号或存在安全漏洞的情况,请立即通告本站或者致电官网电话。 + +## 第 3 条 用户依法言行义务 + +本协议依据国家相关法律法规规章制定,用户同意严格遵守以下义务: + +1. 不得传输或发表:煽动抗拒、破坏宪法和法律、行政法规实施的言论,煽动颠覆国家政权,推翻社会主义制度的言论,煽动分裂国家、破坏国家统一的的言论,煽动民族仇恨、民族歧视、破坏民族团结的言论; +2. 从中国大陆向境外传输资料信息时必须符合中国有关法规; +3. 不得利用本站从事洗钱、窃取商业秘密、窃取个人信息等违法犯罪活动; +4. 不得干扰本站的正常运转,不得侵入本站及国家计算机信息系统; +5. 不得传输或发表任何违法犯罪的、骚扰性的、中伤他人的、辱骂性的、恐吓性的、伤害性的、庸俗的,淫秽的、不文明的等信息资料; +6. 不得传输或发表损害国家社会公共利益和涉及国家安全的信息资料或言论; +7. 不得教唆他人从事本条所禁止的行为; +8. 不得利用在本站注册的账户进行牟利性经营活动; +9. 不得发布任何侵犯他人著作权、商标权等知识产权或合法权利的内容。 + +用户应不时关注并遵守本站不时公布或修改的各类合法规则规定。 + +本站保有删除站内各类不符合法律政策或不真实的信息内容而无须通知用户的权利。 + +若用户未遵守以上规定的,本站有权作出独立判断并采取暂停或关闭用户帐号等措施。用户须对自己在网上的言论和行为承担法律责任。 + +## 第 4 条 协议更新及用户关注义务 + +根据国家法律法规变化及网站运营需要,品赞代理有权对本协议条款不时地进行修改,修改后的协议一旦被张贴在本站上即生效,并代替原来的协议。用户可随时登录查阅最新协议;用户有义务不时关注并阅读最新版的协议及网站公告。如用户不同意更新后的协议,可以且应立即停止接受网站依据本协议提供的服务;如用户继续使用本网站提供的服务的,即视为同意更新后的协议。品赞代理建议您在使用本站之前阅读本协议及本站的公告。如果本协议中任何一条被视为废止、无效或因任何理由不可执行,该条应视为可分的且并不影响任何其余条款的有效性和可执行性。 + +## 第 5 条 法律管辖和适用 + +本协议的订立、执行和解释及争议的解决均应适用在中华人民共和国大陆地区适用之有效法律(但不包括其冲突法规则)。如发生本协议与适用之法律相抵触时,则这些条款将完全按法律规定重新解释,而其它有效条款继续有效。如缔约方就本协议内容或其执行发生任何争议,双方应尽力友好协商解决;协商不成时,任何一方均可向有管辖权的中华人民共和国大陆地区法院提起诉讼。 diff --git a/docs/品赞代理/使用教程.md b/docs/品赞代理/使用教程.md new file mode 100644 index 0000000..a4234dd --- /dev/null +++ b/docs/品赞代理/使用教程.md @@ -0,0 +1,137 @@ +# 品赞代理使用教程 + +> 来源: +> 抓取日期:2026-11-19 +> 页面截图已保存到 `assets/使用教程/`。 + +## 使用流程及 IP 介绍 + +### IP 使用大致流程 + +新手购买和使用的大致流程为: + +```text +注册认证 -> IP 购买 -> 添加白名单 -> IP 提取 -> IP 使用 +``` + +以上各个步骤的具体流程可以继续查看本文对应章节。 + +### 品赞 IP 类型 + +品赞代理 IP 分为两种: + +- 直连代理 IP,即直连 IP。 +- 隧道代理 IP,即优质 IP。 + +两种 IP 均为短效 IP,即每个 IP 的有效时长为 1、3、5、10、15、30 分钟不等。有效时长不同,单价也不同。 + +- 直连 IP 为机房 IP,连通率高、响应速度更快,但 IP 新鲜度较差,IP 量有限。 +- 优质 IP 为设备 IP,连通率 90% 以上,IP 量大,实时更新 IP 库,新鲜度高,可以提升业务成功率。 + +### 产品模式与套餐模式 + +品赞 IP 分为 3 种模式售卖: + +1. 金币模式:即按使用量计费模式。用户注册时会自动生成“按量计费套餐”,用户预充值到钱包中,提取 IP 时选择“按量计费套餐”,IP 按照真实提取数量从钱包扣费。 +2. 包时长套餐:价格比按量计费便宜。用户可以根据需求购买固定期限、固定 IP 时长、每日固定 IP 数量的套餐。例如包 7 天、3 分钟、每日 20000 IP 套餐,表示有效时间为 7 天,所有 IP 的有效时长均为 3 分钟,每日提取上限为 20000 个 IP,7 天后套餐立即失效。 +3. 包总量套餐:价格比按量计费便宜。用户可以根据需求购买固定数量、固定 IP 时长的套餐。套餐有效期默认 30 天,如要自定义有效期可联系客服延期,套餐过期或总量用完即截止。 + +## 注册认证 + +### 注册登录 + +新用户可获得 10 个免费金币,约 2000 个免费 IP。 + +![注册登录页面](assets/使用教程/01-注册登录页面.png) + +![注册登录表单](assets/使用教程/02-注册登录表单.png) + +### 实名认证 + +![实名认证入口](assets/使用教程/03-实名认证入口.png) + +![实名认证页面](assets/使用教程/04-实名认证页面.png) + +## IP 购买 + +### 包时长套餐购买 + +![套餐购买入口](assets/使用教程/05-套餐购买入口.jpg) + +![包时长套餐购买](assets/使用教程/06-包时长套餐购买.jpeg) + +### 包总量套餐购买 + +![套餐购买入口](assets/使用教程/05-套餐购买入口.jpg) + +![包总量套餐购买](assets/使用教程/07-包总量套餐购买.jpeg) + +### 金币充值 + +![套餐购买入口](assets/使用教程/05-套餐购买入口.jpg) + +![金币充值](assets/使用教程/08-金币充值.jpeg) + +### 查看已购套餐 + +![已购套餐列表](assets/使用教程/09-已购套餐列表.jpeg) + +![套餐详情](assets/使用教程/10-套餐详情.jpeg) + +## 添加白名单 + +### 白名单管理 + +![白名单管理入口](assets/使用教程/11-白名单管理入口.png) + +![添加白名单](assets/使用教程/12-添加白名单.png) + +![白名单列表](assets/使用教程/13-白名单列表.png) + +## IP 提取 + +### 生成 API + +![生成 API 入口](assets/使用教程/14-生成API入口.jpeg) + +![生成 API 配置](assets/使用教程/15-生成API配置.jpeg) + +### 提取 IP + +![提取 IP 页面](assets/使用教程/16-提取IP页面.png) + +![提取 IP 结果](assets/使用教程/17-提取IP结果.png) + +## IP 使用 + +### 浏览器设置代理 + +以下示例以谷歌浏览器为例。 + +![浏览器代理设置入口](assets/使用教程/18-浏览器代理设置入口.png) + +![浏览器代理配置](assets/使用教程/19-浏览器代理配置.png) + +![浏览器网络设置](assets/使用教程/20-浏览器网络设置.png) + +### curl 命令快速测试 IP + +```bash +curl --proxy x.x.x.x:xxxxx myip.ipip.net +``` + +![curl 代理测试](assets/使用教程/21-curl代理测试.png) + +### 其他方式使用 + +代理 IP 的使用方式有很多种,具体取决于客户自身需求。本站仅提供代理 IP,如何使用代理 IP 不在本站讨论范围内。 + +如需在代码中调用代理,可以查看“代码示例”文档。 + +## 账号密码授权 + +![账号密码授权入口](assets/使用教程/22-账号密码授权入口.png) + +![账号密码授权设置](assets/使用教程/23-账号密码授权设置.png) + +注意:账号密码授权仍需要添加提取 IP 的设备的白名单,否则会出现 `请先将xx.xx.xx.xx加入到白名单再进行提取` 的提示。 diff --git a/docs/品赞代理/免责声明.md b/docs/品赞代理/免责声明.md new file mode 100644 index 0000000..4db97cb --- /dev/null +++ b/docs/品赞代理/免责声明.md @@ -0,0 +1,32 @@ +# 品赞代理免责声明 + +> 来源: +> 抓取日期:2026-11-19 + +使用方在接受本平台服务之前,请务必仔细阅读本条款并同意本声明。使用方直接或通过各类方式间接使用本平台服务的行为,都将被视作已无条件接受本声明所涉全部内容。若使用方对本声明的任何条款有异议,请停止使用本平台提供的全部服务。 + +## 第一条 + +本平台仅为互联网用户提供代理服务,并不针对任何网站、软件、个人。仅提供国内网络节点,不提供境外网络节点,不能用于任何非法用途,不能访问境外封闭网站,不能跨境联网,只能用于合法的国内网络加速。 + +## 第二条 + +使用方以各种方式使用本平台服务的过程中,必须遵守《中华人民共和国网络安全法》之规定,如涉及以下任意一条,将判定为违规,本平台有权将使用者账户封禁,必要时交予公安机关处理: + +- 煽动抗拒、破坏宪法和法律、行政法规实施的; +- 煽动颠覆国家政权,推翻社会主义制度的; +- 煽动分裂国家、破坏国家统一的; +- 煽动民族仇恨、民族歧视,破坏民族团结的; +- 捏造或者歪曲事实,散布谣言,扰乱社会秩序的; +- 宣扬封建迷信、淫秽、色情、赌博、暴力、凶杀、恐怖,教唆犯罪的; +- 公然侮辱他人或者捏造事实诽谤他人的; +- 损害国家机关信誉的; +- 其他违反宪法和法律、行政法规、社会公德的。 + +## 第三条 + +任何由于机房故障、通讯线路问题,或因政府管制而造成的暂时性关闭等不可抗力因素而导致使用方不能正常使用代理服务的情况,本平台不承担任何经济及法律责任。 + +## 第四条 + +本声明未涉及的问题参见国家有关法律法规,当本声明与国家法律法规冲突时,以国家法律法规为准。对免责声明的最终解释、修改及更新权均属品赞代理所有。