Skill: sxf-oss/vlan-linux-client (version 1.0.0)

# VLAN Linux 客户端管理技能 用于管理 VLAN.CN 虚拟组网 Linux 客户端的安装、配置和日常操作。 ## 触发条件 当用户询问以下相关内容时触发： - VLAN.CN Linux 客户端安装 - vlancli 命令使用 - 组网连接/断开 - 登录/账号管理 - 服务控制（启动/停止/重启） - 网络诊断和调试 ## 系统要求 ### 支持的发行版 - Ubuntu: 18.04 及以上 - Debian: 10 及以上 - CentOS: 7 及以上 - Fedora: 30 及以上 - Arch Linux ## 核心命令参考 ### 安装命令 ```bash curl -kfsSL http://dl.vlan.cn/vlan2.0/linux/install.sh | sh ``` ### 基础用法 ```bash vlancli [options] command ``` **常用选项:** | 选项 | 说明 | |------|------| | `-b, --batch` | 非交互模式 (静默执行) | | `-c, --config=DIR` | 指定配置文件目录 | | `-d, --loglevel=num` | 日志级别 (1:Info, 2:Debug, 3:Trace) | | `--help` | 显示帮助信息 | ### 账号登录 **方式一：登录码登录（推荐）** ```bash vlancli login login_code_dRGulkXga4ia1zf38kekc6hi ``` 优势：无需每次输入密码，登录码有效期 30 分钟自动刷新 **方式二：用户名密码登录** ```bash vlancli login <用户名> <密码> [服务器地址] # 示例 vlancli login myuser mypassword ``` ### 连接组网流程 ```bash # 1. 启动服务 vlancli start # 2. 获取组列表 vlancli getvlanlist # 3. 连接至指定组 vlancli connect <VlanID> ``` ### 服务控制 | 动作 | 命令 | 说明 | |------|------|------| | 启动 | `vlancli start` | 启动后台服务 | | 停止 | `vlancli stop` | 停止后台服务 | | 重启 | `vlancli restart` | 重启后台服务 | | 状态 | `vlancli status` | 查看后台服务运行状态 | ### 组网管理 | 功能 | 命令 | 说明 | |------|------|------| | 查看组列表 | `vlancli getvlanlist` | 显示已加入的虚拟网组 | | 连接组 | `vlancli connect <VlanID>` | 连接指定组 | | 断开连接 | `vlancli disconnect <VlanID>` | 断开与指定组的连接 | | 查看节点 | `vlancli getnodelist <VlanID>` | 查看组内在线节点列表 | | 加入组 | `vlancli joinvlan <VlanID>` | 加入新的虚拟网组 | | 退出组 | `vlancli quitvlan <VlanID>` | 退出已加入的虚拟网组 | ### 调试与诊断 | 功能 | 命令 | 说明 | |------|------|------| | 本机信息 | `vlancli info` | 查看客户端运行状态及本机信息 | | 调试日志 | `vlancli debug <Level>` | 设置日志级别 (1-3) | | KCP 加速 | `vlancli usekcp <NodeID> <1\|0>` | 开启 (1) 或关闭 (0) 指定节点的 KCP 加速 | | 导出节点 | `vlancli dump edges` | 查看所有已知的边缘节点信息 | | 导出路径 | `vlancli dump paths` | 查看网络路径及延迟信息 | ## 使用示例 ### 示例 1: 首次安装和配置 用户：如何在 Linux 上安装 VLAN 客户端？ 回复： ```bash # 使用官方一键安装脚本 curl -kfsSL http://dl.vlan.cn/vlan2.0/linux/install.sh | sh # 安装完成后，使用登录码登录（推荐） vlancli login <你的登录码> # 启动服务 vlancli start # 查看可用组网 vlancli getvlanlist # 连接到组网 vlancli connect <组网 ID> ``` ### 示例 2: 日常连接 用户：帮我连接到 VLAN 组网 回复： ```bash # 检查服务状态 vlancli status # 如果未启动，先启动服务 vlancli start # 查看可用组网 vlancli getvlanlist # 连接到指定组网（替换 <ID> 为实际组网 ID） vlancli connect <ID> # 验证连接 vlancli info ``` ### 示例 3: 故障排查 用户：VLAN 连接不上，怎么排查？ 回复： ```bash # 1. 检查服务状态 vlancli status # 2. 查看本机信息和连接状态 vlancli info # 3. 提高日志级别进行调试 vlancli debug 3 # 4. 查看网络路径和延迟 vlancli dump paths # 5. 查看边缘节点信息 vlancli dump edges # 6. 尝试重启服务 vlancli restart ``` ## 注意事项 1. **登录安全**：推荐使用登录码方式，避免在命令行历史中留下密码 2. **登录码有效期**：登录码仅 30 分钟有效，超时需重新生成 3. **权限要求**：部分命令可能需要 sudo 权限 4. **防火墙**：确保系统防火墙允许 VLAN 客户端的网络流量 5. **网络依赖**：客户端需要能访问 api.vlan.cn 服务器 ## 常见问题 ### Q: 登录后提示认证失败？ A: 检查登录码是否过期（30 分钟有效期），或用户名密码是否正确 ### Q: 连接组网后无法访问资源？ A: 1. 检查 `vlancli status` 确认服务运行正常 2. 使用 `vlancli info` 查看本机获取的 IP 地址 3. 检查防火墙规则 4. 尝试 `vlancli dump paths` 查看网络路径 ### Q: 如何完全卸载？ A: 运行安装脚本时添加卸载参数，或手动删除： ```bash # 停止服务 vlancli stop # 删除客户端文件（具体路径参考安装文档） sudo rm -rf /usr/local/vlan ``` --- **技能版本**: 1.0 **最后更新**: 2026-03-18 **适用客户端**: VLAN.CN Linux Client v2.0


Security scan verdicts — ClawScan: suspicious | static analysis: suspicious | VirusTotal: clean | SkillSpector: suspicious (MEDIUM)