docs: add dnstc transport mode issue drafts

crazydi4mond · crazydi4mond · commit 7e8108978238 · 2026-01-26T23:37:04.000+01:00
diff --git a/issues/dnstc-07-single-transport.md b/issues/dnstc-07-single-transport.md
@@ -0,0 +1,31 @@
+# Single Transport Mode
+
+**Depends on:** #5 (Process Manager)
+
+## Summary
+
+Configure and run a single Slipstream or DNSTT transport instance through gost DNS proxy.
+
+**Motivation:** Basic use case - single tunnel connection. Foundation for multi-instance mode.
+
+## Design
+
+**Supported transports:**
+- Slipstream client (standalone)
+- DNSTT client (standalone)
+
+**Configuration:**
+- Transport type (slipstream/dnstt)
+- Server domain
+- Server credentials (TLS fingerprint / pubkey)
+- Local listen address
+
+**Data flow:**
+```
+App → gost (SOCKS/HTTP proxy) → Transport Client → DNS Proxy (resolvers) → Server
+```
+
+**CLI:**
+```bash
+dnstc start --transport slipstream --domain t.example.com --fingerprint abc123
+```
diff --git a/issues/dnstc-08-multi-instance.md b/issues/dnstc-08-multi-instance.md
@@ -0,0 +1,32 @@
+# Multi-Instance Transport Mode
+
+**Depends on:** #7 (Single Transport Mode)
+
+## Summary
+
+Run multiple transport instances with gost load balancing for higher aggregate bandwidth.
+
+**Motivation:** Single DNS tunnel has limited bandwidth. Multiple instances can aggregate throughput by distributing connections.
+
+## Design
+
+**Architecture:**
+```
+App → gost (load balancer) → Transport Instance 1 → DNS Proxy → Server
+                           → Transport Instance 2 → DNS Proxy → Server
+                           → Transport Instance N → DNS Proxy → Server
+```
+
+**gost features used:**
+- [Selector](https://gost.run/en/concepts/selector/) - distribute connections across instances
+- Failure detection - remove dead instances from pool
+
+**Configuration:**
+- Number of instances
+- Can mix transport types (e.g., 2x Slipstream + 1x DNSTT)
+- Per-instance server config if connecting to different servers
+
+**CLI:**
+```bash
+dnstc start --instances 3 --transport slipstream --domain t.example.com
+```
diff --git a/issues/dnstc-09-sip003-mode.md b/issues/dnstc-09-sip003-mode.md
@@ -0,0 +1,38 @@
+# SIP003 Plugin Mode
+
+**Depends on:** #2 (Binary Manager), #5 (Process Manager)
+
+## Summary
+
+Run Shadowsocks client with Slipstream as SIP003 transport plugin.
+
+**Motivation:** SIP003 is the standard plugin interface for Shadowsocks. Provides mature SOCKS5/HTTP proxy with encryption on top of DNS tunnel transport.
+
+## Design
+
+**Components:**
+- shadowsocks-rust client (`sslocal`)
+- Slipstream client as SIP003 plugin
+
+**Configuration:**
+- Shadowsocks server address/port/password/method
+- Plugin: slipstream
+- Plugin opts: domain, fingerprint, dns-server (from resolver pool)
+
+**Data flow:**
+```
+App → sslocal (SOCKS5) → Slipstream Plugin → DNS Proxy (resolvers) → Server
+```
+
+**CLI:**
+```bash
+dnstc start --mode sip003 \
+  --ss-server example.com:8388 \
+  --ss-password secret \
+  --domain t.example.com \
+  --fingerprint abc123
+```
+
+**Binary management:**
+- Download shadowsocks-rust sslocal binary
+- Env var override: `DNSTC_SSLOCAL_PATH`
