English | 简体中文
Manage proxy nodes, combine subscriptions, and publish stable subscription links. SubMan supports VLESS, VMess, Trojan, Shadowsocks, Hysteria2, TUIC, and AnyTLS, with sing-box client configuration exports and an API for trusted backend scripts.
Built with SvelteKit, TypeScript, and Tailwind CSS on Cloudflare Workers. Business data lives in one private GitHub Gist; a Durable Object coordinates writes.
- Manage nodes and subscriptions with tags, search, and batch import.
- Aggregate, filter, rename, and sort nodes, including manual drag-and-drop ordering.
- Preview, copy, download, and publish sing-box configurations.
- Keep stable subscription URLs by publishing to the same Gist filename.
- Load current cloud data before editing and confirm saves after cloud delivery.
- Automate node provisioning through the authenticated Server API.
- Open
/auth, connect a GitHub token withgistpermission, and load yourSubMan-DataGist. Enter the original Gist ID if discovery is ambiguous. - Add nodes or subscription URLs in
/nodes. - Create an aggregation rule in
/aggregate. - Preview or export in
/exports, then publish and copy the subscription link.
Each device keeps one cloud binding. Pending changes must settle before further edits. Tokens use session storage unless you explicitly choose persistence. See the user guide for setup and recovery.
Use a dedicated worktree and task branch for every change. PRs require current-head review before an authorized rebase merge; verify main, then clean up merged task branches and worktrees. Follow the development workflow.
Use Bun 1.3.14:
bun install --frozen-lockfile
bun run dev -- --host :: --port 5173On a local machine open http://localhost:5173; for the project VPS use
http://oc-de-fra-1.knowsky.uk:5173.
See development for Worker runtime testing and checks.
GitHub Wiki · English source index · 中文文档
| Guide | English | 简体中文 |
|---|---|---|
| Usage and recovery | User guide | 使用指南 |
| Development and Wiki maintenance | Development | 开发指南 |
| API and automation | Server API | 接口文档 |
| sing-box-vps adaptation | Integration guide | 适配指南 |
| Operations and deployment | Operations | 运维指南 |
| Project changes | Changelog | 变更记录 |
The documentation index also covers migration, export formats, integrations, and the roadmap. OpenAPI is the API contract; AGENTS.md and DESIGN.md describe contributor conventions.