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