SubMix

English

An enterprise intranet protocol configuration management tool that parses and converts multi-protocol connection strings into unified YAML configuration files, suitable for internal network service orchestration and traffic scheduling.

Features

Multi-protocol support: VLESS, Hysteria, Hysteria2, Shadowsocks, SS2022, Trojan
Visual node management: add, edit, reorder, delete service nodes
RESTful API: supports GET/POST for automated integration
Routing policies: whitelist/blacklist traffic scheduling modes
One-click export: copy or download YAML configuration

Quick Start

pnpm install
pnpm dev
pnpm typecheck
pnpm test:run

API Usage

Subscription cache is in-memory only. Links may become unavailable after instance restart, cross-instance routing, or FIFO eviction under high load.

POST (Recommended)

curl -X POST https://your-domain.com/api/sub \
  -H "Content-Type: application/json" \
  -d '{
    "urls": ["vless://...", "ss://..."],
    "type": "full",
    "mode": "whitelist"
  }'

GET

https://your-domain.com/api/sub?url=vless://...&url=ss://...&type=full&mode=whitelist

Connection strings must be URL-encoded for GET requests.

Parameters

Param	Description	Default
urls/url	Service node connection strings	-
type	`simple` (minimal) / `full` (complete)	full
mode	`whitelist` / `blacklist`	whitelist

Security & Runtime Env

Variable	Description	Default
`CORS_ALLOWED_ORIGINS`	Comma-separated CORS allowlist in production	Empty (same-origin only)
`MAX_CACHE_ITEMS`	Max in-memory subscription entries	`500`
`MAX_CONFIG_BYTES`	Max single subscription config size	`262144`
`MAX_SUBSCRIPTION_BODY_BYTES`	Max POST body for `/api/subscription`	`307200`
`MAX_SUB_REQUEST_BYTES`	Max POST body for `/api/sub`	`262144`
`MAX_CONVERT_REQUEST_BYTES`	Max POST body for `/api/convert`	`262144`

Tech Stack

Next.js 15 + TypeScript + Tailwind CSS + shadcn/ui

中文

企业内网协议配置管理工具，可将多种协议连接串解析并转换为统一的 YAML 配置文件，适用于内部网络服务编排与流量调度场景。

功能

多协议支持：VLESS、Hysteria、Hysteria2、Shadowsocks、SS2022、Trojan
可视化节点管理：添加、编辑、排序、删除服务节点
RESTful API 接口：支持 GET/POST 请求，便于自动化集成
路由策略：白名单/黑名单流量调度模式
一键导出：复制、下载 YAML 配置文件

快速开始

pnpm install
pnpm dev
pnpm typecheck
pnpm test:run

API 使用

订阅缓存为纯内存临时存储。实例重启、跨实例访问或高负载 FIFO 淘汰时，链接可能提前失效。

POST 请求（推荐）

curl -X POST https://your-domain.com/api/sub \
  -H "Content-Type: application/json" \
  -d '{
    "urls": ["vless://...", "ss://..."],
    "type": "full",
    "mode": "whitelist"
  }'

GET 请求

https://your-domain.com/api/sub?url=vless://...&url=ss://...&type=full&mode=whitelist

GET 请求需要对连接串进行 URL 编码。

参数说明

参数	说明	默认值
urls/url	服务节点连接串	-
type	`simple` 精简版 / `full` 完整版	full
mode	`whitelist` 白名单 / `blacklist` 黑名单	whitelist

安全与运行环境变量

变量	说明	默认值
`CORS_ALLOWED_ORIGINS`	生产环境 CORS 白名单，多个值用逗号分隔	空（仅同源）
`MAX_CACHE_ITEMS`	订阅内存缓存最大条目数	`500`
`MAX_CONFIG_BYTES`	单条订阅配置最大字节数	`262144`
`MAX_SUBSCRIPTION_BODY_BYTES`	`/api/subscription` POST 请求体上限	`307200`
`MAX_SUB_REQUEST_BYTES`	`/api/sub` POST 请求体上限	`262144`
`MAX_CONVERT_REQUEST_BYTES`	`/api/convert` POST 请求体上限	`262144`

技术栈

Next.js 16 + TypeScript + Tailwind CSS + shadcn/ui

致谢

免责声明 / Disclaimer

本工具仅供企业内部网络管理与技术学习用途，使用者应确保在合法合规的前提下使用本工具，并自行承担相关责任。

This tool is intended for enterprise internal network management and technical learning purposes only. Users are responsible for ensuring compliance with applicable laws and regulations.

FilesExpand file tree

README.md

Latest commit

History