English | 中文

A modern web-based management panel for sing-box, providing an intuitive interface to manage subscriptions, rules, filters, and more.

• Subscription Management

  • Support multiple formats: SS, VMess, VLESS, Trojan, Hysteria2, TUIC
  • Clash YAML and Base64 encoded subscriptions
  • Traffic statistics (used/remaining/total)
  • Expiration date tracking
  • Auto-refresh with configurable intervals

• Node Management

  • Auto-parse nodes from subscriptions
  • Manual node addition
  • Country grouping with emoji flags
  • Node filtering by keywords and countries

• Rule Configuration

  • Custom rules (domain, IP, port, geosite, geoip)
  • 13 preset rule groups (Ads, AI services, streaming, etc.)
  • Rule priority management
  • Rule set validation tool

• Filter System

  • Include/exclude by keywords
  • Country-based filtering
  • Proxy modes: URL-test (auto) / Select (manual)

• DNS Management

  • Multiple DNS protocols (UDP, DoT, DoH)
  • Custom hosts mapping
  • DNS routing rules

• Service Control

  • Start/Stop/Restart sing-box
  • Configuration hot-reload
  • Auto-apply on config changes
  • Process recovery on startup

• System Monitoring

  • Real-time CPU and memory usage
  • Application and sing-box logs
  • Service status dashboard

• macOS Support

  • launchd service integration
  • Auto-start on boot
  • Background daemon mode

• Kernel Management

  • Auto-download sing-box binary
  • Version checking and updates
  • Multi-platform support

Download from Releases page.

# Clone the repository
git clone https://github.com/williamnie/singbox-manager.git
cd singbox-manager

# Build for all platforms
./build.sh all

# Or build for current platform only
./build.sh current

# Output binaries are in ./build/

Build Options:

./build.sh all       # Build for all platforms (Linux/macOS x amd64/arm64)
./build.sh linux     # Build for Linux only
./build.sh darwin    # Build for macOS only
./build.sh current   # Build for current platform
./build.sh frontend  # Build frontend only
./build.sh clean     # Clean build directory

# Basic usage
./sbm

# Custom data directory and port
./sbm -data ~/.singbox-manager -port 9090

Command Line Options:

After starting, open http://localhost:9090 in your browser.

Data Directory Structure:

~/.singbox-manager/
├── data.json           # Configuration data
├── generated/
│   └── config.json     # Generated sing-box config
├── bin/
│   └── sing-box        # sing-box binary
├── logs/
│   ├── sbm.log         # Application logs
│   └── singbox.log     # sing-box logs
└── singbox.pid         # PID file

• Backend: Go, Gin, gopsutil
• Frontend: React 19, TypeScript, NextUI, Tailwind CSS
• Build: Single binary with embedded frontend

• Go 1.21+ (for building)
• Node.js 18+ (for building frontend)
• sing-box (auto-downloaded or manual installation)

MIT License

一个现代化的 sing-box Web 管理面板，提供直观的界面来管理订阅、规则、过滤器等。

• 订阅管理

  • 支持多种格式：SS、VMess、VLESS、Trojan、Hysteria2、TUIC
  • 兼容 Clash YAML 和 Base64 编码订阅
  • 流量统计（已用/剩余/总量）
  • 过期时间追踪
  • 可配置间隔的自动刷新

• 节点管理

  • 自动从订阅解析节点
  • 手动添加节点
  • 按国家分组（带 emoji 国旗）
  • 按关键字和国家过滤节点

• 规则配置

  • 自定义规则（域名、IP、端口、geosite、geoip）
  • 13 个预设规则组（广告、AI 服务、流媒体等）
  • 规则优先级管理
  • 规则集验证工具

• 过滤器系统

  • 按关键字包含/排除
  • 按国家过滤
  • 代理模式：自动测速 / 手动选择

• DNS 管理

  • 多种 DNS 协议（UDP、DoT、DoH）
  • 自定义 hosts 映射
  • DNS 路由规则

• 服务控制

  • 启动/停止/重启 sing-box
  • 配置热重载
  • 配置变更后自动应用
  • 启动时自动恢复进程

• 系统监控

  • 实时 CPU 和内存使用率
  • 应用和 sing-box 日志
  • 服务状态仪表盘

• macOS 支持

  • launchd 服务集成
  • 开机自启
  • 后台守护进程模式

• 内核管理

  • 自动下载 sing-box 二进制文件
  • 版本检查和更新
  • 多平台支持

从 Releases 页面下载。

# 克隆仓库
git clone https://github.com/williamnie/singbox-manager.git
cd singbox-manager

# 构建所有平台
./build.sh all

# 或只构建当前平台
./build.sh current

# 输出文件在 ./build/ 目录

构建选项：

./build.sh all       # 构建所有平台（Linux/macOS x amd64/arm64）
./build.sh linux     # 仅构建 Linux
./build.sh darwin    # 仅构建 macOS
./build.sh current   # 仅构建当前平台
./build.sh frontend  # 仅构建前端
./build.sh clean     # 清理构建目录

# 基本用法
./sbm

# 自定义数据目录和端口
./sbm -data ~/.singbox-manager -port 9090

命令行参数：

启动后，在浏览器中打开 http://localhost:9090。

数据目录结构：

~/.singbox-manager/
├── data.json           # 配置数据
├── generated/
│   └── config.json     # 生成的 sing-box 配置
├── bin/
│   └── sing-box        # sing-box 二进制文件
├── logs/
│   ├── sbm.log         # 应用日志
│   └── singbox.log     # sing-box 日志
└── singbox.pid         # PID 文件

• 后端： Go、Gin、gopsutil
• 前端： React 19、TypeScript、NextUI、Tailwind CSS
• 构建： 单一二进制文件，内嵌前端

• Go 1.21+（用于构建）
• Node.js 18+（用于构建前端）
• sing-box（可自动下载或手动安装）

MIT License