Sub-Store README

The project's README from github.com/sub-store-org/Sub-Store. As one markdown file: README.md.

Sub-Store

Sub-Store

Advanced Subscription Manager for QX, Loon, Surge, Stash, Egern and Shadowrocket

Build GitHub GitHub issues GitHub closed pull requests Size
sub-store-org%2FSub-Store | Trendshift Buy Me A Coffee 联系推广

MaruCode MaruCode 是一家偶尔做做慈善的小破站 API,自营号池,不搞充值营销套路,主要提供 Codex、Claude Code、GPT Image-2 等主流模型,支持 WebSocket 协议,明码标价(Codex 0.3x, CC 1.5x),透明汇率(1:1),新用户注册 送 2 刀 💰 生图工作台 🖼

📚 文档/DOC

sub.store Domain Safety Notice

Statement

⚠️ sub.store is only the domain used by module-script rewrite MitM rules. It is not a public domain owned by us.

Risk

If a request does not go through the rewrite, the data will be sent to the public sub.store service.

You can map sub.store to 127.0.0.1 or another local address to prevent accidental access to the public sub.store. However, ordinary users may still send requests to the public sub.store after switching or toggling configuration modules.

  1. It could, in theory, redirect users to a fake frontend. This is only a possibility and does not imply that the owner of sub.store would do this. Note: The official frontend is https://sub-store.vercel.app.
  2. It could receive user data from sub.store.

This creates a data leakage risk.

Plan

After listening to suggestions from the group, we will not switch to a new domain for now. Choosing a new domain is also awkward: it needs to be related, short, and unlikely to be registered by someone else, at least in the short term.

This notice is published only as an announcement. No changes will be made for now.

Example:

[Host]
sub.store = 127.0.0.1

CORS Allowlist

Sub-Store also supports a configurable browser CORS allowlist for the backend API. This does not change the module rewrite domain, but it limits which browser origins can read API responses through CORS.

Core functionalities:

  1. Conversion among various formats.
  2. Subscription formatting.
  3. Collect multiple subscriptions in one URL.
  4. Host and modify subscriptions/files

The following descriptions of features may not be updated in real-time. Please refer to the actual available features for accurate information.

1. Subscription Conversion

Supported Input Formats

本地节点怎么写/How To Write A Local Node

⚠️ Do not use Shadowrocket or NekoBox to export URI and then import it as input. The URIs exported in this way may not be standard URIs. However, we have already supported some very common non-standard URIs (such as VMess, VLESS).

Deprecated(The frontend doesn't show it, but the backend still supports it, with the query parameter target=Clash):

Supported Target Platforms

Deprecated:

2. Subscription Formatting

Filtering

Proxy Operations

Development

Install pnpm

Go to backend directories, install node dependencies:

pnpm i
SUB_STORE_BACKEND_API_PORT=3000 pnpm esbuild:dev

or this one if you're using Termux

SUB_STORE_BACKEND_API_PORT=3000 pnpm run --parallel "/^dev:.*/"

Build

pnpm bundle:esbuild

LICENSE

This project is under the AGPL-3.0 LICENSE.

FOSSA Status

Star History

Star History

Acknowledgements

Sponsors

image

NodeSupport sponsored this project.

致谢

感谢赞助商 ForZTN 对项目服务器的支持,感谢。

Sub-Store (sub-store-org/Sub-Store)

Searching Database…

10.7K ·GitHub
这是干什么的?Sub-Store 是一个功能强大的订阅管理器,面向 Quantumult X、Loon、Surge、Stash、Egern 和 Shadowrocket 等代理软件:它可以在不同格式之间转换订阅,并管理你的节点列表。
它是手机上的应用,还是需要我自己部署的服务?它可以通过 MitM 重写规则以脚本模块的形式运行在你的代理软件里,也可以作为自托管的 Node.js 后端搭配独立的网页前端运行。
我怎么把它跑起来?如果是自己搭建,README 里写的是:安装 pnpm,进入 backend 目录安装 Node 依赖——另外还提供了 Android 上 Termux 的替代安装命令。
sub.store 这个域名安全吗?我看到一条很大的警告。sub.store 只是模块脚本重写 MitM 规则所用的域名,并不归这个团队所有。如果请求绕过重写,就会直接到达公开服务,有数据泄露的风险——把 sub.store 映射到 127.0.0.1 就能避免这一点。
其他网站能通过浏览器读到我的订阅数据吗?你可以用 CORS 白名单来锁死这一点:Node 和服务器部署需要设置 SUBSTORECORSALLOWEDORIGINS,代理软件模块则使用 cors 模块参数,来源会按协议、主机和端口精确匹配。
它能读取哪些代理格式的输入?支持 SS、SSR、VMess、VLESS、Trojan、Hysteria、Hysteria 2、TUIC v5、WireGuard、AnyTLS 和 SOCKS 的 URI 链接,以及 Clash YAML 和 QX、Loon、Surge、mihomo 的配置文件。普通 HTTP(S) 代理 URI 不支持,因为它们没有统一的标准格式;从 Shadowrocket 或 NekoBox 导出的 URI 可能不规范(不过 VMess、VLESS 这类常见格式仍然可以接受)。
它能把我的订阅转换成哪些软件的格式?支持纯 JSON、Stash、Clash.Meta(mihomo)、Surfboard、Surge、SurgeMac、Loon、Egern、Shadowrocket、Quantumult X、sing-box 和 V2Ray;旧的 Clash 目标仍然可用,通过 target=Clash 查询参数即可。
我能把好几个订阅合并成一个链接吗?可以——把多个订阅汇总到一个 URL 里是 Sub-Store 的核心功能之一,和格式转换、托管自己的订阅文件并列。
它能清理或重命名我订阅里的节点吗?可以。它带有正则、地区、类型和脚本过滤器,还有无效节点过滤器,并提供了各种操作:按正则重命名、排序或删除节点,添加或移除国旗图标,设置 udp、skip-cert-verify 等属性,以及把节点域名解析成 IP。
Size
15.9 MB
Stars
10.7K
Age
6y
Commits · 90 Days