English | 中文

A self-hosted subscription converter that transforms V2Ray / SS / SSR links or Clash configs into a mihomo-compatible Clash config with auto-updating proxy-providers and rule-providers.

• Accepts V2Ray base64 links, share links, or existing Clash configs as input
• Built-in Web UI for generating the converted subscription URL
• Rule-based routing (ACL-style), auto-updates via rule-provider
• Proxy-provider for node auto-update without restarting the client
• Proxies rule-provider requests through the server to avoid GitHub access failures
• Multiple airport (subscription) support — merge into one config
• Traffic remaining / total display (requires airport and client both support subscription-userinfo header)
• /provider API: converts a subscription into a standalone proxy-provider YAML
• Fully configurable via config.yaml

# 1. Edit the config as needed
vim config.yaml

# 2. Start
docker compose up -d

The service listens on port 48080 by default. Edit docker-compose.yml to change it.

# docker-compose.yml
services:
  subconv:
    image: ghcr.io/bowencool/subconv:latest
    restart: unless-stopped
    ports:
      - "48080:48080"
    volumes:
      - ./config.yaml:/app/config.yaml

Requires Node.js 22+.

npm install
npm run build
npm start          # PORT defaults to 48080

Set environment variables as needed:

Example:

https://your-domain/sub?url=https%3A%2F%2Fexample.com%2Fsub

Converts a raw subscription into a Clash proxy-provider YAML, useful for referencing nodes in a custom config.

https://your-domain/provider?url=<subscription_url>

Proxies a URL through the server, used internally to fetch rule lists from GitHub when npr is not set.

The config file controls the Clash output. Key sections:

# Clash HEAD block — merged into the output config as-is
HEAD:
  mixed-port: 7890
  allow-lan: true
  # ... other Clash options

# URL used for latency testing
TEST_URL: https://www.gstatic.com/generate_204

# Rule sets — each entry is [proxy_group, rule_list_url]
RULESET:
  - ["🌍 Proxy", "https://cdn.jsdelivr.net/gh/bowencool/SubConv@main/rules/bowen-proxy.list"]
  - ["DIRECT",   "https://cdn.jsdelivr.net/gh/bowencool/SubConv@main/rules/bowen-direct.list"]
  # ... more rules

MPL-2.0