Skip to content

lushun2014/lushibo-skills / lushibo-proxy

lushibo-proxy

Unverified

代理与跨境网络架构工程(proxy & cross-border network engineering)。能力:代理协议原理与选型(VLESS/XTLS-Vision、Trojan、Shadowsocks-2022、Hysteria2、TUIC、WireGuard、mKCP、gRPC/WS/QUIC 传输)、链路拓扑设计(直连/中转/隧道链/CDN 前置/落地分离)、自建节点部署与证书自动化、性能与稳定性调优(BBR/fq、MSS/MTU、多路复用、端口跳跃、健康检查与故障切换)、流量特征与主动探测对抗分析、订阅与批量节点管理。Use when 用户提到 翻墙、代理、科学上网、跨境网络、代理协议、VLESS、Trojan、Hysteria2、sing-box、Xray、链路拓扑、分流规则、中转节点、抗封锁、自建节点、机场订阅,或给出节点配置、连通性异常、测速数据要求设计与排障。交付物:链路拓扑图(Mermaid)、协议选型对比表、服务端与客户端配置清单、性能调优参数表、流量特征分析报告、健康检查与故障切换脚本。

Lushibo Proxy · 代理与跨境网络架构

代理工程的本质是在不稳定的链路上做可靠的传输。三个指标决定一切:连通率、时延、吞吐。所有设计决策都要能回答"它提升了哪个指标、代价是什么"。

触发条件

  • 加载时机:用户要设计跨境链路、选代理协议、自建/优化节点、排查连不上/慢/掉线、分析流量特征、批量管理订阅与节点。
  • 中文关键词:翻墙、代理、科学上网、跨境网络、代理协议、链路拓扑、分流规则、中转、落地、前置、抗封锁、自建节点、机场订阅、端口跳跃、证书、回落、主动探测。
  • 英文关键词:proxy、VLESS、XTLS、Vision、Reality、Trojan、Shadowsocks-2022、Hysteria2、TUIC、WireGuard、mKCP、gRPC、uTLS、CDN fronting、BBR、MSS clamping、multiplex、failover、sing-box、Xray。
  • 不加载的情况:目标是攻防对抗/内网渗透走 $lushibo-pentest;目标是逆向代理客户端二进制走 $lushibo-reverse;目标是日志侧的检测与响应走 $lushibo-bluesec。
  • 边界:本 skill 管链路设计与调优;检测侧规则归 bluesec,客户端逆向归 reverse。

执行步骤

第 1 步:先定义指标与约束

写清四项,缺一项就不要开始选协议:

项取值示例
目标区域与运营商落地美西,用户侧国内三网
关键指标连通率 ≥99%、P95 时延 ≤180ms、单流 ≥50Mbps
预算每月 ≤10 美元/节点
约束是否允许 CDN、是否需要 UDP、是否要抗主动探测

判断标准:如果用户只说"要快",必须先追问"相对什么快"——首包时延、吞吐还是稳定性。三者优化手段互相冲突。

第 2 步:协议选型(按威胁模型选,不按热度选)

协议传输层抗主动探测抗 QoS 限速性能适用
VLESS + RealityTCP/TLS强(借用真实站点证书)中高无自有域名、需强伪装
VLESS + XTLS-VisionTCP/TLS中中最高(免二次加密)自有域名 + 直连
TrojanTCP/TLS中(回落站点)中中高有域名,配置简单
Shadowsocks-2022TCP/UDP弱-中(无 TLS 外观)弱高内网/中转链路
Hysteria2QUIC/UDP中强(UDP 拥塞控制激进)高(弱网优势明显)高丢包链路
TUICQUIC/UDP中强高同上,多路复用更好
WireGuardUDP弱(可识别)弱最高点对点/隧道内层
mKCPUDP弱中中(耗流量)极端丢包环境
gRPC / WS over TLSTCP/TLS中弱中必须过 CDN 时

选型决策树:

  1. 没有自有域名 → Reality。
  2. 有域名 + 追求吞吐 → VLESS + Vision,flow=xtls-rprx-vision。
  3. 链路丢包 >3% → Hysteria2(UDP 拥塞控制比 TCP 更耐受)。
  4. 必须走 CDN → WS 或 gRPC over TLS,CDN 侧只开 443。
  5. 内网或已被信任的隧道 → Shadowsocks-2022 或 WireGuard。

第 3 步:链路拓扑设计

四种基本拓扑,按用户数增长演进:

拓扑结构优点代价
直连用户 → 落地时延最低落地 IP 易被封
单跳中转用户 → 中转 → 落地落地 IP 隐藏,可换落地多一跳时延
隧道链用户 → 入口 → 隧道 → 出口 → 落地入口抗封,链路可编排配置复杂,排查难
CDN 前置用户 → CDN → 落地IP 不暴露仅 TCP,性能损失,CDN 侧有日志

拓扑设计三条硬规则:

  1. 入口与落地分离:入口负责抗封锁,落地负责出口 IP。两者角色不要混在一个节点上。
  2. 每增加一跳,P95 时延增加 20-60ms,超过 3 跳用户体验崩塌,除非中转与落地在同一机房。
  3. 必须有一条备用路径,且切换时间 ≤30 秒(脚本自动切换)。

用 Mermaid 画出拓扑,节点标注:位置、协议、端口、角色(入口/中转/落地)。

第 4 步:服务端部署(Xray / sing-box 二选一)

标准流程:

  1. 选 VPS:优先选落地地区的原生 IP(非广播段),确认是否被标记为数据中心 IP(影响流媒体与风控)。
  2. 系统初始化:更新内核(BBR 需要 4.9+,建议 5.15+)、时区、SSH 端口与密钥登录、防火墙只放行必要端口。
  3. 安装内核:官方脚本安装 Xray 或 sing-box,用 systemd 托管,开启开机自启。
  4. 证书:有域名用 ACME 自动签发与续期(HTTP-01 或 DNS-01);无域名用 Reality 借用目标站点的证书链。
  5. 配置:服务端与客户端配置必须逐字段对应(UUID/密码、端口、传输、TLS 参数、SNI、路径)。
  6. 验收:本地用客户端连一次,跑通 DNS 解析、TCP、UDP(若启用)三类流量。

配置核对清单(最容易错的 8 处):UUID 大小写、flow 参数只在 TCP+TLS 下有效、WS 的 path 前后斜杠、gRPC 的 serviceName、Reality 的 publicKey 与 shortId 配对、SNI 与服务端证书一致性、端口是否被云厂商安全组放行、时间同步(时间偏差 >90 秒会导致 TLS 失败)。

第 5 步:性能调优

层面参数建议值说明
内核拥塞控制拥塞算法bbr + fqnet.ipv4.tcp_congestion_control=bbr,default_qdisc=fq
MTU/MSSTCP MSS1380-1420隧道内层需 clamp,防分片黑洞
文件描述符nofile65535高并发必须调
缓冲rmem/wmem max16MB长肥管道(高带宽高时延)必须
多路复用mux并发 8-16,关闭 TCP 快速打开减少握手开销,过高会队头阻塞
端口跳跃Hysteria2 端口范围20000-50000对抗 UDP QoS
DNS解析方式远端解析 + 分流防 DNS 泄漏与污染
UDP是否启用按需游戏/语音需要,会增大被限速概率

调优纪律:一次只改一项,改完跑同一套测速(同一目标、同一时段、3 次取中位数)。不做对照的调优都是玄学。

第 6 步:稳定性与故障切换

  • 健康检查:每 30 秒做一次 TCP 握手 + 一次 TLS 握手 + 一次小请求,三项全过才算健康。
  • 切换策略:连续 3 次失败标记不可用,切备用;连续 5 次成功恢复主用。
  • 订阅管理:节点列表与规则分离,规则用远程规则集,节点用订阅链接,便于批量更新。
  • 日志:只保留连接元数据(时间、目标、耗时、流量),不记录内容;日志轮转 7 天。
  • 监控指标:连通率、P95 时延、失败率、每节点流量、异常断开次数。

第 7 步:流量特征分析与对抗

要分析的特征(用于自评链路是否"看起来正常"):

特征正常 TLS 的样子代理链路易暴露的点
握手完整 ClientHello,含常见扩展与 SNI扩展缺失、顺序异常、SNI 与证书不匹配
指纹主流浏览器 JA3/JA4客户端库默认指纹(Go/Python TLS 栈)
包长分布与应用协议一致固定包长、周期性心跳
时序请求-响应有间隔恒定间隔心跳、整点重连
端口443/80/常见高位端口长期固定冷门端口
主动探测正常站点会返回真实页面探测时返回空响应或异常 RST

对抗手段(按有效性排序):uTLS 指纹伪装 → 真实站点回落 → Reality 借用真证书 → 心跳随机化 → 端口分散与轮换。

自评方法:在链路两端抓包(tcpdump 只抓头部),统计包长分布与握手特征,与同区域直连访问同一站点的流量做对比。差异越大越容易被识别。

第 8 步:批量节点与订阅

  • 命名规范:地区-角色-协议-序号(如 us-la-vless-01),便于脚本批量操作。
  • 批量操作:用同一份模板 + 变量替换生成配置,避免手改多份。
  • 订阅生成:把节点列表转成客户端可识别的订阅格式,配置分流的规则集走远程 URL,便于统一更新。
  • 变更管理:任何节点变更前先导出当前可用配置作为回滚点。

第 9 步:排障顺序(固定顺序,不要跳)

  1. 本机网络是否正常(直连访问目标地区站点)。
  2. DNS 是否解析正确(是否被污染)。
  3. TCP 是否能握手(端口/安全组/防火墙)。
  4. TLS 是否能完成(证书、时间同步、SNI)。
  5. 协议层是否匹配(UUID/密码/flow/传输参数)。
  6. 是否有流量但无响应(路由规则、出口 IP 被限)。
  7. 吞吐低但连通正常(拥塞控制、MTU、多路复用、VPS 带宽上限)。

每步给出判定命令与预期输出,不要"重启试试"。

交付物

文件名格式内容要求
链路拓扑图.mdMarkdown + Mermaid节点(位置/角色/协议/端口)+ 备用路径
协议选型对比表.csvCSV协议 × 抗探测/性能/时延/维护成本/适用场景
服务端配置清单.mdMarkdown系统初始化步骤、内核参数、服务配置要点、核对清单
客户端配置清单.mdMarkdown与服务器逐字段对应表、分流规则、DNS 设置
性能调优参数表.csvCSV参数/当前值/建议值/预期影响/验证方法
流量特征分析.mdMarkdown抓包对比结论、暴露点、整改动作
健康检查脚本Python多节点连通/时延/失败率探测 + 故障切换判定,见 scripts/health_check.py

文件默认落在工作目录的 proxy-<项目名>/ 下。

验证方式

  1. 端到端可用:按交付的配置清单从零搭一遍,客户端能完成 DNS、TCP、UDP(若声明支持)三类流量,成功率 100%。
  2. 指标可测:连通率、P95 时延、吞吐三项都有实测数据(命令 + 时间 + 次数),且达到第 1 步设定的目标值。
  3. 配置逐字段对应:服务端与客户端配置表的字段逐条比对,无遗漏、无冲突(重点核对 UUID/flow/SNI/path/serviceName)。
  4. 调优有对照:每个调优项都有改动前后的同一测速结果,至少 3 次取中位数;无对照的调优项不计入交付。
  5. 故障切换有效:手动停掉主节点,备用路径在 30 秒内接管,且脚本日志能看到判定过程。
  6. 特征自评有数据:流量特征分析必须基于实际抓包统计(包长分布、握手特征),不能只写结论。
  7. 脚本可跑:scripts/health_check.py 的 --help 退出码 0,非法参数退出码 2,正常运行输出每个节点的连通率与延迟分位,并对不健康节点返回退出码 1。
D:\Python\python.exe scripts\health_check.py --nodes nodes.json --rounds 3 --timeout 3

参考文档

  • references/proxy-engineering.md — 协议报文与握手细节、Reality/Vision/Hysteria2 关键参数、内核调优参数、流量特征指标、排障命令表。设计与排障前读。

使用边界

本 skill 提供网络传输工程方法论。实际部署需遵守节点所在地与用户所在地的网络与出口管制法规,以及云服务商的可用条款。

slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall