+ 一款在 Shell 环境下便捷部署与管理 Mihomo/sing-box 内核的脚本工具 +
-功能简介： --- ++ 简体中文 | English +
-~通过管理脚本在Shell环境下便捷使用Mihomo/Singbox内核-~支持在Shell环境下管理
-~支持在线导入订阅及配置链接
-~支持配置定时任务，支持配置文件定时更新
-~支持在线安装及使用本地网页面板管理内置规则
-~支持路由模式、本机模式等多种模式切换
-~支持在线更新
+--- -设备支持： --- +## :rocket: 核心特性 -~支持各种基于OpenWrt或使用OpenWrt二次定制开发的路由器设备
-~支持各种运行标准Linux系统（如Debian/CenOS/Armbian等）的设备
-~兼容Padavan固件（保守模式）、潘多拉固件以及华硕/梅林固件
-~兼容各类使用Linux内核定制开发的各类型设备
+- **多内核支持**：在 Shell 环境下便捷管理及切换 **Mihomo** 与 **sing-box** 内核。 +- **灵活配置管理**：支持在线导入订阅连结及配置文件，简化配置流程。 +- **自动化任务**：支持配置定时任务，实现配置文件与规则的自动定时更新。 +- **图形化面板**：支持在线安装并使用本地 Web 面板（Dashboard），直观管理内置规则与流量。 +- **多模式运行**：支持路由模式、本机模式等多种流量转发模式切换。 +- **一键维护**：内置脚本在线更新功能，保持版本与功能的及时更迭。 -——————————
-~更多设备支持，请提issue或前往TG群反馈（需提供设备名称及运行uname -a返回的设备核心信息）
+## :computer: 设备支持 -## 常见问题： +ShellCrash 旨在兼容绝大多数基于 Linux 内核的网络设备： -[ShellCrash常见问题 | Juewuy's Blog](https://juewuy.github.io/chang-jian-wen-ti/) +* **路由器设备**：支持各种基于 OpenWrt 或其二次开发的固件。 +* **Linux 服务器**：支持运行标准 Linux 发行版（如 Debian、CentOS、Armbian、Ubuntu 等）的设备。 +* **第三方固件**：兼容 Padavan（保守模式）、潘多拉固件以及华硕/梅林固件。 +* **各类定制设备**：兼容其他使用 Linux 内核开发的专用网络设备。 -## 使用方式： +> 更多设备支持，请提交 [Issue](https://github.com/juewuy/ShellCrash/issues) 或前往 [Telegram 群组](https://t.me/ShellClash) 反馈（请附上设备型号及 `uname -a` 命令的输出信息）。 -~确认设备已经开启SSH并获取root权限（带GUI桌面的Linux设备可使用自带终端安装）
-~使用SSH连接工具（如putty，JuiceSSH，系统自带终端等）路由器或Linux设备的SSH管理界面或终端界面 +--- -~之后在SSH界面执行目标设备对应的安装命令，并按照后续提示完成安装
+## :hammer_and_wrench: 安装指南 -### 在线安装：
+> **提示** +> 若遇到连接失败或与SSL相关问题，请尝试切换至其他安装镜站。 -（**如无法连接或出现SSL连接错误，请尝试更换各种不同的安装源！**）
+### 前置条件 +1. 确保设备已开启 **SSH** 并获得 **Root 权限**（带图形介面的 Linux 系统可直接使用终端）。 +2. 使用 SSH 工具（如 Putty、JuiceSSH、或系统自带终端）连接至设备。 -~**标准Linux设备安装：**
+### :penguin: 标准 Linux 设备安装 -```shell -sudo -i #切换到root用户，如果需要密码，请输入密码 -export url='https://testingcf.jsdelivr.net/gh/juewuy/ShellCrash@master' && wget -q --no-check-certificate -O /tmp/install.sh $url/install.sh && bash /tmp/install.sh && . /etc/profile &> /dev/null -``` -或者 -```shell -sudo -i #切换到root用户，如果需要密码，请输入密码 -export url='https://gh.jwsc.eu.org/master' && bash -c "$(curl -kfsSl $url/install.sh)" && . /etc/profile &> /dev/null +> 使用 wget 安装（jsDelivr CDN 源） +```sh +sudo -i # 切换至root用户，若需密码，请输入 +export url='https://testingcf.jsdelivr.net/gh/juewuy/ShellCrash@master' \ + && wget -q --no-check-certificate -O /tmp/install.sh $url/install.sh \ + && bash /tmp/install.sh \ + && . /etc/profile &> /dev/null ``` -~**路由设备使用curl安装**：
+> 或使用 curl 安装（作者私人源） -```shell -#GitHub源(可能需要代理) -export url='https://raw.githubusercontent.com/juewuy/ShellCrash/master' && sh -c "$(curl -kfsSl $url/install.sh)" && . /etc/profile &> /dev/null -``` -或者 -```shell -#jsDelivrCDN源 -export url='https://testingcf.jsdelivr.net/gh/juewuy/ShellCrash@master' && sh -c "$(curl -kfsSl $url/install.sh)" && . /etc/profile &> /dev/null -``` -或者 -```shell -#作者私人源 -export url='https://gh.jwsc.eu.org/master' && sh -c "$(curl -kfsSl $url/install.sh)" && . /etc/profile &> /dev/null +```sh +sudo -i # 切换至root用户，若需密码，请输入 +export url='https://gh.jwsc.eu.org/master' \ + && bash -c "$(curl -kfsSl $url/install.sh)" \ + && . /etc/profile &> /dev/null ``` -~**路由设备使用wget安装**：
+### :satellite: 路由器设备安装 -```Shell -#GitHub源(可能需要代理) -export url='https://raw.githubusercontent.com/juewuy/ShellCrash/master' && wget -q --no-check-certificate -O /tmp/install.sh $url/install.sh && sh /tmp/install.sh && . /etc/profile &> /dev/null -``` -或者 -```shell -#jsDelivrCDN源 -export url='https://testingcf.jsdelivr.net/gh/juewuy/ShellCrash@master' && wget -q --no-check-certificate -O /tmp/install.sh $url/install.sh && sh /tmp/install.sh && . /etc/profile &> /dev/null +**使用 `curl` 安装：** +> GitHub 源（推荐海外环境或具备代理环境使用） +```sh +export url='https://raw.githubusercontent.com/juewuy/ShellCrash/master' \ + && sh -c "$(curl -kfsSl $url/install.sh)" \ + && . /etc/profile &> /dev/null ``` -~**老旧设备使用低版本wge安装**：
+> 或 jsDelivr CDN 源 -```Shell -#作者私人http内测源 -export url='http://t.jwsc.eu.org' && wget -q -O /tmp/install.sh $url/install.sh && sh /tmp/install.sh && . /etc/profile &> /dev/null +```sh +export url='https://testingcf.jsdelivr.net/gh/juewuy/ShellCrash@master' \ + && sh -c "$(curl -kfsSl $url/install.sh)" \ + && . /etc/profile &> /dev/null ``` -##### ~**虚拟机安装：**
+> 或作者私人源 +```sh +export url='https://gh.jwsc.eu.org/master' \ + && sh -c "$(curl -kfsSl $url/install.sh)" \ + && . /etc/profile &> /dev/null +``` -虚拟机环境强烈建议使用Alpine镜像安装
+**使用 `wget` 安装：** +> GitHub 源（推荐海外环境或具备代理环境使用） +```sh +export url='https://raw.githubusercontent.com/juewuy/ShellCrash/master' \ + && wget -q --no-check-certificate -O /tmp/install.sh $url/install.sh \ + && sh /tmp/install.sh \ + && . /etc/profile &> /dev/null +``` -```shell -#安装必要依赖 +> 或 jsDelivr CDN 源 +```sh +export url='https://testingcf.jsdelivr.net/gh/juewuy/ShellCrash@master' \ + && wget -q --no-check-certificate -O /tmp/install.sh $url/install.sh \ + && sh /tmp/install.sh \ + && . /etc/profile &> /dev/null +``` + +### :pager: 老旧设备使用低版本 `wget` 安装 + +> 作者私人 http 内测源 +```sh +export url='http://t.jwsc.eu.org' \ + && wget -q -O /tmp/install.sh $url/install.sh \ + && sh /tmp/install.sh \ + && . /etc/profile &> /dev/null +``` + + +### :cloud: 虚拟机 +- **Alpine Linux 虚拟机**：强烈建议使用 Alpine 镜像以获得最佳兼容性 +```sh +# 安装必要依赖 apk add --no-cache wget openrc ca-certificates tzdata nftables iproute2 dcron -#执行安装命令 -export url='https://testingcf.jsdelivr.net/gh/juewuy/ShellCrash@master' && wget -q --no-check-certificate -O /tmp/install.sh $url/install.sh && sh /tmp/install.sh && . /etc/profile &> /dev/null + +# 执行安装命令 +export url='https://testingcf.jsdelivr.net/gh/juewuy/ShellCrash@master' \ + && wget -q --no-check-certificate -O /tmp/install.sh $url/install.sh \ + && sh /tmp/install.sh \ + && . /etc/profile &> /dev/null ``` -##### ~Docker安装：
+ ### :whale: Docker -请前往[ShellCrash官方Docker镜像](https://hub.docker.com/r/juewuy/shellcrash) + 请访问官方 Docker 镜像： -### **本地安装：**
+- [ShellCrash on Docker Hub](https://hub.docker.com/r/juewuy/shellcrash) -如使用在线安装出现问题，请参考：[本地安装ShellCrash的教程 | Juewuy's Blog](https://juewuy.github.io/bdaz) 使用本地安装！
-### 使用脚本：
+### :package: 本地安装 -安装完成管理脚本后，执行如下命令使用~ +若无法进行在线安装，请参照以下指南执行本地安装： -```Shell -crash #进入对话 -crash -h #帮助列表 +- [本地安装ShellCrash教程 | Juewuy's Blog](https://juewuy.github.io/bdaz) + +--- + +## 📖 使用说明 + +安装完成后，在终端输入以下指令即可启动管理界面： + +```shell +crash # 启动脚本交互选单 +crash -h # 查看命令帮助列表 ``` -#### **运行时的额外依赖**：
+### 运行依赖说明 +| 依赖组件 | 必要性 | 说明 | +| :--- | :--- | :--- | +| curl / wget | 必须 | 缺少时将无法进行节点保存、在线安装及更新操作 | +| iptables / nftables | 重要 | 缺少时仅能运行于纯淨模式 | +| crontab | 较低 | 缺少时定时任务功能将失效 | +| net-tools | 极低 | 缺少时无法自动检测端口占用 | +| ubus / iproute-doc | 极低 | 缺少时无法自动获取本机 Host 地址 | -> 大部分的设备/系统都已经预装了以下的大部分依赖，使用时如无影响可以无视之 +--- -| 依赖 | 重要性 | 备注 | -|---|---|---| -| curl / wget | 必须 | 全部缺少时无法在线安装及更新，无法使用节点保存功能 | -| iptables / nftables | 重要 | 缺少时只能使用纯净模式 | -| crontab | 较低 | 缺少时无法启用定时任务功能 | -| net-tools | 极低 | 缺少时无法正常检测端口占用 | -| ubus / iproute-doc | 极低 | 缺少时无法正常获取本机host地址 | +## :link: 相关链接 +- 常见问题：[Juewuy's Blog](https://juewuy.github.io/chang-jian-wen-ti/) +- 更新日志：[Release History](https://github.com/juewuy/ShellCrash/releases) +- 交流反馈：[Telegram 讨论组](https://t.me/ShellClash) +--- -更新日志： --- +## :airplane: 机场推荐 -### [点击查看](https://github.com/juewuy/ShellCrash/releases) - -交流反馈： --- -### [TG讨论组](https://t.me/ShellClash) - -机场推荐： --- - -#### [Dler-墙洞，多年稳定运行，功能齐全](https://dler.pro/auth/register?affid=89698)
- -#### [大米-群友力荐，流媒体解锁，月付推荐](https://1s.bigmeok.me/user#/register?code=2PuWY9I7)
+- [**Dler-墙洞**](https://dler.pro/auth/register?affid=89698)，多年稳定运行，功能齐全。 +- [**大米**](https://1s.bigmeok.me/user#/register?code=2PuWY9I7)，群友力荐，流媒体解锁，月付推荐。