---

name: clash-vpn description: Manage Clash VPN proxy service for accessing blocked websites like Google Play. Use when the user needs to (1) setup/configure VPN proxy, (2) update Clash proxy configuration, (3) start/stop VPN service, (4) test proxy connectivity, or (5) access blocked resources through proxy.

Clash VPN 管理

此 Skill 用于管理 Clash VPN 代理服务，实现访问 Google Play 等被屏蔽的网站。

前置条件

• Clash 已安装: /usr/local/bin/clash
• 配置文件路径: /root/.config/clash/config.yaml
• 脚本路径: scripts/clash-vpn.sh

快速开始

1. 更新配置文件

用户提供新的 Clash 配置时:

# 使用脚本更新配置
cat << 'EOF' | scripts/clash-vpn.sh update
port: 7890
socks-port: 7891
# ... 完整配置内容 ...
EOF

或直接写入文件:

cat > /root/.config/clash/config.yaml << 'EOF'
# 配置内容
EOF

2. 启动 VPN

scripts/clash-vpn.sh start

3. 测试连接

scripts/clash-vpn.sh test

4. 查看状态

scripts/clash-vpn.sh status

代理地址

启动后使用以下代理地址:

类型	地址
HTTP	http://127.0.0.1:7890
SOCKS5	socks5://127.0.0.1:7891
Mixed	http://127.0.0.1:7893

使用代理访问网站

# HTTP 代理
curl --proxy http://127.0.0.1:7890 https://play.google.com

# SOCKS5 代理
curl --proxy socks5://127.0.0.1:7891 https://play.google.com

配置管理

配置模板

参考 references/config-guide.md 获取配置模板和字段说明。

配置更新流程

1. 接收用户的新配置内容
2. 使用脚本更新配置（自动备份旧配置）
3. 验证配置格式
4. 重启服务（如果正在运行）

配置备份

每次更新会自动创建备份:

/root/.config/clash/config.yaml.bak.YYYYMMDDHHMMSS

故障排查

查看日志

tail -f /var/log/clash.log

验证配置

clash -t -f /root/.config/clash/config.yaml

常见问题

1. DNS 端口被占用: 不影响使用，可忽略
2. MMDB 下载失败: 禁用 GEOIP 规则或手动下载
3. 连接失败: 检查节点配置和网络连接

脚本命令参考

scripts/clash-vpn.sh start     # 启动
scripts/clash-vpn.sh stop      # 停止
scripts/clash-vpn.sh restart   # 重启
scripts/clash-vpn.sh status    # 状态
scripts/clash-vpn.sh test      # 测试连接
scripts/clash-vpn.sh update    # 更新配置（从 stdin）
scripts/clash-vpn.sh help      # 帮助