命令行工具
这个页面介绍如何使用LibCyber的命令行工具cyber。
安装
当前最新版本：v1.1.0
一键脚本安装（推荐）
Linux下使用建议在root用户（非sudo）下安装，否则设置开机自启动和开启TUN模式时，可能会出现权限问题。
wget -O getcyber.sh getcyber.sh && bash getcyber.sh
手动安装（受限环境下使用）
如果你的系统环境不具备真正的sudo权限、无法访问dbus、在容器内（使用共享GPU、AI模型租赁服务时可能遇到）、无法使用systemd服务等，按照如下步骤安装。注意，这种方式安装的cyber内核不会开机自启动，每次重启服务器后，需要手动执行一次cyber core start才能正常使用。
# 下载
wget https://getcyber.sh/cyber.tar.gz -O cyber.tar.gz
# 解压
tar -zxvf cyber.tar.gz
# 进入目录
cd cyber
# 添加可执行权限
sudo chmod +x cyber
# 移动到环境变量PATH目录下
sudo mv cyber /usr/bin/
# 登录（交互式输入用户名和密码）
cyber login
# 初始化cyber配置
cyber init
使用
cyber --help
长话短说
# 1. 获取代理配置指令。
cyber proxy shell
# 2. 复制上面指令输出结果，执行。
# export http_proxy=http://127.0.0.1:8890;export https_proxy=http://127.0.0.1:8890;export all_proxy=socks5://127.0.0.1:8891
# 3. 使用curl、wget等命令测试代理是否生效。
curl ip.sb
# 2. 了解如何使用LibCyber代理。
cyber proxy readme
# 如果不想手动配置代理，可以开启TUN模式，自动接管系统所有流量（实验性）
# cyber tunnel on
详细介绍
账号管理相关
# 交互式登录
cyber login
# 通过命令行参数方式，传入用户名和密码进行登录
cyber login -u <用户名> -p <密码>
# 登出
cyber logout
# 查看当前登录账号信息
cyber info
节点管理相关
# 下载节点配置
cyber node download
# 更新节点配置
cyber node update
# 查看节点列表
cyber node list
# 切换节点
cyber node change <节点名称>
# 批量延迟测试
cyber node benchmark
流量转发程序相关
# 下载流量转发程序
cyber core download
# 启动流量转发程序
cyber core start
# 停止流量转发程序
cyber core stop
# 查看流量转发程序运行状态
cyber core status
# 开机自启动（仅支持Linux，并且需要先以root权限安装Systemd服务，详情见下面Systemd服务相关说明）
cyber core enable
# 取消开机自启动（仅支持Linux，并且需要先以root权限安装Systemd服务，详情见下面Systemd服务相关说明）
cyber core disable
路由模式相关
# 查看路由模式
cyber mode show
# 切换路由模式，路由模式名称为rule或global
cyber mode change <路由模式名称>
代理配置相关
# 查看代理端口信息
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
# 查看更多代理设置说明
cyber proxy readme
TUN模式相关
# 开启、关闭TUN模式
cyber tunnel on
cyber tunnel off
Systemd服务相关
# 安装、删除Systemd服务
cyber service install
cyber service uninstall
配置管理
# 打开并编辑配置文件
cyber config edit
# 开启、关闭API Endpoint密钥访问
cyber config secret on
cyber config secret off
汉化、切换语言
# 切换中文（翻译不完全）
cyber language zh
# 切换英文
cyber language en
查看版本
cyber version
命令补全相关
# bash
cyber completion bash > /etc/bash_completion.d/cyber
# zsh
cyber completion zsh > "${fpath[1]}/_cyber"
# fish
cyber completion fish > ~/.config/fish/completions/cyber.fish
重启终端后才能生效。
其他功能
# 问题排查
cyber doctor
# 删除所有配置文件和用户数据
cyber purge
查看帮助
cyber --help
一键停止并删除
准备一个脚本文件，例如cyber-remove.sh，内容如下：
#!/bin/bash
set -e
cyber core stop
cyber purge -f
rm -rf /usr/bin/cyber /usr/bin/cyber-core /usr/local/bin/cyber /usr/local/bin/cyber-core
rm -rf /usr/local/cyber/ ~/.cyber/core/ /etc/cyber-core/ /etc/cyber/ /var/log/cyber-core/ /var/log/cyber/
rm -f /etc/systemd/system/cyber-core.service
systemctl daemon-reload
systemctl reset-failed
echo "Cyber has been removed successfully."
执行以下命令：
chmod +x cyber-remove.sh
./cyber-remove.sh
常见问题
1. 安装完毕后运行时报错：cyber: command not found ？
请检查Linux当前环境变量中是否包含/usr/bin，如果没有，请手动添加。先执行 export PATH=$PATH:/usr/bin 添加到当前终端会话，然后再次执行 cyber --help 查看是否正常。该方法仅在当前终端会话有效，如果需要永久生效，请将 export PATH=$PATH:/usr/bin 添加到 ~/.bashrc 或 ~/.zshrc （您使用的shell配置文件）中，然后执行 source ~/.bashrc 或 source ~/.zshrc 使其生效。
2. 重启服务器后无法连接网络
如果是按照手动安装步骤配置的，cyber-core不会开机自启动，需要手动执行一次cyber core start（或者确保系统中systemd服务已经安装并且正常使用，然后执行cyber service install和cyber core enable使用开机自启动功能）。
3. 安全性加强
如果担心上网过程遇到针对cyber核心的跨域攻击，可以运行cyber config edit修改cyber核心的配置文件，将external-controller: 127.0.0.1:xxx的xxx部分修改成1000-65535范围内的任意其他数字（或者运行cyber config secret on），然后通过cyber core restart重启cyber核心