ShellCrash本地安装教程：解决在线安装失败的离线部署方案

你是否遇到过在线安装ShellCrash时因网络问题导致下载失败？是否在没有稳定网络连接的环境下需要部署ShellCrash？本文将详细介绍如何通过本地安装方式解决这些问题，让你无需依赖在线环境也能顺利部署ShellCrash。读完本文后，你将掌握离线安装的完整流程，包括环境准备、文件获取、安装步骤以及常见问题处理。

准备工作

在开始本地安装前，请确保你的系统满足以下要求：

• 至少1MB的可用磁盘空间
• 具有bash环境（不支持dash环境，可通过bash命令切换）
• 适当的用户权限（推荐使用root用户）

首先，你需要获取ShellCrash的完整项目文件。可以通过以下命令克隆仓库：

git clone https://gitcode.com/GitHub_Trending/sh/ShellCrash

安装文件解析

ShellCrash的安装脚本是install.sh，我们先来了解其主要功能和结构：

1. 环境检测：脚本首先检测系统类型（如Padavan、华硕固件、小米设备等），以便后续选择合适的安装路径
2. 目录选择：根据不同系统提供多种安装目录选项，确保数据在重启后不会丢失
3. 文件下载：默认从在线地址下载安装文件，这也是在线安装失败的常见原因
4. 安装流程：包括文件解压、初始化配置等步骤

离线安装步骤

1. 准备离线安装文件

由于在线安装可能失败，我们需要手动准备安装所需的tar包。你可以在有网络的环境中下载以下文件：

https://fastly.jsdelivr.net/gh/juewuy/ShellCrash@master/bin/ShellCrash.tar.gz

将下载好的文件保存到/tmp目录下，以便安装脚本能够找到。

2. 修改安装脚本

为了让安装脚本使用本地文件而非在线下载，我们需要修改install.sh中的gettar函数。找到以下代码段：

gettar() {
    webget /tmp/ShellCrash.tar.gz "$url/bin/ShellCrash.tar.gz"
    if [ "$result" != "200" ]; then
        $echo "\033[33m文件下载失败！\033[0m"
        error_down
        exit 1
    else
        # 解压和安装步骤
    fi
}

修改为：

gettar() {
    # 检查本地是否存在安装文件
    if [ -f "/tmp/ShellCrash.tar.gz" ]; then
        $echo "\033[32m使用本地安装文件...\033[0m"
        result="200"
    else
        $echo "\033[31m本地安装文件不存在，请先准备/tmp/ShellCrash.tar.gz\033[0m"
        exit 1
    fi
    
    if [ "$result" = "200" ]; then
        $CRASHDIR/start.sh stop 2>/dev/null
        # 解压
        echo -----------------------------------------------
        echo 开始解压文件！
        mkdir -p $CRASHDIR >/dev/null
        tar -zxf '/tmp/ShellCrash.tar.gz' -C $CRASHDIR/ || tar -zxf '/tmp/ShellCrash.tar.gz' --no-same-owner -C $CRASHDIR/
        if [ -s $CRASHDIR/init.sh ]; then
            . $CRASHDIR/init.sh >/dev/null || $echo "\033[33m初始化失败，请尝试本地安装！\033[0m"
        else
            rm -rf /tmp/ShellCrash.tar.gz
            $echo "\033[33m文件解压失败！\033[0m"
            error_down
            exit 1
        fi
    fi
}

3. 执行安装脚本

修改完成后，运行安装脚本：

bash install.sh

4. 选择安装目录

安装过程中，脚本会根据你的系统类型提供不同的安装目录选项。以通用Linux系统为例，你会看到以下选项：

 1 在/etc目录下安装(适合root用户)
 2 在/usr/share目录下安装(适合Linux系统)
 3 在当前用户目录下安装(适合非root用户)
 4 在外置存储中安装
 5 手动设置安装目录
 0 退出安装

推荐选择/etc或/usr/share目录（需要root权限），这些目录在系统重启后不会丢失数据。如果你使用的是路由器设备，脚本会自动检测并提供适合该设备的安装选项。

5. 完成安装

安装成功后，你会看到以下提示：

ShellCrash 已经安装成功!
输入 crash 命令即可管理！！！

此时，你需要执行以下命令加载环境变量：

. ~/.bashrc &> /dev/null

如果你使用的是zsh，执行：

. ~/.zshrc &> /dev/null

验证安装结果

安装完成后，输入crash命令启动ShellCrash管理界面。如果一切正常，你将看到主菜单。你也可以检查安装目录下的文件是否完整：

ls -l /etc/ShellCrash/  # 根据你选择的安装目录调整路径

主要文件和目录包括：

• scripts/init.sh: 初始化脚本
• scripts/menu.sh: 主菜单脚本
• scripts/start.sh: 启动脚本
• public/: 公共资源文件
• rules/: 规则配置文件

常见问题处理

1. 安装目录权限问题

如果遇到"没有目录写入权限"的错误，请确保你有足够的权限，或者选择其他目录。你可以使用以下命令检查目录权限：

ls -ld /etc/ShellCrash/

2. 解压失败

如果tar文件解压失败，可能是文件损坏或不完整。请重新下载ShellCrash.tar.gz并尝试。

3. 启动失败

如果安装成功但无法启动，检查日志文件获取详细信息：

tail -f /var/log/ShellCrash.log

配置文件说明

ShellCrash的主要配置文件位于安装目录下的configs/ShellCrash.cfg。你可以根据需要修改以下关键配置：

• log_level: 日志级别，默认为info
• update_channel: 更新通道，可选公测版、稳定版或开发版
• auto_start: 是否开机自启，默认为true

更多配置选项可以参考README_CN.md。

总结

通过本教程，你已经掌握了ShellCrash的本地安装方法，解决了在线安装失败的问题。主要步骤包括准备离线安装文件、修改安装脚本、执行安装过程以及验证安装结果。这种方法特别适用于网络环境受限或在线资源访问不稳定的情况。

如果你在安装过程中遇到其他问题，可以查阅项目文档README.md或社区寻求帮助。ShellCrash支持多种设备和系统，包括基于OpenWRT的路由器、Debian、CentOS等Linux系统，是一个功能强大的工具。

希望本教程对你有所帮助，如果你觉得有用，请点赞收藏并关注后续教程。下期我们将介绍ShellCrash的高级配置技巧，敬请期待！