How sub-store-org/sub-store works
Sub-Store is a subscription-management backend: users submit subscription or resource inputs, preview or convert them into proxy-platform formats, and manage collections, files, and synchronized artifacts through REST APIs. The central conversion path normalizes diverse proxy inputs and produces target-specific outputs; separate rule utilities and Loon resource parsing support formatting and resource-script capabilities. REST route internals and several documented product subsystems were not sampled, so their connections are shown only where the README or excerpts establish them.
Main entry points: restful/index.js REST routes · proxy-utils/index.js Proxy conversion engine · preview.js Preview subscriptions · producers/index.js Target format producers
Components 26
REST API
- REST routes
backend/src/restful/index.js - Preview subscriptions
backend/src/restful/preview.js - Subscription download
backend/src/restful/download.js - Sync and artifacts
backend/src/restful/sync.js - File management
backend/src/restful/file.js
Proxy Conversion
- Proxy conversion engine
backend/src/core/proxy-utils/index.js - Proxy input parsers
backend/src/core/proxy-utils/parsers/index.js - QX Loon Surge grammars
backend/src/core/proxy-utils/parsers/peggy/loon.js - Target format producers
backend/src/core/proxy-utils/producers/index.js - sing-box producer
backend/src/core/proxy-utils/producers/sing-box.js - URI producer
backend/src/core/proxy-utils/producers/uri.js - Clash.Meta producer
backend/src/core/proxy-utils/producers/clashmeta.js - Proxy preprocessors
backend/src/core/proxy-utils/preprocessors/index.js - Proxy processors
backend/src/core/proxy-utils/processors/index.js - Transport path utilities
backend/src/core/proxy-utils/transport-path.js - VMess security normalization
backend/src/core/proxy-utils/vmess-security.js - ECH utilities
backend/src/core/proxy-utils/ech-utils.js
Rules And Resources
- Rule utilities
backend/src/core/rule-utils/index.js - Universal rule parser
backend/src/core/rule-utils/parsers.js - Loon resource parser
backend/src/products/resource-parser.loon.js
State And Runtime
- Backend entry
backend/src/main.js - Artifact sync scheduler
backend/src/products/cron-sync-artifacts.js - Application database
backend/src/utils/database.js - Remote download utility
backend/src/utils/download.js - State migration
backend/src/utils/migration.js
Other components
- Subscription user
Connections 27
- Subscription user → REST routes: sends requests
- Backend entry → State migration: runs migration
backend/src/main.js - Backend entry → REST routes: starts server
backend/src/main.js - REST routes → Preview subscriptions: routes requests
- Preview subscriptions → Remote download utility: fetches sources
backend/src/restful/preview.js - Preview subscriptions → Proxy conversion engine: converts subscriptions
- Preview subscriptions → Application database: looks up subscriptions
backend/src/restful/preview.js - REST routes → Subscription download: routes downloads
- REST routes → Sync and artifacts: routes synchronization
- REST routes → File management: routes file operations
- Proxy conversion engine → Proxy input parsers: parses inputs
backend/src/core/proxy-utils/index.js - Proxy conversion engine → Proxy preprocessors: preprocesses inputs
backend/src/core/proxy-utils/index.js - Proxy conversion engine → Proxy processors: processes proxies
backend/src/core/proxy-utils/index.js - Proxy conversion engine → Target format producers: selects target producer
backend/src/core/proxy-utils/index.js - Proxy input parsers → QX Loon Surge grammars: uses grammars
backend/src/core/proxy-utils/parsers/index.js - Target format producers → sing-box producer: registers producer
backend/src/core/proxy-utils/producers/index.js - Target format producers → URI producer: registers producer
backend/src/core/proxy-utils/producers/index.js - Target format producers → Clash.Meta producer: registers producer
backend/src/core/proxy-utils/producers/index.js - URI producer → Transport path utilities: normalizes paths
backend/src/core/proxy-utils/producers/uri.js - URI producer → VMess security normalization: normalizes security
backend/src/core/proxy-utils/producers/uri.js - URI producer → ECH utilities: builds ECH config
backend/src/core/proxy-utils/producers/uri.js - sing-box producer → Transport path utilities: parses path values
backend/src/core/proxy-utils/producers/sing-box.js - Clash.Meta producer → Transport path utilities: uses path utilities
backend/src/core/proxy-utils/producers/clashmeta.js - Loon resource parser → Rule utilities: parses and produces rules
backend/src/products/resource-parser.loon.js - Rule utilities → Universal rule parser: uses parser
backend/src/core/rule-utils/index.js - Loon resource parser → Remote download utility: fetches resources
backend/src/products/resource-parser.loon.js - Artifact sync scheduler → Sync and artifacts: schedules artifact sync