Tutorials
Run a Chain Runtime
Start a local HTTP/CONNECT endpoint that sends traffic through a saved chain.
The Chain Engine turns saved chain definitions into local proxy endpoints.
1. Create or Select a Chain
- Open Chain Engine -> Chains.
- Create a chain with tested hops.
- Add fallback chains if you have them.
- Attach a policy.
- Save.
2. Review Policy
For a first run, the Balanced policy is enough:
| Setting | Balanced behavior |
|---|---|
| Startup validation | Disabled by default. |
| Request timeout | 20 seconds. |
| Connect timeout | 12 seconds. |
| Health check interval | 20 seconds. |
| Failure threshold | 3. |
| Retry budget | 1. |
| Fallback | Enabled. |
3. Start Runtime
- Open the chain runtime controls.
- Choose a requested local port.
- Enable auto-start if this chain should return after app restart.
- Start runtime.
- Copy the endpoint URL.
If the requested port is in use, ZeroTrace Proxy binds a random available local port and records a notice.
4. Use the Endpoint
Point a compatible client at:
http://127.0.0.1:<bound-port>The runtime supports normal HTTP forwarding and CONNECT tunnels.
5. Watch Traffic
Open Chain Engine -> Traffic and monitor:
- target host and URL
- status code
- request and response bytes
- route used
- duration
- success or error
- last exit IP
- switch count
If traffic fails, first check the runtime snapshot for last error and bound port, then check the Traffic page for request-level failures.