SubBoost is a Clash/Mihomo subscription conversion, enhancement, and management tool. It converts airport subscriptions and self-hosted nodes into optimized aggregate subscriptions with automatic updates. With the visual UI, configure chained proxies, precise routing, DNS leak prevention, and multi-subscription aggregation in one click.
- Subscription conversion: Import subscription links, YAML files, node links, and other common formats.
- Node management: Rename, delete, or configure listening ports for nodes in batches.
- Node filtering: Build
filtered proxy groupswith selected nodes by source, region, and custom rules. - Chained proxies: Configure chained proxies and
relay proxy groupsvisually in one click. - Precise routing: Enable 30+ common proxy groups and 2,000+ remote rule sets.
- Rule management: Reorder rules for deeper customization.
- DNS leak prevention: The default
basic and DNS configurationprevents DNS leaks. - Automatic refresh: Refresh subscriptions on a schedule with intelligent node matching.
SubBoost visual configuration interface
Requirements: Docker + Docker Compose
git clone https://github.com/chenzai666/subboost.git
cd subboost
./start.shOn first run, start.sh auto-generates all secrets into .env, then pulls the image (bats666/subboost) and starts all services (app + PostgreSQL + cron).
Default port is 8488, visit http://<your-ip>:8488.
Copy the example config and edit as needed:
cp local/local.env.example .env
# Edit .env: fill in POSTGRES_PASSWORD, ENCRYPTION_KEY, JWT_SECRET, CRON_SECRET
docker compose up -ddocker compose pull && docker compose up -d./uninstall.sh
Removes containers, volumes, local images, and secret files in order, with a confirmation prompt before proceeding. The project directory must be deleted manually.
| Variable | Description | Example |
|---|---|---|
POSTGRES_PASSWORD |
Database password | random string |
ENCRYPTION_KEY |
Data encryption key | 64-char hex |
JWT_SECRET |
JWT signing key | 64-char hex |
CRON_SECRET |
Cron job auth token | 64-char hex |
APP_URL |
App access URL | http://192.168.1.1:8488 |
SUBBOOST_PORT |
App listening port (default 8488) | 8488 |
SUBBOOST_DB_PORT |
Database external port (default 15432) | 15432 |
Start a local development environment from source:
npm ci npm run dev
Common checks:
npm run lint npm run test:unit npm run check:local-app
The SubBoost source code is licensed under the GNU Affero General Public License v3.0 only.
This project does not provide any proxy service and makes no guarantee about the availability or legality of third-party subscription content.