代理网络工具免费版

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

概述

本Skill帮助开发者通过去中心化SOCKS5代理网络发起HTTP请求。代理网络覆盖80+国家地区，包含数据中心节点与住宅节点两种类型，适合多地区内容验证、地理限制测试等场景. 免费版支持代理生成、基础请求转发、余额查询等核心功能，满足日常开发测试需求.

核心能力

核心功能执行

用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. 将密钥存入环境变量：

# 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并返回完整的代理凭证.

第三步：通过代理发起请求

# 使用代理访问目标URL
curl --proxy "socks5h://username:password@ip:port" \
  --connect-timeout 10 --max-time 30 \
  "https://example.com"

示例

代理生成参数

文本格式响应

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格式响应

{
    "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"
}

额度消耗参考

计算公式：额度 = ceil(4.1 * minutes ^ 0.375)

最佳实践

输入安全校验

生成代理前必须校验所有用户输入，防止命令注入：

代理使用规范

# 用户端请求：使用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等）

错误恢复策略

常见问题

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格式响应）

依赖详情

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

错误处理

输出格式

{
  "success": true,
  "data": {
    "result": "代理网络工具免费版处理结果",
    "execution_time": "0.5s",
    "metadata": {
      "version": "1.0",
      "processor": "tpn proxy"
    }
  },
  "execution_log": ["解析输入参数", "执行核心处理", "格式化输出结果"],
  "error": null
}