A CLI-first, lightweight manager for sing-box.
Helm your network traffic with ease.
Sing-Helm is a powerful command-line interface designed to simplify the deployment and management of sing-box on Linux and macOS. It handles configuration generation, subscription management, and service lifecycle, making it the perfect companion for advanced proxy users.
- ⚡️ Zero Config Start: Run immediately with intelligent defaults.
- 📦 Subscription Management: parse and convert subscriptions to sing-box config automatically.
- 🔄 Automatic Updates: Built-in Homebrew tap integration for seamless upgrades.
- 🖥️ Daemon Management: Built-in service manager (Systemd / Launchd) for autostart.
- 🛠️ Hot Reload: Apply configuration changes without dropping connections.
- 🍎 macOS & 🐧 Linux: First-class support for both platforms (AMD64 & ARM64).
The easiest way to install and keep updated.
brew tap kyson-dev/sing-helm
brew install sing-helmInstall with a single command:
curl -sSL https://raw.githubusercontent.com/kyson-dev/sing-helm/main/scripts/install.sh | bashDownload the latest binary from the Releases page and add it to your PATH.
Sing-Helm runs as a daemon to manage the proxy core.
# Start in foreground (for testing)
sing-helm run
# Start as a system service (background)
sudo sing-helm startAdd your subscription URL (supports standard subscription formats):
(Feature coming soon: sing-helm sub add <url>)
Currently, put your subscription info into ~/.sing-helm/profile.json.
# Check if the service is running
sudo sing-helm status
# View logs
sing-helm log| Command | Description |
|---|---|
sing-helm run |
Run the daemon in the foreground (useful for debug) |
sing-helm start |
Start the system service (Ubuntu/Debian/macOS) |
sing-helm stop |
Stop the system service |
sing-helm restart |
Restart the system service |
sing-helm status |
Check service status |
sing-helm log |
Follow real-time logs |
sing-helm autostart on |
Enable service to start on boot |
sing-helm version |
Show version information |
The default configuration directory is ~/.sing-helm.
- profile.json: Your user settings (subscriptions, rules).
- config.json: The generated sing-box configuration (do not edit manually).
- sing-helm.log: Runtime logs.
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the project
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
Distributed under the MIT License. See LICENSE for more information.