跳至内容
OpenWRT 系统服务安装

OpenWRT 系统服务安装

在 OpenWRT 上安装 ikuai-bypass (Rust 版) 为系统服务

💡 推荐使用一键安装,详见快速上手 - 一键安装。两种方式:

  • OpenWrt LuCI 面板 — 可视化管理,IPK 一行搞定
  • Linux CLI 服务 — 命令行 + WebUI

以下为手动安装步骤,适用于需要自定义安装路径或离线安装的场景(内容可能已经过期,你可以丢给ai参考)。

手动安装方式(适用于离线/自定义场景)

环境要求

  • OpenWRT x64 / ARM / MIPS 等架构(Linux 内核 5.4+ 测试通过)
  • 已安装 unzip 和 wget:
opkg update && opkg install unzip wget

一、下载与安装

# 可选:GitHub 代理(如直连则跳过)
export GhProxy=https://ghp.ci/

# 自动检测架构,选择正确的发布包
case "$(uname -m)" in
  x86_64|amd64)     ARCH="x86_64" ;;
  i686|i386)        ARCH="x86_32" ;;
  aarch64|arm64)    ARCH="aarch64" ;;
  armv5*|arm926*)   ARCH="arm5" ;;
  armv6*|arm1176*)  ARCH="arm6" ;;
  armv7*|cortex-a*) ARCH="arm7" ;;
  mips)             ARCH="mips" ;;
  mipsel)           ARCH="mipsle" ;;
  riscv64)          ARCH="riscv64gc" ;;
  *)                echo "不支持的架构: $(uname -m)"; exit 1 ;;
esac
echo ${ARCH}

# 设置版本(可从 Releases 页面查看最新 tag)
# 自动获取最新版本(需 opkg install jq):
# IKB_VERSION=$(wget -qO- https://api.github.com/repos/joyanhui/ikuai-bypass/releases/latest | grep '"tag_name"' | cut -d'"' -f4)
# 手动指定版本:
IKB_VERSION="4.4.105-alpha.5"
# 创建目录 可以使用其他目录 需要sudo/root权限
mkdir -p /opt/ && cd /opt/
wget "${GhProxy}https://github.com/joyanhui/ikuai-bypass/releases/download/${IKB_VERSION}/ikuai-bypass-cli-linux-${ARCH}.zip"
unzip ikuai-bypass-cli-linux-${ARCH}.zip && rm -f ikuai-bypass-cli-linux-${ARCH}.zip

# 使用仓库内的演示配置
rm -f config.yml
wget "${GhProxy}https://raw.githubusercontent.com/joyanhui/ikuai-bypass/main/config.yml" -O ikuai-bypass.yml

# 赋予执行权限
chmod +x /opt/ikuai-bypass

二、手动测试运行

# 先手动执行一次,确认配置正确
/opt/ikuai-bypass -r once -c /opt/ikuai-bypass.yml

三、创建开机服务

也使用其他方式,这里用最简的init.d方式。如果是systemd致畸性复制下面内容 粘贴给ai获取systemd写法

cat > /etc/init.d/ikuai-bypass << 'EOF'
#!/bin/sh /etc/rc.common

START=99
STOP=10

start() {
    /opt/ikuai-bypass -r cronAft -c /opt/ikuai-bypass.yml > /dev/null 2>&1 &
    echo "ikuai-bypass is start"
}

stop() {
    killall -q -9 ikuai-bypass 2>/dev/null
    echo "ikuai-bypass is stop"
}

restart() {
    stop
    sleep 1
    start
}
EOF

chmod +x /etc/init.d/ikuai-bypass
service ikuai-bypass enable
service ikuai-bypass start
ps | grep ikuai-bypass

四、管理命令

service ikuai-bypass start     # 启动
service ikuai-bypass stop      # 停止
service ikuai-bypass restart   # 重启
service ikuai-bypass enable    # 开机自启
service ikuai-bypass disable   # 关闭自启

五、卸载清理

service ikuai-bypass stop
service ikuai-bypass disable
rm -f /etc/init.d/ikuai-bypass
rm -rf /opt/ikuai-bypass
rm -f /opt/ikuai-bypass.yml

六、参数说明

完整的 CLI 参数说明请查看 CLI 参数说明。