跳到主要内容

命令行工具

这个页面介绍如何使用LibCyber的命令行工具cyber。

安装​

当前最新版本：v1.2.1

一键脚本安装（推荐）​

提醒

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核心