Tpn Proxy Tool Free

通过去中心化SOCKS5代理发起HTTP请求，支持80+国家节点选择，提供代理凭证生成、租期管理和余额查询的免费版工具。

Install

openclaw skills install @thcjp/tpn-proxy-tool-free

去中心化代理网络工具（免费版）

概述

本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秒）

访问代理网络服务官网注册账户
在控制台创建API密钥（格式如 tpn-abc123...）
将密钥存入环境变量：

bash

# Linux/macOS
export TPN_API_KEY="tpn-your-api-key-here"
# ...
# Windows PowerShell
$env:TPN_API_KEY = "tpn-your-api-key-here"

第二步：生成你的第一个代理

向Agent描述需求：

text

帮我生成一个德国的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）

文本格式响应

text

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前，必须通过以下全部检查：

URL必须以 http:// 或 https:// 开头
不含shell元字符（$、`、(、)、;、&、|、<、>）
拒绝原始IP地址，只允许域名
拒绝内网主机名（*.local、*.internal、*.localhost等）
域名必须能通过本地DNS解析
解析后的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
}