← 返回 Skills 市场
veteran-cli

Veteran

作者 veteran-cli · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ✓ 安全检测通过
46
总下载
0
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install veteran-proxy
功能描述
一个跨平台代理客户端，支持订阅管理、多节点切换、SOCKS5/HTTP 代理及灵活分流规则配置。
使用说明 (SKILL.md)

veteran — 节点代理客户端

基于 sing-box 的跨平台代理客户端，支持订阅管理、多节点切换、SOCKS5/HTTP 代理、分流规则。

安装

从 Releases 下载对应平台二进制，或从源码编译：

git clone https://github.com/yongjie0203/veteran.git
cd veteran
make build

快速开始

# 1. 更新订阅
./veteran sub -u "https://your-subscription-url"

# 2. 查看节点
./veteran list

# 3. 启动代理（默认后台运行，端口1088）
./veteran run -n 1

# 4. 查看状态
./veteran status

# 5. 停止
./veteran stop

命令参考

veteran sub — 更新订阅

veteran sub -u \x3C订阅URL>
参数 说明
-u, --url 订阅链接 URL（必填）

支持协议：vless:// vmess:// ss:// trojan:// hysteria2://

veteran list — 列出节点

veteran list

显示所有已订阅节点的索引、协议类型、名称和服务器地址。

veteran run — 启动代理

veteran run -n \x3C节点> [-p \x3C端口>] [-m \x3C模式>] [-f] [--rule ...] [--rule-file ...]
参数 说明 默认值
-n, --node 节点索引(从1开始)或名称（必填） -
-p, --port 本地监听端口 1088
-m, --mode 分流模式（见下表） 2
-f, --foreground 前台运行（输出到终端） 默认后台
--rule 自定义规则，可重复 -
--rule-file 从文件加载规则 -

分流模式

值 说明
0 绕过中国大陆地址
1 绕过局域网地址
2 绕过中国大陆和局域网地址（默认）
3 全局代理
4 自定义规则（需配合 --rule 或 --rule-file）

veteran status — 查看状态

veteran status

veteran stop — 停止代理

veteran stop [-p \x3C端口>]
参数 说明
-p, --port 要停止的端口（不指定则停止所有）

分流规则

命令行方式：--rule

./veteran run -n 1 -m 4 \
  --rule "DOMAIN-SUFFIX,google.com,PROXY" \
  --rule "IP-CIDR,10.0.0.0/8,DIRECT" \
  --rule "FINAL,PROXY"

文件方式：--rule-file

./veteran run -n 1 -m 4 --rule-file ./rules.json

规则文件格式 (JSON)

{
  "china_domain": ["baidu", "zhihu", "weibo"],
  "china_cidr": ["114.114.114.0/24"],
  "private_cidr": [
    "10.0.0.0/8",
    "172.16.0.0/12",
    "192.168.0.0/16",
    "127.0.0.0/12"
  ],
  "custom_rule": [
    "DOMAIN-SUFFIX,google.com,PROXY",
    "DOMAIN-SUFFIX,github.com,PROXY",
    "DOMAIN,www.baidu.com,DIRECT",
    "DOMAIN-KEYWORD,facebook,PROXY",
    "IP-CIDR,192.168.1.0/24,DIRECT",
    "IP,8.8.8.8,PROXY",
    "FINAL,PROXY"
  ]
}

字段说明

字段 类型 作用 生效模式
china_domain string[] 包含关键词的域名直连 0, 2, 4
china_cidr string[] (CIDR格式) IP 段直连 0, 2, 4
private_cidr string[] (CIDR格式) 局域网地址直连 1, 2, 4
custom_rule string[] 自定义规则（仅 -m 4 生效） 4

规则格式：TYPE,VALUE,POLICY

TYPE 说明 示例
DOMAIN-SUFFIX 域名后缀匹配 DOMAIN-SUFFIX,google.com,PROXY
DOMAIN-KEYWORD 域名关键词匹配 DOMAIN-KEYWORD,facebook,PROXY
DOMAIN 完整域名精确匹配 DOMAIN,www.baidu.com,DIRECT
IP-CIDR IP 网段匹配 IP-CIDR,10.0.0.0/8,DIRECT
IP 精确 IP 匹配 IP,8.8.8.8,PROXY
FINAL 默认兜底策略 FINAL,PROXY

POLICY 取值：

值 说明
DIRECT 直连，不走代理
PROXY 走代理
REJECT 拒绝连接

规则按优先级匹配：DOMAIN > DOMAIN-SUFFIX > DOMAIN-KEYWORD > IP-CIDR > IP > FINAL

环境变量

变量 说明 默认值
VETERAN_ALLOW_MULTIPLE 设为 true 允许多实例（不同端口） 禁用
VETERAN_DATA_DIR 数据目录 ~/.veteran

多实例

# 允许在不同端口启动多个代理
export VETERAN_ALLOW_MULTIPLE=true
./veteran run -n 1 -p 1088   # 节点1 → 端口1088
./veteran run -n 2 -p 1089   # 节点2 → 端口1089

数据目录

~/.veteran/
├── nodes.json              # 节点列表缓存
├── veteran.log             # 管理命令日志
├── veteran-1088.log        # 端口1088运行日志
├── veteran-1088.pid        # 端口1088进程ID
└── veteran-1089.log        # 端口1089运行日志

支持的协议

协议 代理链接格式 TLS 传输层
VLESS vless://uuid@host:port?params#name ✅ Reality/TLS tcp/ws/grpc/h2/quic
VMess vmess://base64(json) ✅ TLS tcp/ws/grpc/h2
Shadowsocks ss://base64@host:port#name ❌ tcp
Trojan trojan://pass@host:port?params#name ✅ TLS tcp/ws/grpc
Hysteria2 hysteria2://pass@host:port#name ✅ quic

构建

# 本地开发
make build

# 全平台交叉编译
make all

# 发布（含压缩包）
make release VERSION=v1.0.0

支持平台

系统 架构
macOS (darwin) amd64, arm64
Linux amd64, arm64, 386, armv6, armv7
Windows amd64, arm64, 386
安全使用建议
Before installing, verify the release or source repository you download separately, and only use subscription URLs from providers you trust because proxy subscriptions may contain server credentials and will affect how your network traffic is routed.
能力评估
ℹ Purpose & Capability
The stated purpose is a sing-box-based proxy client with subscriptions, node selection, local SOCKS5/HTTP proxying, and routing rules; those network and subscription capabilities are expected for this purpose and are described plainly.
✓ Instruction Scope
Runtime commands are user-directed and documented, including updating subscriptions, listing nodes, starting/stopping the proxy, selecting ports, and applying routing rules.
ℹ Install Mechanism
The package manifest declares platform binary paths under bin/, but the submitted artifact contains only documentation and an example rules file; installation instructions point users to releases or a GitHub source build rather than executing bundled install code.
ℹ Credentials
Opening a local proxy port, running in the background by default, and storing node/cache/log data are proportionate to a proxy client and are disclosed in the skill text.
ℹ Persistence & Privilege
The skill describes PID files, logs, and cached nodes under ~/.veteran and a stop command; it does not show autostart registration, privilege escalation, credential theft, or hidden persistence.
如何使用
  1. 确保已安装 OpenClaw（本地或 Docker 部署）
  2. 在对话框中输入安装命令：/install veteran-proxy
  3. 安装完成后，直接呼叫该 Skill 的名称或使用 /veteran-proxy 触发
  4. 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.1
- Removed the file skill-card.md. - No other user-facing changes or new features.
v1.0.0
Initial release of veteran-proxy. - Cross-platform proxy client based on sing-box, supporting multiple protocols (VLESS, VMess, Shadowsocks, Trojan, Hysteria2). - Features subscription management, multi-node switching, SOCKS5/HTTP proxy, and custom routing rules. - Provides CLI commands for updating subscriptions, listing nodes, running/stopping the proxy, and checking status. - Supports rule-based and file-based traffic routing with flexible configuration. - Allows multiple proxy instances on different ports with environment variable configuration. - Detailed documentation for installation, usage, rule formats, and supported platforms.
元数据
Slug veteran-proxy
版本 1.0.1
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 2
常见问题

Veteran 是什么？

一个跨平台代理客户端，支持订阅管理、多节点切换、SOCKS5/HTTP 代理及灵活分流规则配置。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 46 次。

如何安装 Veteran？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install veteran-proxy」即可一键安装，无需额外配置。

Veteran 是免费的吗？

是的，Veteran 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。

Veteran 支持哪些平台？

Veteran 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Veteran？

由 veteran-cli（@veteran-cli）开发并维护，当前版本 v1.0.1。

推荐 Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191113 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 留言讨论