命令行工具
这个页面介绍如何使用LibCyber的命令行工具cyber。
安装
当前最新版本：v2.0.2
一键脚本安装（推荐）
Linux下使用建议在root用户（非sudo）下安装，否则设置开机自启动和开启TUN模式时，可能会出现权限问题。
curl -fsSL https://getcyber.sh | bash
安装完成后运行 cyber 进入初始化向导。
手动安装（受限环境下使用）
如果你的系统环境不具备真正的sudo权限、无法访问dbus、在容器内（使用共享GPU、AI模型租赁服务时可能遇到）、无法使用systemd服务等，按照如下步骤手动安装。注意，这种方式安装后引擎不会开机自启动，每次重启服务器后，需要手动执行一次cyber engine start才能正常使用。
# 下载（以 Linux x86_64 为例，ARM64 请将 amd64 替换为 arm64）
wget https://getcyber.sh/download/cyber-linux-amd64.tar.gz
# 解压
tar -zxvf cyber-linux-amd64.tar.gz
# 安装到系统目录
sudo install -m 755 cyber /usr/local/bin/cyber
sudo install -m 755 cyber-engine /usr/local/bin/cyber-engine
# 运行（首次运行自动进入初始化向导）
cyber
向导会引导你完成：
- 登录 LibCyber 账号
- 下载节点配置
- 安装 systemd 服务（仅 root + systemd 环境）
- 启动引擎
仪表盘
直接运行 cyber（无参数）进入 TUI 仪表盘，在仪表盘中可以通过快捷键快速操作：
| 快捷键 | 功能 |
|---|---|
n | 切换节点 |
m | 切换模式（规则/全局） |
t | 开关 TUN 隧道 |
b | 节点测速 |
d | 系统诊断 |
l | 查看日志 |
i | 用户信息 |
r | 重启引擎 |
q | 退出 |
使用
cyber --help
快速上手
# 1. 获取代理配置指令
cyber proxy shell
# 2. 复制上面指令输出结果，执行
# export http_proxy=http://127.0.0.1:7890;export https_proxy=http://127.0.0.1:7890;export all_proxy=socks5://127.0.0.1:7891
# 3. 使用curl、wget等命令测试代理是否生效
curl ip.sb
# 如果不想手动配置代理，可以开启TUN模式，自动接管系统所有流量
# cyber tunnel on
详细介绍
账号管理
# 交互式登录（进入TUI登录界面）
cyber login
# 通过命令行参数方式登录
printf '%s\n' '你的密码' | cyber login -u 你的用户名 --password-stdin
# 登录并同时下载节点配置
printf '%s\n' '你的密码' | cyber login -u 你的用户名 --password-stdin -d
引擎管理
# 启动引擎
cyber engine start
# 停止引擎
cyber engine stop
# 重启引擎
cyber engine restart
# 查看引擎运行状态
cyber engine status
# 下载引擎
cyber engine download
# 查看引擎日志
cyber engine log
# 查看原始日志
cyber engine log --raw
节点管理
# 查看节点列表（交互式）
cyber node list
# 下载/更新节点配置
cyber node download
cyber node update
# 切换节点
cyber node change <节点名称>
# 节点测速
cyber node benchmark
路由模式
# 查看路由模式
cyber mode show
# 切换路由模式（rule 或 global）
cyber mode change <路由模式名称>
# 交互式选择
cyber mode
代理配置
# 查看代理端口信息
cyber proxy info
# 配置git代理
cyber proxy git
# 取消git代理
cyber proxy unset git
# 配置npm代理
cyber proxy npm
# 取消npm代理
cyber proxy unset npm
# 配置yarn代理
cyber proxy yarn
# 取消yarn代理
cyber proxy unset yarn
# 配置pnpm代理
cyber proxy pnpm
# 取消pnpm代理
cyber proxy unset pnpm
# 输出shell环境变量（用于eval）
cyber proxy shell
TUN模式
# 开启TUN模式（接管系统所有流量）
cyber tunnel on
# 关闭TUN模式
cyber tunnel off
# 查看TUN状态
cyber tunnel
配置管理
# 交互式编辑引擎配置（端口、DNS等）
cyber config edit
语言切换
cyber language zh # 中文
cyber language en # English
cyber language ja # 日本語
cyber language ko # 한국어
cyber language ru # Русский
检查更新
cyber update
系统诊断
cyber doctor
查看版本
cyber version
卸载
使用 purge 命令
cyber purge
按提示输入 purge 确认，将删除所有配置和数据文件。如需跳过确认：
cyber purge --force
手动卸载
如果 cyber purge 无法使用，可以手动清理：
#!/bin/bash
set -e
cyber engine stop 2>/dev/null || true
rm -f /usr/local/bin/cyber /usr/local/bin/cyber-engine
rm -rf /etc/cyber/ /var/lib/cyber/ /var/log/cyber/
rm -rf ~/.config/cyber/ ~/.local/share/cyber/ ~/.local/state/cyber/
rm -f /etc/systemd/system/cyber.service
systemctl daemon-reload 2>/dev/null || true
systemctl reset-failed 2>/dev/null || true
echo "Cyber has been removed successfully."
卸载老版本 cyber（1.x）
如果你之前安装过 1.x 版本的 cyber，需要先卸载旧版本再安装 v2。1.x 版本的二进制名、配置路径和 systemd 服务名与 v2 不同，直接安装 v2 不会自动清理旧版本的残留文件。
#!/bin/bash
set -e
# 停止旧版引擎
cyber core stop 2>/dev/null || true
# 尝试执行旧版清理
cyber purge -f 2>/dev/null || true
# 删除旧版二进制文件
rm -f /usr/bin/cyber /usr/bin/cyber-core /usr/local/bin/cyber-core
# 删除旧版配置和数据目录
rm -rf ~/.cyber/ /etc/cyber-core/ /var/log/cyber-core/
# 删除旧版 systemd 服务
rm -f /etc/systemd/system/cyber-core.service
systemctl daemon-reload 2>/dev/null || true
systemctl reset-failed 2>/dev/null || true
echo "Cyber 1.x has been removed successfully."
清理完成后，按照上方安装步骤安装 v2 即可。
常见问题
1. 安装完毕后运行时报错：cyber: command not found
请检查Linux当前环境变量中是否包含/usr/local/bin，如果没有，请手动添加。先执行 export PATH=$PATH:/usr/local/bin 添加到当前终端会话，然后再次执行 cyber --help 查看是否正常。该方法仅在当前终端会话有效，如果需要永久生效，请将 export PATH=$PATH:/usr/local/bin 添加到 ~/.bashrc 或 ~/.zshrc 中，然后执行 source ~/.bashrc 或 source ~/.zshrc 使其生效。
2. 重启服务器后无法连接网络
如果是按照手动安装步骤配置的，引擎不会开机自启动，需要手动执行一次cyber engine start。如果需要开机自启动，请以root权限运行 cyber，在向导中安装systemd服务。
3. 安全性加强
如果担心上网过程遇到针对引擎的跨域攻击，可以运行cyber config edit修改引擎配置文件，将external-controller的端口部分修改成1000-65535范围内的任意其他数字，然后通过cyber engine restart重启引擎。