快速开始

约 1720 字大约 6 分钟

本文包含从安装到首次使用的完整流程，请按顺序阅读。

选择安装方式

方式	适用场景	说明
一键脚本安装	虚拟机 / Linux 系统	推荐，支持 Alpine、Debian、Ubuntu
Docker 安装	NAS / 服务器	适合已有 Docker 环境的用户
ROS 容器安装	RouterOS 设备	MikroTik 路由器专用

离线安装包下载

如果无法直接拉取 Docker 镜像，或需要在 ROS 中导入容器包，可手动下载对应架构的安装包。

确认你的设备架构

amd64：常见的 x86_64 PC、服务器、NAS
arm64：树莓派 4/5、部分 NAS（如群晖 DS923+）、Apple Silicon Mac
armv7：树莓派 3、部分旧款 NAS、部分路由器

正在获取最新版本信息...

一键脚本安装

适用于 Alpine、Debian 12、Ubuntu 24.04 等 Linux 系统，在终端中运行：

wget http://154.17.224.29/public/smbox-manage2.sh -O manage.sh && chmod +x manage.sh && ./manage.sh

说明

脚本自动检测系统架构，支持安装、升级、卸载、迁移，支持稳定版/测试版切换和下载源切换。

支持的系统：

系统	说明
Alpine	推荐，轻量低占用，查看安装 Alpine 系统教程
Debian 12 LXC	适合 PVE 用户
Debian 12	适合 ESXI 用户（使用非 Network Install 镜像）
Ubuntu 24.04 LTS	安装后需要重启

PVE 用户提示

PVE 建议使用 LXC Debian 12
ESXI 建议使用 Debian 12
PVE LXC 切换国内源：

cp /usr/share/perl5/PVE/APLInfo.pm /usr/share/perl5/PVE/APLInfo.pm_back
sed -i 's|http://download.proxmox.com|https://mirrors.ustc.edu.cn/proxmox|g' /usr/share/perl5/PVE/APLInfo.pm

Docker 安装

适合在 NAS、服务器等已有 Docker 环境中使用。

前提条件

已安装 Docker 和 Docker Compose
主路由 DHCP 的 IP 段不要包含 SMbox 将使用的 IP

Docker Compose（推荐）

创建 docker-compose.yml 文件：

networks:
  macnet:
    driver: macvlan
    driver_opts:
      parent: eth0 # 替换为你的物理网卡名称
    ipam:
      config:
        - subnet: 10.0.0.0/24
          gateway: 10.0.0.1

services:
  smbox:
    image: buaizheteng/smbox:latest
    container_name: smbox
    restart: unless-stopped
    volumes:
      - /root/docker/smbox:/root/config
    privileged: true
    networks:
      macnet:
        ipv4_address: 10.0.0.2

请根据自己的网络环境修改以下参数

parent: eth0：替换为宿主机的物理网卡名称（可通过 ip addr 查看）
subnet：替换为你的局域网网段
gateway：替换为你的主路由 IP
ipv4_address：替换为你希望 SMbox 使用的 IP，确保该 IP 不在 DHCP 分配范围内

启动容器：

# 前台运行，查看日志确认无误
docker compose up

# 确认正常后，后台运行
docker compose up -d

离线导入镜像

如果无法直接拉取镜像，先从离线安装包下载下载对应架构的容器包，然后导入：

docker load -i smbox-container-amd64-版本号.tar.gz

再按照上方 Docker Compose 配置启动容器即可。

极空间 NAS

注意

主路由 DHCP 不要包含下方 IP 段。

网络地址计算工具：https://www.sojson.com/convert/subnet.html

步骤一：创建 Macvlan 网络

步骤二：导入镜像

在极空间 Docker 管理中导入 buaizheteng/smbox:latest 镜像。

步骤三：创建容器

更换为刚刚创建的 macvlan 网络：

步骤四：启动容器

已知问题

宿主机无法直接和 macvlan 容器通信。如需宿主机访问代理，可按以下方式处理（有一定风险）：

给宿主机添加一个 macvlan IP（不能和宿主机原 IP 相同），然后添加路由将通往 SMbox 的流量走 macvlan 网卡。

将 enp4s0 替换为你的网卡名称，10.0.0.8 替换为 SMbox 的 IP：

ip link add macvlan2 link enp4s0 type macvlan mode bridge
ip addr add 10.0.0.16 dev macvlan2
ip link set macvlan2 up
ip route add 10.0.0.8 dev macvlan2

其他 NAS 设备

其他 NAS（群晖、威联通等）安装方式大同小异，核心步骤：

创建 macvlan 网络，使容器获得独立 IP
拉取 buaizheteng/smbox:latest 镜像
创建容器，挂载 /root/config 目录用于持久化数据
启用特权模式（privileged）
分配静态 IP 给容器

Docker 升级

# 拉取最新镜像
docker pull buaizheteng/smbox:latest

# 停止并删除旧容器
docker compose down

# 重新启动
docker compose up -d

数据持久化

配置数据保存在挂载的 /root/docker/smbox 目录中，升级不会丢失数据。建议升级前先通过 SMbox 的备份功能导出一份配置。

ROS 容器安装

从离线安装包下载下载对应架构的容器包（.tar.gz），上传到 ROS 后操作：

增加 veth 网卡，加到 bridge
添加 mounts，用于保存 SMbox 数据库文件（方便后续升级）
添加容器 root dir 可留空，Apply 后点击 Start，浏览器访问 veth IP 即可

首次使用

不论使用哪种方式安装，安装完成后请按以下步骤操作：

登录管理页面：浏览器访问 SMbox 的 IP 地址（默认 80 端口），默认账号密码均为 admin
添加节点或订阅：进入节点页面，添加订阅链接或手动添加节点，添加成功后 Singbox 自动重启
订阅被墙？
先用浏览器打开订阅链接，复制内容手动添加节点，等代理可用后再换回订阅 URL。
确认运行状态：回到仪表盘，确认 Singbox 为「运行中」。启动失败请检查筛选组是否匹配到节点
选择可用节点：打开 Zashboard 控制面板，手动选择一个可用节点
重要
确认节点可用前，不要将节点组改为 urltest（自动）模式。自动测速组不能作为规则下载的代理，可能导致规则文件下载失败。同样，先不要修改默认规则。
验证代理：SMbox 默认开启 socks5/http 代理（端口 8888），配置浏览器代理到 SMbox的IP:8888 验证节点是否正常
配置路由器分流：确认代理可用后，在路由器上配置分流：ROS | 爱快 | UBNT | OPNsense | 其他

更多功能参考功能使用教程

重置

删除 config 目录下的 smbox.db，重启 SMbox 即可恢复出厂设置。

版本与授权

功能	免费版	测试版	Pro版
订阅数量	最多1个	最多2个	无限制
高级配置	不可编辑	可编辑	可编辑
其他功能	无限制	无限制	无限制

Telegram Bot：https://t.me/sm_licence_bot
交流群：https://t.me/+BUK83nDsYEs5MjM1

Pro 版授权购买

无技术支持，需自行根据文档搭建。如需远程搭建，私聊环境与需求（128起）。

建议先试用免费版。采用大版本永久授权。

设备数量	价格
1-2设备	188
5设备	488
增加设备	100/个

设备数量指可以同时安装几个 SMbox，可自行在 Bot 解绑。

支付宝搜索口令红包，发送口令到 Tg，付款后会收到授权码。在页面左下角点击「激活PRO」输入即可。