156 行
5.1 KiB
Markdown
156 行
5.1 KiB
Markdown
# singbox.sh
|
||
|
||
基于 [sing-box](https://github.com/SagerNet/sing-box) 的一键安装与管理脚本，提供交互式菜单来搭建、管理多种代理协议节点。
|
||
|
||
> 脚本作者：Mr. xiao（[原项目地址](https://github.com/TinrLin)）。本目录用于本地保存与备份，便于在不同 VPS 上快速部署。
|
||
>
|
||
> 本仓库地址：<https://git.suhang.me/suhang/scripts>，下方所有 `wget` / `curl` 命令均从该仓库直接拉取。
|
||
|
||
## 功能概览
|
||
|
||
支持的入站协议：
|
||
|
||
- SOCKS / HTTP / Direct
|
||
- VMess / VLESS（含 Reality）/ Trojan
|
||
- Hysteria / Hysteria2
|
||
- TUIC / Juicity
|
||
- ShadowTLS / NaiveProxy / Shadowsocks
|
||
- WireGuard（出站，用于解锁流媒体等）
|
||
|
||
管理功能：
|
||
|
||
- 查看已搭建节点信息（含分享链接 / Clash 配置）
|
||
- 更新内核（Latest / Beta / 编译安装完整功能版）
|
||
- 更新脚本自身
|
||
- 申请 / 续签 TLS 证书（基于 acme.sh，支持 Let's Encrypt、ZeroSSL，HTTP-01 与 Cloudflare DNS-01）
|
||
- 重启 / 卸载服务
|
||
- 节点管理（添加 / 删除单个用户或入站）
|
||
- 自动配置防火墙（ufw / iptables / firewalld）
|
||
- 自动开启 BBR
|
||
|
||
## 系统要求
|
||
|
||
- Linux x86_64 / ARMv7 / ARM64 / AMD64v3 / s390x
|
||
- 使用 systemd 的发行版（Debian 10+ / Ubuntu 20.04+ / CentOS 8+ / Rocky / AlmaLinux 等）
|
||
- 需要 root 权限
|
||
- 公网 IPv4 或 IPv6（部分协议要求 80/443 端口可用于证书签发）
|
||
|
||
## 依赖安装
|
||
|
||
脚本运行时会调用以下命令，**请先确保已安装**（多数发行版默认包含 `bash` `tar` `systemctl` `iptables` 等）：
|
||
|
||
| 依赖 | 用途 |
|
||
| --- | --- |
|
||
| `curl` / `wget` | 下载内核、调用 GitHub / Cloudflare API |
|
||
| `jq` | 解析 GitHub Release / Cloudflare API 的 JSON |
|
||
| `openssl` | 生成随机密钥、自签证书、TLS 探测 |
|
||
| `tar` | 解压内核压缩包 |
|
||
| `systemd` | 管理 sing-box / juicity 服务 |
|
||
| `cron` (`cronie` / `crontabs`) | 自动续签证书的定时任务 |
|
||
|
||
### Debian / Ubuntu
|
||
|
||
```bash
|
||
apt update
|
||
apt install -y curl wget jq openssl tar cron
|
||
```
|
||
|
||
### CentOS / RHEL / Rocky / Alma
|
||
|
||
```bash
|
||
dnf install -y curl wget jq openssl tar cronie
|
||
systemctl enable --now crond
|
||
```
|
||
|
||
### Arch Linux
|
||
|
||
```bash
|
||
pacman -Sy --noconfirm curl wget jq openssl tar cronie
|
||
systemctl enable --now cronie
|
||
```
|
||
|
||
> 选择「编译安装 sing-box（完整功能版本）」时，脚本会自动下载并安装 Go 编译器，无需额外安装。
|
||
>
|
||
> 申请证书时若系统未安装 acme.sh，脚本会自动通过 `curl https://get.acme.sh | sh` 安装。
|
||
|
||
## 使用方式
|
||
|
||
### 1. 下载脚本
|
||
|
||
从本仓库直接下载到服务器（推荐放到 `/root/`）：
|
||
|
||
```bash
|
||
# 方式一：直接下载脚本
|
||
wget -O /root/singbox.sh https://git.suhang.me/suhang/scripts/raw/branch/main/singbox/singbox.sh
|
||
chmod +x /root/singbox.sh
|
||
|
||
# 方式二：克隆整个仓库
|
||
git clone https://git.suhang.me/suhang/scripts.git /root/scripts
|
||
chmod +x /root/scripts/singbox/singbox.sh
|
||
```
|
||
|
||
> 也可以使用 `curl`：
|
||
> ```bash
|
||
> curl -fsSL -o /root/singbox.sh https://git.suhang.me/suhang/scripts/raw/branch/main/singbox/singbox.sh && chmod +x /root/singbox.sh
|
||
> ```
|
||
|
||
### 2. 运行交互式菜单
|
||
|
||
```bash
|
||
bash /root/singbox.sh
|
||
```
|
||
|
||
进入菜单后按编号选择操作：
|
||
|
||
```
|
||
[1] SOCKS [2] Direct
|
||
[3] HTTP [4] VMess
|
||
[5] VLESS [6] TUIC
|
||
[7] Juicity [8] Trojan
|
||
[9] Hysteria [10] Hysteria2
|
||
[11] ShadowTLS [12] NaiveProxy
|
||
[13] Shadowsocks [14] WireGuard
|
||
[15] 查看节点信息 [16] 更新内核
|
||
[17] 更新脚本 [18] 更新证书
|
||
[19] 重启服务 [20] 节点管理
|
||
[21] 卸载 [0] 退出
|
||
```
|
||
|
||
### 3. 命令行参数
|
||
|
||
目前脚本仅支持一个非交互参数，用于定时任务续签证书：
|
||
|
||
```bash
|
||
bash /root/singbox.sh 18 # 等同于菜单 [18] 更新证书
|
||
```
|
||
|
||
脚本会自动写入 crontab，每周一凌晨 2 点执行该命令续签：
|
||
|
||
```cron
|
||
0 2 * * 1 /bin/bash /root/singbox.sh >> /usr/local/etc/certificate.log 2>&1
|
||
```
|
||
|
||
## 路径与文件
|
||
|
||
| 路径 | 说明 |
|
||
| --- | --- |
|
||
| `/usr/local/bin/sing-box` | sing-box 主程序 |
|
||
| `/usr/local/bin/juicity-server` | Juicity 主程序（仅 Juicity 模式） |
|
||
| `/usr/local/etc/sing-box/config.json` | sing-box 配置文件 |
|
||
| `/usr/local/etc/sing-box/clash.yaml` | 自动生成的 Clash 订阅 |
|
||
| `/usr/local/etc/juicity/config.json` | Juicity 配置文件 |
|
||
| `/etc/ssl/private/` | TLS 证书与私钥 |
|
||
| `/etc/systemd/system/sing-box.service` | systemd 服务单元 |
|
||
| `/usr/local/etc/certificate.log` | 续签日志 |
|
||
|
||
## 常见问题
|
||
|
||
- **菜单乱码**：终端使用 UTF-8（`export LANG=en_US.UTF-8` 或 `zh_CN.UTF-8`）。
|
||
- **证书申请失败**：检查 80 端口是否被占用（HTTP-01），或使用 Cloudflare DNS API（需 API Token + Zone ID + Email）。
|
||
- **节点不通**：脚本已自动放行所选端口，如使用云厂商安全组，请同步在面板放行 TCP/UDP。
|
||
- **内核更新后无法启动**：`journalctl -u sing-box -n 100 --no-pager` 查看日志，多数为配置与新版内核字段不兼容，可重新搭建或回退版本。
|
||
|
||
## 卸载
|
||
|
||
菜单选择 `[21] 卸载`，会停止并移除 sing-box / juicity 的二进制、配置目录与 systemd 服务。
|