VLAN Linux 客户端管理技能

用于管理 VLAN.CN 虚拟组网 Linux 客户端的安装、配置和日常操作。

触发条件

当用户询问以下相关内容时触发：

VLAN.CN Linux 客户端安装
vlancli 命令使用
组网连接/断开
登录/账号管理
服务控制（启动/停止/重启）
网络诊断和调试

系统要求

支持的发行版

Ubuntu: 18.04 及以上
Debian: 10 及以上
CentOS: 7 及以上
Fedora: 30 及以上
Arch Linux

核心命令参考

安装命令

curl -kfsSL http://dl.vlan.cn/vlan2.0/linux/install.sh | sh

基础用法

vlancli [options] command

常用选项:

选项	说明
`-b, --batch`	非交互模式 (静默执行)
`-c, --config=DIR`	指定配置文件目录
`-d, --loglevel=num`	日志级别 (1:Info, 2:Debug, 3:Trace)
`--help`	显示帮助信息

账号登录

方式一：登录码登录（推荐）

vlancli login login_code_dRGulkXga4ia1zf38kekc6hi

优势：无需每次输入密码，登录码有效期 30 分钟自动刷新

方式二：用户名密码登录

vlancli login <用户名> <密码> [服务器地址]
# 示例
vlancli login myuser mypassword

连接组网流程

# 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 客户端？

回复：

# 使用官方一键安装脚本
curl -kfsSL http://dl.vlan.cn/vlan2.0/linux/install.sh | sh

# 安装完成后，使用登录码登录（推荐）
vlancli login <你的登录码>

# 启动服务
vlancli start

# 查看可用组网
vlancli getvlanlist

# 连接到组网
vlancli connect <组网 ID>

示例 2: 日常连接

用户：帮我连接到 VLAN 组网

回复：

# 检查服务状态
vlancli status

# 如果未启动，先启动服务
vlancli start

# 查看可用组网
vlancli getvlanlist

# 连接到指定组网（替换 <ID> 为实际组网 ID）
vlancli connect <ID>

# 验证连接
vlancli info

示例 3: 故障排查

用户：VLAN 连接不上，怎么排查？

回复：

# 1. 检查服务状态
vlancli status

# 2. 查看本机信息和连接状态
vlancli info

# 3. 提高日志级别进行调试
vlancli debug 3

# 4. 查看网络路径和延迟
vlancli dump paths

# 5. 查看边缘节点信息
vlancli dump edges

# 6. 尝试重启服务
vlancli restart

注意事项

登录安全：推荐使用登录码方式，避免在命令行历史中留下密码
登录码有效期：登录码仅 30 分钟有效，超时需重新生成
权限要求：部分命令可能需要 sudo 权限
防火墙：确保系统防火墙允许 VLAN 客户端的网络流量
网络依赖：客户端需要能访问 api.vlan.cn 服务器

常见问题

Q: 登录后提示认证失败？

A: 检查登录码是否过期（30 分钟有效期），或用户名密码是否正确

Q: 连接组网后无法访问资源？

检查 vlancli status 确认服务运行正常
使用 vlancli info 查看本机获取的 IP 地址
检查防火墙规则
尝试 vlancli dump paths 查看网络路径

Q: 如何完全卸载？

A: 运行安装脚本时添加卸载参数，或手动删除：

# 停止服务
vlancli stop

# 删除客户端文件（具体路径参考安装文档）
sudo rm -rf /usr/local/vlan

技能版本: 1.0
最后更新: 2026-03-18
适用客户端: VLAN.CN Linux Client v2.0

VLAN Linux Client

Safety Notice

Copy this and send it to your AI assistant to learn