核心用法
TPN Proxy（tao-private-network/tpn-proxy）是一个基于 Bittensor 子网 65（SN65）的去中心化 SOCKS5 代理服务。用户可通过 API 调用即时生成短期代理凭证（1-1440 分钟），将 HTTP/HTTPS 流量路由至 80+ 国家的分布式出口节点。
关键操作流程：
1. 认证：通过 TPN_API_KEY 环境变量或 x402 协议进行身份验证
2. 生成代理：调用 POST /api/v1/proxy/generate，指定时长（分钟）、地理位置（ISO 3166-1 alpha-2）、连接类型（any/datacenter/residential）及返回格式（text/json）
3. 使用凭证：获取 socks5h://username:password@host:port 格式的代理 URI，直接用于 curl、Python requests、Node.js fetch 等工具
4. 执行请求：可直接代为抓取目标 URL，或提供完整凭证供用户自行使用
典型场景：
- 匿名浏览与 IP 轮换
- 地理定位测试（验证网站在不同国家/地区的呈现）
- 住宅代理访问（residential 类型降低被封禁概率）
- 自动化数据抓取与反爬虫绕过
显著优点
1. 去中心化基础设施：基于 Bittensor 区块链激励机制，节点由全球矿工运营，无单点故障
2. 双重支付模式：既支持传统 API 密钥预付费（信用积分制），也支持 x402 协议的无账户即时微支付（USDC on Base）
3. 精细地理覆盖：80+ 国家可选，支持 datacenter（数据中心）与 residential（住宅）两种 IP 类型
4. 即时可用：无需配置 WireGuard 等复杂 VPN，SOCKS5 凭证即开即用，兼容几乎所有 HTTP 客户端
5. 透明定价：信用积分公式公开 ceil(4.1 × minutes^0.375)，支持成本预计算端点
潜在缺点与局限性
1. 时效性约束：代理凭证严格限时（最长 24 小时），需持续重新生成，不适合长期固定 IP 场景
2. 可用性波动：503 错误表明"无可用矿工"，去中心化特性导致高峰时段资源不可保证，需重试机制
3. 成本累积：高频短时使用成本较高（1 分钟 5 积分 vs 60 分钟 20 积分），需合理规划时长
4. 技术门槛：x402 支付流需理解区块链签名流程，对非加密原生用户存在认知负担
5. 安全依赖代理端：虽 skill 本身不存储敏感数据，但流量实际流经第三方矿工节点，存在潜在窃听风险（建议配合 HTTPS）
适合人群
- 开发者与 SRE：需要程序化地理测试、CI/CD 中的多区域验证
- 数据工程师：住宅代理需求，降低反爬虫触发概率
- 隐私敏感用户：寻求比传统 VPN 更灵活、无日志的短期匿名方案
- Web3 原生团队：已集成 x402 支付能力的自治代理/AI 系统
常规风险
- API 密钥泄露：
TPN_API_KEY需严格保管，泄露将导致信用积分被盗用 - SSRF 攻击面：若 skill 被滥用访问内网服务，需依赖严格的 URL 验证规则（已实现域名解析、私有 IP 段、内部主机名等多重过滤）
- 代理节点不可信：去中心化网络中的恶意矿工可能进行流量分析或 TLS 降级攻击
- 区块链支付风险：x402 流涉及链上交易，存在 Gas 费波动与交易失败可能