back
loading skill details...
通过去中心化SOCKS5代理发起HTTP请求，支持80+国家节点选择，提供代理凭证生成、租期管理和余额查询的免费版工具。
---
slug: tpn-proxy-tool-free
name: tpn-proxy-tool-free
version: 1.0.0
displayName: 代理网络工具免费版
summary: 通过去中心化SOCKS5代理发起网络请求，支持80+国家地区节点选择
license: Proprietary
edition: free
description: '面向开发者的去中心化SOCKS5代理请求工具，通过全球分布式网络节点发起HTTP请求，支持按国家地区选择出口IP。
核心能力：生成短期有效的SOCKS5代理凭证，支持按地理位置选择节点、代理租期管理、余额查询与基础请求转发。
适用场景：多地区内容验证、地理限制测试、爬虫IP轮换、API区域限流规避等网络请求场景。
差异化：重新设计中文交互流程，新增输入安全校验机制，完善错误恢复策略，去除外部依赖引用，适配国内开发者使用习惯。
适用关键词：代理、proxy、socks5、去中心化、出口IP、网络请求、地区节点'
tags:
- 网络工具
- 代理服务
- 请求转发
tools:
- - read
- exec
homepage: https://skillhub.cn
pricing_tier: L3
pricing_model: per_use
suggested_price: 29.9
tools: ["read", "write", "exec"]
tags: "工具,效率,自动化"
---
# 去中心化代理网络工具（免费版）
## 概述
本Skill帮助开发者通过去中心化SOCKS5代理网络发起HTTP请求。代理网络覆盖80+国家地区，包含数据中心节点与住宅节点两种类型，适合多地区内容验证、地理限制测试等场景。
免费版支持代理生成、基础请求转发、余额查询等核心功能，满足日常开发测试需求。
## 核心能力
| 能力模块 | 说明 | 免费版支持 |
|----|---|-----|
| SOCKS5代理生成 | 创建短期代理凭证 | 是 |
| 地区选择 | 按国家代码指定出口 | 是 |
| 代理租期管理 | 1-1440分钟灵活租期 | 是 |
| 余额查询 | 查看剩余额度 | 是 |
| 请求转发 | 通过代理发起HTTP请求 | 是 |
| 节点类型选择 | 数据中心/住宅节点 | 是（基础） |
| 多代理并发 | 同时管理多个代理会话 | 否（专业版） |
| 自动轮换 | 代理过期自动续期 | 否（专业版） |
| 请求重试与熔断 | 失败自动重试与熔断 | 否（专业版） |
| 代理性能监控 | 延迟/成功率统计 | 否（专业版） |
### 核心功能执行
用`input_params`参数进行配置。
**输入**: 用户提供核心功能执行所需的指令和必要参数。
**处理**: 解析核心功能执行的输入参数,完成核心逻辑,返回结构化响应。
**输出**: 返回核心功能执行的响应数据,包含状态码、结果和日志。
- 执行此能力时使用`input_params`参数,支持创建/查询/导出操作
### 参数配置与调用
用`config_options`参数进行配置。
**输入**: 用户提供参数配置与调用所需的指令和必要参数。
**处理**: 解析参数配置与调用的输入参数,完成核心逻辑,返回结构化响应。
**输出**: 返回参数配置与调用的响应数据,包含状态码、结果和日志。
- 执行此能力时使用`config_options`参数,支持修改/重置/导入操作
### 结果处理与输出
用`output_format`参数进行配置。
**输入**: 用户提供结果处理与输出所需的指令和必要参数。
**处理**: 解析结果处理与输出的输入参数,完成核心逻辑,返回结构化响应。
**输出**: 返回结果处理与输出的响应数据,包含状态码、结果和日志。
- 执行此能力时使用`output_format`参数,支持导出/保存/转换操作
**能力覆盖范围**：本skill的核心能力覆盖以下场景关键词：通过去中心化、代理发起网络请求、国家地区节点选择、面向开发者的去中、代理请求工具、通过全球分布式网、络节点发起、支持按国家地区选、择出口等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。
## 使用场景
### 场景一：多地区内容验证
某跨境团队需要验证其网站在不同国家的展示效果。通过本Skill生成不同国家的代理节点，逐一访问网站验证内容本地化是否正确。
### 场景二：API区域限流规避
某数据采集脚本需要调用有区域限制的API。通过轮换不同国家的代理节点，避免单一IP触发限流。
### 已知限制
某流媒体应用需要测试不同地区的访问权限控制。通过生成对应国家的代理节点，模拟不同地区用户的访问行为。
- 当前为免费版本,如需完整功能请升级到付费版获取全部能力
## 快速开始
### 第一步：配置API密钥（约30秒）
1. 访问代理网络服务官网注册账户
2. 在控制台创建API密钥（格式如 `tpn-abc123...`）
3. 将密钥存入环境变量：
```bash
# Linux/macOS
export TPN_API_KEY="tpn-your-api-key-here"
# ...
# Windows PowerShell
$env:TPN_API_KEY = "tpn-your-api-key-here"
```
### 第二步：生成你的第一个代理
向Agent描述需求：
```
帮我生成一个德国的SOCKS5代理，租期60分钟
```
Agent将调用API并返回完整的代理凭证。
### 第三步：通过代理发起请求
```bash
# 使用代理访问目标URL
curl --proxy "socks5h://username:password@ip:port" \
--connect-timeout 10 --max-time 30 \
"https://example.com"
```
## 示例
### 代理生成参数
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|:-----|:-----|:-----|:-----|:-----|
| `minutes` | 整数 | 是 | 60 | 租期时长（1-1440分钟） |
| `geo` | 字符串 | 否 | 任意 | ISO国家代码（如US/DE/JP） |
| `format` | 字符串 | 否 | text | 返回格式（text/json） |
| `connection_type` | 字符串 | 否 | any | 节点类型（any/datacenter/residential） |
### 文本格式响应
```
Host: 185.42.170.3
Port: 1080
Username: u_0CKaBqdE
Password: p_sT6yM3zabqRuhqrahzGOl4i4RTEDgQ7V
Scheme: socks5h
Expires: 2026-02-16T15:30:00Z
```
完整URI格式：`socks5h://username:password@ip:port`
### JSON格式响应
```json
{
"success": true,
"vpnConfig": {
"username": "u_0CKaBqdE",
"password": "p_sT6yM3zabqRuhqrahzGOl4i4RTEDgQ7V",
"ip_address": "68.210.185.149",
"port": 1080
},
"minutes": 60,
"expiresAt": "2026-02-16T15:30:00Z",
"creditsUsed": 20,
"type": "socks5",
"connection_type": "any"
}
```
### 额度消耗参考
| 租期 | 消耗额度 |
|---:|---:|
| 1分钟 | 5 |
| 5分钟 | 8 |
| 10分钟 | 10 |
| 30分钟 | 15 |
| 60分钟 | 20 |
| 120分钟 | 25 |
| 720分钟（12小时） | 49 |
| 1440分钟（24小时） | 63 |
计算公式：`额度 = ceil(4.1 * minutes ^ 0.375)`
## 最佳实践
### 输入安全校验
生成代理前必须校验所有用户输入，防止命令注入：
| 输入项 | 校验规则 | 拒绝条件 |
|:---:|:---:|:---:|
| `geo` | 2个大写ASCII字母（ISO 3166-1） | 非字母、长度不等于2、小写 |
| `minutes` | 正整数，范围1-1440 | 非数字、超出范围 |
| `connection_type` | 枚举值：any/datacenter/residential | 非枚举值 |
| `format` | 枚举值：text/json | 非枚举值 |
| 目标URL | http/https开头，无shell元字符 | 含特殊字符、内网地址 |
### 代理使用规范
```bash
# 用户端请求：使用socks5h://（DNS通过代理解析，保护DNS隐私）
curl --proxy socks5h://username:password@ip:port https://target.com
# ...
# 注意：socks5h中的h表示DNS解析在代理端完成
# 如果使用socks5://则DNS在本地解析
```
### URL安全校验清单
通过代理请求URL前，必须通过以下全部检查：
1. URL必须以 `http://` 或 `https://` 开头
2. 不含shell元字符（`$`、`` ` ``、`(`、`)`、`;`、`&`、`|`、`<`、`>`）
3. 拒绝原始IP地址，只允许域名
4. 拒绝内网主机名（`*.local`、`*.internal`、`*.localhost`等）
5. 域名必须能通过本地DNS解析
6. 解析后的IP必须是公网地址（拒绝 `127.0.0.0/8`、`10.0.0.0/8`、`192.168.0.0/16`等）
### 错误恢复策略
| 错误类型 | HTTP状态码 | 原因 | 恢复策略 |
|:------|------:|:------|:------|
| 认证失败 | 401 | API密钥无效 | 检查密钥格式，确认使用X-API-Key头部 |
| 额度不足 | 402 | 余额耗尽 | 充值或使用x402按需支付 |
| 服务不可用 | 503 | 无可用节点 | 额度自动退还，稍后重试 |
| 连接超时 | - | 代理已过期 | 重新生成新代理 |
| DNS解析失败 | - | 本地DNS问题 | 切换为socks5h://远程DNS解析 |
## 常见问题
### Q1：socks5://和socks5h://有什么区别？
A：`socks5://` 的DNS解析在本地完成，`socks5h://` 的DNS解析在代理端完成。对于用户端代码，推荐使用 `socks5h://` 以保护DNS隐私。Agent端发起请求时使用 `socks5://` 以确保本地DNS校验生效。
### Q2：代理过期后还能使用吗？
A：不能。代理凭证有明确的过期时间（`expiresAt`字段），过期后连接会失败。需要重新生成新代理。免费版不会自动续期，如需自动轮换请使用专业版。
### Q3：住宅节点和数据中心节点有什么区别？
A：住宅节点使用家庭宽带IP，更不容易被目标网站识别和封锁，适合反爬严格的场景。数据中心节点速度更快但更容易被识别。住宅节点消耗更多额度。
### Q4：免费版有哪些限制？
A：免费版不限制使用次数，但不支持多代理并发管理、代理自动轮换、请求重试与熔断、代理性能监控等高级功能。如需这些能力请使用专业版。
### Q5：如何查看剩余额度？
A：向Agent说"查看我的余额"，Agent会调用余额查询接口并返回剩余额度数。新注册账户通常附带100免费额度，约可生成5个60分钟代理。
## 依赖说明
### 运行环境
- **Agent平台**: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
- **操作系统**: Windows / macOS / Linux
- **curl**: 已安装（用于API调用与请求转发）
- **jq**: 推荐（用于解析JSON格式响应）
### 依赖详情
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|---:|:---|---:|---:|
| LLM API | API | 必需 | 由Agent平台内置LLM提供 |
| curl | CLI工具 | 必需 | 系统自带或官方下载 |
| jq | JSON解析 | 推荐 | `apt install jq` / `brew install jq` |
| 代理网络API | API | 必需 | 注册账户后获取API密钥 |
### API Key 配置
- **TPN API密钥**: 存储于环境变量 `TPN_API_KEY`，由Agent平台自动注入
- **禁止**: 在代码或配置文件中明文硬编码密钥
- **禁止**: 回显、日志记录或输出密钥值本身
- **安全检查**: 仅检测变量是否存在 `[ -n "$TPN_API_KEY" ]`，不输出值
### 可用性分类
- **分类**: MD+EXEC（纯Markdown指令，部分功能需要exec命令行执行能力）
- **说明**: 基于Markdown的AI Skill，通过自然语言指令驱动Agent执行代理网络操作
## 免费版限制
本免费体验版限制以下高级功能：
- 不支持多代理并发管理（同时仅1个活跃代理会话）
- 不支持代理自动轮换（过期需手动重新生成）
- 不支持请求重试与熔断机制
- 不支持代理性能监控（延迟/成功率统计）
- 不支持x402按需支付流程
- 不提供优先技术支持
解锁全部功能请使用专业版：tpn-proxy-tool-pro
## 错误处理
| 错误场景 | 原因 | 处理方式 |
|:------:|--------|:-------|
| 配置错误 | 参数缺失或格式错误 | 检查依赖说明中的配置要求 |
| 运行时错误 | 运行环境不满足 | 确认运行环境符合依赖说明 |
| 网络错误 | 连接超时或不可达 | 执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令，参考国内替代方案 |
## 输出格式
```json
{
"success": true,
"data": {
"result": "代理网络工具免费版处理结果",
"execution_time": "0.5s",
"metadata": {
"version": "1.0",
"processor": "tpn proxy"
}
},
"execution_log": ["解析输入参数", "执行核心处理", "格式化输出结果"],
"error": null
}
```
don't have the plugin yet? install it then click "run inline in claude" again.