← Back to Skills Marketplace
veteran-cli

Veteran

by veteran-cli · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ✓ Security Clean
46
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install veteran-proxy
Description
一个跨平台代理客户端，支持订阅管理、多节点切换、SOCKS5/HTTP 代理及灵活分流规则配置。
README (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
Usage Guidance
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.
Capability Assessment
ℹ 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.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install veteran-proxy
  3. After installation, invoke the skill by name or use /veteran-proxy
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
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.
Metadata
Slug veteran-proxy
Version 1.0.1
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is Veteran?

一个跨平台代理客户端，支持订阅管理、多节点切换、SOCKS5/HTTP 代理及灵活分流规则配置。 It is an AI Agent Skill for Claude Code / OpenClaw, with 46 downloads so far.

How do I install Veteran?

Run "/install veteran-proxy" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Veteran free?

Yes, Veteran is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Veteran support?

Veteran is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Veteran?

It is built and maintained by veteran-cli (@veteran-cli); the current version is v1.0.1.

More 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.
⬇ 191115 · 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

💬 Comments