A self-hosted proxy subscription management platform. Aggregate multiple proxy sources, organize nodes into collections, build advanced routing profiles, and serve ready-to-use Clash/Mihomo configurations from a single URL.

• Subscription Management -- Import proxies from Clash, V2Ray, and SIP002 URLs with auto-refresh on cron schedules
• Node Collections -- Organize self-managed proxy nodes and relay nodes into reusable groups
• Rule Collections -- Group domain/IP routing rules into manageable sets
• Endpoint System -- Create filtered views of proxies and rules, served as provider URLs (/p/{slug})
• Profile Builder -- Compose complete Clash/Mihomo configs with proxy-groups, rule-providers, and routing rules
• Health Monitoring -- Check node liveness and latency across all subscriptions
• Responsive UI -- Warm Dark theme with desktop sidebar, tablet icon bar, and mobile nav drawer
• CLI Tool -- Manage subscriptions, nodes, endpoints, and profiles from the terminal
• Single Binary -- Go backend with embedded React frontend, SQLite database, no external dependencies

mkdir -p data
docker compose up -d

Open http://localhost:9000

services:
  subhub:
    image: ghcr.io/cluas/subhub:latest
    ports:
      - "9000:9000"
    environment:
      - DB_PATH=/data/subhub.db
      - TZ=Asia/Shanghai
    volumes:
      - ./data:/data
    restart: unless-stopped

# Prerequisites: Go 1.25+, Node.js with pnpm
make build
./subhub serve

All configuration via environment variables:

BASE_URL can also be set in the web UI Settings page (stored in database, takes priority over env var).

Subscriptions (external URLs)       Collections (manual groups)
  └── Proxies (auto-fetched)          ├── Proxy Collections
  └── Rules  (auto-fetched)           └── Rule Collections
          │                                     │
          └──────────┬──────────────────────────┘
                     ▼
              Endpoints (/p/{slug})
              Filtered proxy or rule lists
                     │
                     ▼
              Profiles (/profile/{slug})
              Complete Clash/Mihomo config
              ├── Node Pools (proxy-providers)
              ├── Strategies (proxy-groups)
              ├── Rule Sets (rule-providers)
              └── Routing Rules (ordered rules)

Go to Subscriptions and add your provider URL. Click Fetch to pull nodes.

Create Proxy Collections for self-managed nodes (direct + relay). Create Rule Collections to group domain/IP rules by purpose (e.g. "AI domains", "company whitelist").

For relay nodes, add "dialer-proxy": "Transit Group" in the node config.

Endpoints serve filtered proxy/rule lists at /p/{slug}. Set a custom slug, choose a source (subscription or collection), and optionally filter by group name, type, or region.

Profiles compose everything into a complete Clash config served at /profile/{slug}:

• Settings -- port, socks-port, mode, log-level, external-controller
• Node Pools -- reference endpoints as proxy-providers with health checks
• Strategies -- proxy-groups: select, url-test, fallback, load-balance (with filter, include-all, tolerance)
• Rule Sets -- reference rule endpoints or external URLs as rule-providers
• Routing Rules -- ordered rules: DOMAIN-SUFFIX, GEOSITE, GEOIP, RULE-SET, MATCH

Point your Clash/Mihomo client to:

http://your-server:9000/profile/daily

# Subscriptions
subhub sub add <url> --name "My Provider"
subhub sub list
subhub sub refresh <id>

# Nodes
subhub node list --sub <id>
subhub node add --collection <id> --name "my-node" --type vless --server 1.2.3.4 --port 443

# Endpoints
subhub endpoint create --sub <id> --format clash --name "Foreign Nodes"
subhub endpoint list

# Profiles
subhub profile list
subhub profile show <id>

# Offline conversion (no server needed)
subhub convert <url> --format clash
subhub convert <url> --format surge --filter "HK"

Full REST API reference with examples: skills/subhub.md

Desktop Pages

Page	Screenshot
Subscriptions
Subscription Detail
Collections
Endpoints
Profiles
Profile Editor
Nodes
Rules
Health
Settings
Node Detail

Mobile Pages

Page	Screenshot
Nav Drawer
Subscriptions
Collections
Endpoints
Nodes

make dev-backend    # Backend only (placeholder frontend)
make dev-frontend   # Vite dev server with hot reload
make test           # Run Go tests
make build          # Full production build

MIT