#!/bin/sh # 卸载清理的唯一实现(F-14) # # 背景:卸载有三条路径,以前各写各的清单: # 1. isp-split uninstall(cmd_uninstall)——摘规则、删策略、删数据目录, # 但不删命名计数器 isp_fallback,也不删 /usr/sbin/isp-split 等文件 # 2. scripts/install.sh --uninstall——只删 LuCI 资源,脚本与配置全留着 # 3. 包 postrm——删 cron/计数器/confdir,包文件则由包管理器删 # 结果:Hermes 动态复现 install.sh --uninstall rc=0,而 # /usr/sbin/isp-split、/etc/init.d/isp-split、/usr/lib/isp-split/、 # /etc/isp-split.conf、isp_fallback 计数器、.conf.bak.* 全留着。 # # 现在三条路径都走这里,清单只有一份: # isp-split uninstall -> 先摘 mwan3 规则(要 rules-splice.awk),再 all # scripts/install.sh --uninstall -> 先调 isp-split uninstall(若在),再 all # 包 postrm -> 二进制还在就调本脚本 runtime;包文件已被删时 # 才走内联兜底(清单锚点由 selftest 第 21 节双向核对) # # 用法: # sh teardown.sh all # mwan3 段 + runtime 残留 + 文件 # sh teardown.sh mwan3 # 只删 mwan3 里 isp_split=1 的 ipset/rule/policy/member/interface # sh teardown.sh runtime # cron 行 / isp_fallback 计数器 / dnsmasq confdir 与片段 / LuCI 缓存 # sh teardown.sh files # 本工具安装的文件(含 /etc/isp-split 数据目录) # sh teardown.sh --list # 打印清单(selftest 与 postrm 漂移断言用),不动作 # 选项: # --keep-conf-bak # 保留 /etc/isp-split.conf.bak.*(默认删除并逐条打印) # --i-know-what-im-doing # 显式确认非默认 BASE(默认只允许 /etc/isp-split # # 或 ISP_SPLIT_DESTDIR 下的沙箱路径)。系统目录 # # (/、/etc、/usr、/var、/bin、/sbin、/lib…)永远拒绝 # # 为什么默认删 .conf.bak.*:它们是安装脚本每次覆盖安装都会新生成的副本, # 不是用户手写的备份。留着等于"卸载"留下一批与工具同名同前缀的孤儿文件, # 重装时再叠一层;删除前会逐条打印路径,想留档可以照路径先 cp 走。要长期 # 留档就显式 --keep-conf-bak,行为可选且可见。 # # 环境变量(与 isp-split 同名同义;自检/打包用): # ISP_SPLIT_DESTDIR 根前缀(默认空)。设置后所有绝对路径都加上它, # 用于在沙箱里演练卸载,不碰宿主 /usr /etc # ISP_SPLIT_BASE /etc/isp-split # ISP_SPLIT_CONF /etc/isp-split.conf # ISP_SPLIT_CRONTAB /etc/crontabs/root # ISP_SPLIT_LIB /usr/lib/isp-split # DNSDIR 旧版片段目录(默认 /dnsmasq.d) # DNSMASQ_DEFAULT_DIR dnsmasq 默认 conf-dir(默认 /tmp/dnsmasq.d) # DNSMASQ_CONF_GLOB 运行配置 glob(默认 /var/etc/dnsmasq.conf.*) # MWAN3_SERVICE / CRON_SERVICE / RPCD_SERVICE 服务脚本(自检可换 stub) set -u DESTDIR=${ISP_SPLIT_DESTDIR:-} case "$DESTDIR" in "" | "/") DESTDIR="" ;; /*) DESTDIR=${DESTDIR%/} ;; *) echo "ISP_SPLIT_DESTDIR 必须是绝对路径: '$DESTDIR'" >&2 exit 1 ;; esac BASE=${ISP_SPLIT_BASE:-$DESTDIR/etc/isp-split} # 归一化尾部斜杠(含多个):`/etc//` 与 `/etc` 必须落到同一条拒绝分支; # 根路径保持 `/`,否则空串会绕过下面的空值检查。 if [ "$BASE" != "/" ]; then BASE=$(printf '%s' "$BASE" | sed 's#/*$##') [ -n "$BASE" ] || BASE=/ fi CONF=${ISP_SPLIT_CONF:-$DESTDIR/etc/isp-split.conf} CRONTAB=${ISP_SPLIT_CRONTAB:-$DESTDIR/etc/crontabs/root} LIB=${ISP_SPLIT_LIB:-$DESTDIR/usr/lib/isp-split} DNSDIR=${DNSDIR:-$BASE/dnsmasq.d} DNSMASQ_DEFAULT_DIR=${DNSMASQ_DEFAULT_DIR:-$DESTDIR/tmp/dnsmasq.d} DNSMASQ_CONF_GLOB=${DNSMASQ_CONF_GLOB:-$DESTDIR/var/etc/dnsmasq.conf.*} STATE_DIR=$BASE/state # B-5:状态文件名与语义对齐——它记的是"迁移后写进 UCI 的清理值",不是原值。 STATE_NEW=$STATE_DIR/dnsmasq.confdir.migrated STATE_OLD=$STATE_DIR/dnsmasq.confdir.orig MWAN3_SERVICE=${MWAN3_SERVICE:-$DESTDIR/etc/init.d/mwan3} CRON_SERVICE=${CRON_SERVICE:-$DESTDIR/etc/init.d/cron} RPCD_SERVICE=${RPCD_SERVICE:-$DESTDIR/etc/init.d/rpcd} KEEP_CONF_BAK=0 IWKD=0 SCOPE="" say() { printf '[teardown] %s\n' "$*"; } # A-10:BASE 是 `rm -rf "$BASE"` 的唯一根,必须在任何删除之前过白名单。 # 真实事故:ISP_SPLIT_BASE=/etc 时,旧 cmd_files 直接 rm -rf /etc, # 而固定清单还会按 DESTDIR 删真实安装文件(附录 C)。 # 规则: # 1) 永远拒绝空、/、相对路径、含 ..、以及系统目录本身; # 2) 真实根(DESTDIR 为空)只接受默认 /etc/isp-split,其它路径必须显式 # --i-know-what-im-doing; # 3) 沙箱(DESTDIR 非空)只接受 DESTDIR 子树(防止演练误删宿主 /etc)。 validate_base() { case "$BASE" in "" | "/" | "." | ".." | *..*) echo "ISP_SPLIT_BASE 非法: '$BASE'(拒绝空、/、相对路径与 ..)" >&2 return 1 ;; /*) ;; *) echo "ISP_SPLIT_BASE 必须是绝对路径: '$BASE'" >&2 return 1 ;; esac case "$BASE" in /etc | /usr | /var | /bin | /sbin | /lib | /lib64 | /boot | /dev | /proc | /sys | /www | /root | /home | /tmp | /mnt | /opt) echo "ISP_SPLIT_BASE 指向系统目录,拒绝执行: '$BASE'" >&2 return 1 ;; esac # 沙箱:BASE 必须在 DESTDIR 里面;否则演练会删到宿主路径。 if [ -n "$DESTDIR" ]; then case "$BASE" in "$DESTDIR"/*) return 0 ;; *) echo "ISP_SPLIT_BASE 必须在 ISP_SPLIT_DESTDIR ($DESTDIR) 子树内: '$BASE'" >&2 return 1 ;; esac fi # 真实根:默认路径直接放行;其它路径必须显式确认。 [ "$BASE" = "/etc/isp-split" ] && return 0 [ "$IWKD" = "1" ] && return 0 echo "ISP_SPLIT_BASE 不是默认的 /etc/isp-split: '$BASE'" >&2 echo " 如确需操作该目录,请加 --i-know-what-im-doing;系统目录永远不会被接受。" >&2 return 1 } have() { command -v "$1" >/dev/null 2>&1; } # 只有真实根(DESTDIR 为空)才动服务:沙箱演练里重启服务既没意义,也会误伤宿主。 svc_restart() { [ -z "$DESTDIR" ] || return 0 [ -x "$1" ] || return 0 "$1" restart >/dev/null 2>&1 || true return 0 } # ---------------------------------------------------------------- 清单 # 文件/目录清单(相对 DESTDIR)。--list 与 files 段共用,杜绝两处漂移。 files_list() { cat </dev/null | sed -n 's/^mwan3\.\([^=]*\)=ipset$/\1/p'); do [ "$(uci -q get "mwan3.$_mw_sec.isp_split" 2>/dev/null)" = "1" ] || continue uci -q delete "mwan3.$_mw_sec" 2>/dev/null && _mw_n=$((_mw_n + 1)) done # rule 段:wire 生成的 isp_ 规则也带 isp_split=1。uninstall 的正常路径会先用 # rules-splice 摘掉它们,但 `bootstrap --rollback` 与 install.sh 的 teardown # 兜底路径不经过 splice——不在这里删,"只删带标记的段"这句承诺就是假的。 # 顺序:先规则,再策略(规则引用策略,先删引用方永远不会让 mwan3 渲染失败)。 _mw_nr=0 for _mw_sec in $(uci -q show mwan3 2>/dev/null | sed -n 's/^mwan3\.\([^=]*\)=rule$/\1/p'); do [ "$(uci -q get "mwan3.$_mw_sec.isp_split" 2>/dev/null)" = "1" ] || continue uci -q delete "mwan3.$_mw_sec" 2>/dev/null && _mw_nr=$((_mw_nr + 1)) done _mw_np=0 for _mw_sec in $(uci -q show mwan3 2>/dev/null | sed -n 's/^mwan3\.\([^=]*\)=policy$/\1/p'); do [ "$(uci -q get "mwan3.$_mw_sec.isp_split" 2>/dev/null)" = "1" ] || continue uci -q delete "mwan3.$_mw_sec" 2>/dev/null && _mw_np=$((_mw_np + 1)) done # member 段:仍被任何策略引用的不能删(删了 mwan3 会渲染失败) _mw_refs=" " for _mw_psec in $(uci -q show mwan3 2>/dev/null | sed -n 's/^mwan3\.\([^=]*\)=policy$/\1/p'); do for _mw_x in $(uci -q get "mwan3.$_mw_psec.use_member" 2>/dev/null); do _mw_refs="$_mw_refs$_mw_x " done done _mw_nm=0 for _mw_sec in $(uci -q show mwan3 2>/dev/null | sed -n 's/^mwan3\.\([^=]*\)=member$/\1/p'); do [ "$(uci -q get "mwan3.$_mw_sec.isp_split" 2>/dev/null)" = "1" ] || continue case "$_mw_refs" in *" $_mw_sec "*) say "警告:成员段 $_mw_sec 仍被其它策略引用,保留" continue ;; esac uci -q delete "mwan3.$_mw_sec" 2>/dev/null && _mw_nm=$((_mw_nm + 1)) done # interface 段:bootstrap 建的那些(isp_split=1)。判据只有标记,绝不按 # "名字看起来像 wan" 猜——用户手配的 wan/wanb 没有标记,必须原样保留。 # 仍被任何成员引用的接口保留:删了 mwan3 会渲染失败(比"残留"更糟)。 _mw_ifrefs=" " for _mw_isec in $(uci -q show mwan3 2>/dev/null | sed -n 's/^mwan3\.\([^=]*\)=member$/\1/p'); do for _mw_y in $(uci -q get "mwan3.$_mw_isec.interface" 2>/dev/null); do _mw_ifrefs="$_mw_ifrefs$_mw_y " done done _mw_ni=0 for _mw_sec in $(uci -q show mwan3 2>/dev/null | sed -n 's/^mwan3\.\([^=]*\)=interface$/\1/p'); do [ "$(uci -q get "mwan3.$_mw_sec.isp_split" 2>/dev/null)" = "1" ] || continue case "$_mw_ifrefs" in *" $_mw_sec "*) say "警告:接口段 $_mw_sec 仍被成员引用,保留" continue ;; esac uci -q delete "mwan3.$_mw_sec" 2>/dev/null && _mw_ni=$((_mw_ni + 1)) done uci -q commit mwan3 2>/dev/null || true [ "$_mw_n" -gt 0 ] && say "已删除 $_mw_n 个带 isp_split 标记的 ipset 段(含改名/删除的孤儿段)" [ "$_mw_nr" -gt 0 ] && say "已删除 $_mw_nr 个带 isp_split 标记的 mwan3 rule 段" [ "$_mw_np" -gt 0 ] || [ "$_mw_nm" -gt 0 ] && say "已删除 $_mw_np 个带 isp_split 标记的策略段、$_mw_nm 个成员段" [ "$_mw_ni" -gt 0 ] && say "已删除 $_mw_ni 个带 isp_split 标记的 mwan3 interface 段(bootstrap 建的骨架)" # 规则块在 uninstall 路径已被 rules-splice 摘掉;这里 reload 让集合/策略随之消失。 if [ -x "$MWAN3_SERVICE" ]; then "$MWAN3_SERVICE" reload >/dev/null 2>&1 || true fi return 0 } # ---------------------------------------------------------------- runtime # B-5:旧名里存的是"迁移后的清理值",名字与语义不符(PROPOSAL-0.2.2 §B-5)。 # 升级上来的设备可能还留着旧名:迁到新名,之后只认新名。迁移失败也不阻断, # 因为读取侧两个名字都认。 _state_adopt() { [ -f "$STATE_NEW" ] && return 0 [ -f "$STATE_OLD" ] || return 0 if mv -f "$STATE_OLD" "$STATE_NEW" 2>/dev/null; then say "旧状态文件 dnsmasq.confdir.orig 已迁移为 dnsmasq.confdir.migrated(B-5)" else cp -f "$STATE_OLD" "$STATE_NEW" 2>/dev/null && rm -f "$STATE_OLD" fi return 0 } _state_read() { if [ -f "$STATE_NEW" ]; then head -1 "$STATE_NEW" 2>/dev/null | tr -d '\r' elif [ -f "$STATE_OLD" ]; then head -1 "$STATE_OLD" 2>/dev/null | tr -d '\r' fi return 0 } # A-05:DNSDIR 白名单(与 isp-split 主脚本同一口径)。只允许 $BASE 子树 # 或 /tmp/dnsmasq*.d 形态;/etc、/、.. 一律不参与删除。 _dnsdir_ok() { _ddo=${1:-} case "$_ddo" in "" | "/" | "." | ".." | *..*) return 1 ;; esac case "$_ddo" in /*) ;; *) return 1 ;; esac while [ "$_ddo" != "/" ] && [ "${_ddo%/}" != "$_ddo" ]; do _ddo=${_ddo%/} done case "$_ddo" in "$BASE"/*) return 0 ;; /tmp/dnsmasq*.d | /tmp/*/dnsmasq*.d) return 0 ;; esac return 1 } # 删除片段的根目录限制:绝不 rm -f /isp-split.conf 或 /etc/isp-split.conf。 _frag_delete_ok() { _fdo=${1:-} case "$_fdo" in "" | "/" | "/etc" | "." | ".." | *..*) return 1 ;; esac case "$_fdo" in /*) ;; *) return 1 ;; esac [ -d "$_fdo" ] || return 1 return 0 } # 片段可能残留的目录:运行配置里的 conf-dir=(权威源)+ UCI 当前值 + # 状态文件记录值 + 默认目录 + 旧版目录,去重后逐行输出。 _frag_dirs() { { for _fd_f in $DNSMASQ_CONF_GLOB; do [ -f "$_fd_f" ] || continue sed -n 's/^[[:space:]]*conf-dir=//p' "$_fd_f" 2>/dev/null done printf '%s\n' "${_frag_uci:-}" "${_frag_state:-}" \ "$DNSMASQ_DEFAULT_DIR" _dnsdir_ok "$DNSDIR" && printf '%s\n' "$DNSDIR" } | tr ' ' '\n' | sed -e 's/,.*$//' -e 's/^"//' -e 's/"$//' -e 's:/*$::' | awk 'NF && !seen[$0]++' } cmd_runtime() { _state_adopt _orig=$(_state_read) _frag_state=$_orig _frag_uci="" have uci && _frag_uci=$(uci -q get dhcp.@dnsmasq[0].confdir 2>/dev/null || true) # 1) 恢复 UCI confdir:只有真的改过(有状态文件)才碰 UCI。 if [ -f "$STATE_NEW" ] || [ -f "$STATE_OLD" ]; then if [ -n "$_orig" ]; then if [ "$_frag_uci" != "$_orig" ]; then if uci -q set "dhcp.@dnsmasq[0].confdir=$_orig" 2>/dev/null && uci -q commit dhcp 2>/dev/null; then say "已恢复 dnsmasq confdir=$_orig" fi fi elif [ -n "$_frag_uci" ]; then if uci -q delete dhcp.@dnsmasq[0].confdir 2>/dev/null && uci -q commit dhcp 2>/dev/null; then say "已恢复 dnsmasq confdir(回落到默认 $DNSMASQ_DEFAULT_DIR)" fi fi fi rm -f "$STATE_NEW" "$STATE_OLD" 2>/dev/null || true # 2) 清片段。探测来源优先,但不依赖探测是否成功——目录列表是并集。 _n=0 for _d in $(_frag_dirs); do _frag_delete_ok "$_d" || continue [ -f "$_d/isp-split.conf" ] || continue rm -f "$_d/isp-split.conf" 2>/dev/null && _n=$((_n + 1)) done [ "$_n" -gt 0 ] && say "已清理 $_n 处 dnsmasq 片段 isp-split.conf" # 3) 命名计数器(旧版只有包 postrm 删它,脚本卸载路径漏了) if have nft && nft list table inet mwan3 >/dev/null 2>&1; then if nft list counter inet mwan3 isp_fallback >/dev/null 2>&1; then nft delete counter inet mwan3 isp_fallback >/dev/null 2>&1 && say "已删除 nft 计数器 inet mwan3 isp_fallback" fi fi # 4) crontab 行。mktemp 而不是固定 /tmp 名:/tmp 世界可写,符号链接能抢占(SEC-1)。 if [ -f "$CRONTAB" ] && grep -q 'isp-split' "$CRONTAB" 2>/dev/null; then _cron_dir=$(dirname "$CRONTAB") _cron_tmp=$(mktemp "$_cron_dir/.isp-split-cron.XXXXXX" 2>/dev/null) || _cron_tmp=$(mktemp "$CRONTAB.XXXXXX" 2>/dev/null) || _cron_tmp="" if [ -n "$_cron_tmp" ]; then grep -v 'isp-split' "$CRONTAB" > "$_cron_tmp" 2>/dev/null || true if mv -f "$_cron_tmp" "$CRONTAB"; then say "已移除 crontab 里的 isp-split 行" svc_restart "$CRON_SERVICE" else rm -f "$_cron_tmp" fi fi fi # 5) LuCI 缓存(页面文件在 files 段删) rm -rf "$DESTDIR"/tmp/luci-indexcache* "$DESTDIR"/tmp/luci-modulecache* 2>/dev/null || true return 0 } # ---------------------------------------------------------------- files cmd_files() { _del=0 _err=0 while read -r _k _p; do case "$_k" in base) # A-10:数据目录不再写死 etc/isp-split,而是跟随 BASE。 # 默认路径与自定义路径走同一条删除分支,避免“清单删默认、 # BASE 再删一次”的双路径。 [ -n "$BASE" ] || continue [ -e "$BASE" ] || [ -L "$BASE" ] || continue if rm -rf "$BASE"; then _del=$((_del + 1)) else say "错误:删不掉 $BASE" _err=1 fi ;; path) [ -e "$DESTDIR/$_p" ] || [ -L "$DESTDIR/$_p" ] || continue if rm -f "$DESTDIR/$_p"; then _del=$((_del + 1)) else say "错误:删不掉 $DESTDIR/$_p" _err=1 fi ;; dir) [ -d "$DESTDIR/$_p" ] || continue if rm -rf "$DESTDIR/$_p"; then _del=$((_del + 1)) else say "错误:删不掉 $DESTDIR/$_p" _err=1 fi ;; glob) # 这里必须真的做通配:把目录与文件名分开,目录加引号(容忍空格), # 文件名部分不加引号交给 shell 展开。整段引号会把 `*` 当成字面量, # 结果一个 .bak 都删不掉(自检 21.2/21.4 抓到的第一版 bug)。 _gdir=$(dirname "$DESTDIR/$_p") _gbase=$(basename "$_p") for _g in "$_gdir"/$_gbase; do [ -f "$_g" ] || continue if [ "$KEEP_CONF_BAK" = "1" ]; then say "保留历史配置备份: $_g(--keep-conf-bak)" continue fi # 删除前逐条打印:想留档可以在同一台机器上先照路径 cp 走。 say "删除历史配置备份: $_g" if rm -f "$_g"; then _del=$((_del + 1)) else say "错误:删不掉 $_g" _err=1 fi done ;; esac done <&2 exit 2 ;; esac shift done if [ -z "$SCOPE" ]; then echo "用法: sh teardown.sh all|mwan3|runtime|files|--list [--keep-conf-bak] [--i-know-what-im-doing]" >&2 exit 2 fi # A-10:任何实际动作(含 --list 之外的删除)之前先验证 BASE。 validate_base || exit 1 case "$SCOPE" in list) print_list ;; mwan3) cmd_mwan3 ;; runtime) cmd_runtime ;; files) cmd_files ;; all) cmd_mwan3 cmd_runtime svc_restart "$RPCD_SERVICE" cmd_files ;; esac