mirror of
https://github.com/Lsmoisu/sing-box-shell.git
synced 2025-06-08 05:44:13 +08:00
80 lines
3.0 KiB
Markdown
80 lines
3.0 KiB
Markdown
# Sing-Box Shell
|
||
本脚本由Grok3生成
|
||
一个用于在 Linux 网关设备上自动部署和卸载 `sing-box` 的 Shell 脚本。
|
||
目前已在 **NanoPi R2S**上测试通过。
|
||
测试的系统：
|
||
**Debian arm64**
|
||
**Ubuntu 24 arm64**
|
||
**Ubuntu 24 x86**
|
||
|
||
## 功能特性
|
||
|
||
- **自动安装**：一键部署 `sing-box`，包括依赖安装、配置文件下载和网络设置。
|
||
- **卸载支持**：通过 `uninstall` 参数还原安装时的所有改动。
|
||
- **兼容性**：支持 POSIX Shell（如 `sh`）。
|
||
- **日志输出**：美观的日志格式（INFO/DEBUG），便于调试。
|
||
- **灵活配置**：支持自定义配置文件 URL(sing-box格式)，默认为模板配置，只能保证正常启动,安装后可手动替换配置问题件，路径为/etc/sing-box/config.json。
|
||
- **自动更新**：定时任务更新sing-box配置文件
|
||
|
||
## 环境要求
|
||
|
||
- **操作系统**：Linux（推荐 Debian/Ubuntu 系，只在 Armbian Debian 测试通过，其他设备和架构请自行测试）
|
||
- **架构支持**：x86_64、arm64、armv7、i386
|
||
- **权限**：需要 root 或 sudo 权限
|
||
- **网络**：设备需能访问 GitHub 或其他指定的下载源，如无法访问请使用github加速地址https://gh.aaa.team/
|
||
|
||
## 安装方法
|
||
|
||
### 从 GitHub 部署
|
||
|
||
```shell
|
||
bash <(curl -sL https://github.com/Lsmoisu/sing-box-shell/raw/refs/heads/main/install.sh)
|
||
```
|
||
|
||
### 使用加速地址
|
||
```shell
|
||
bash <(curl -sL https://gh.aaa.team/https://github.com/Lsmoisu/sing-box-shell/raw/refs/heads/main/install.sh)
|
||
```
|
||
### 从 其他Git 部署
|
||
```shell
|
||
bash <(curl -sL https://git.aaa.team/chunyu/sing-box-shell/raw/branch/main/install.sh)
|
||
```
|
||
|
||
## 本地运行
|
||
下载脚本：
|
||
```shell
|
||
wget https://gh.aaa.team/https://github.com/Lsmoisu/sing-box-shell/raw/refs/heads/main/install.sh
|
||
```
|
||
添加执行权限并运行：
|
||
```shell
|
||
chmod +x install.sh
|
||
sh install.sh
|
||
```
|
||
|
||
## 卸载方法
|
||
运行脚本时添加 uninstall 参数：
|
||
```shell
|
||
sh install.sh uninstall
|
||
```
|
||
卸载将移除 sing-box 可执行文件、配置文件、服务、防火墙规则，并尝试恢复网络设置（如 /etc/resolv.conf 和 IP 转发）。
|
||
|
||
## 使用说明
|
||
安装过程：
|
||
脚本会检测网络接口和 IP 地址。
|
||
提示是否跳过系统更新（快速安装）。
|
||
下载并安装 sing-box（默认版本 1.11.4）。
|
||
配置 systemd 服务和防火墙规则。
|
||
设置 DNS 和 IP 转发。
|
||
配置选项：
|
||
运行时可输入自定义配置文件 URL，默认使用 https://sub.aaa.team/config-zz-realip-route
|
||
默认配置文件只是一个模板，需要添加自己的节点。
|
||
安装完成后，需将其他设备的网关和 DNS 指向设备 IP（如 192.168.1.3）。
|
||
日志级别：
|
||
默认 INFO：显示主要操作信息。
|
||
修改脚本顶部 LOG_LEVEL="DEBUG" 可启用详细调试日志。
|
||
|
||
## 已知问题
|
||
IPv6 支持：未实现，安装后如有问题，必须打开某些网站出现证书问题，请关闭电脑ipv6。
|
||
系统兼容性：目前仅在 NanoPi R2S 设备上测试，经济有限，其他设备可能无法适配。
|
||
|