A modern and elegant dashboard for network traffic visualization and analysis.
Agent Configuration
中文 | English
Required flags
--server-url: panel server URL (without/apisuffix is fine)--backend-id: backend numeric id--backend-token: backend auth token--gateway-type:clashorsurge--gateway-url: gateway API URL
Optional flags
--gateway-token: gateway auth token (Authorizationfor Clash,x-keyfor Surge)--agent-id: custom agent ID (default: auto-generated from SHA256 of backend token, stable across restarts)--report-interval: report loop interval (default2s)--heartbeat-interval: heartbeat interval (default30s)--gateway-poll-interval: gateway pull interval (default2s)--request-timeout: HTTP timeout (default15s)--report-batch-size: max updates per report (default1000)--max-pending-updates: memory queue cap (default50000)--stale-flow-timeout: stale flow eviction timeout (default5m)--log: enable logs, set--log=falseto quiet mode--version: print version
Example: Clash
./neko-agent \
--server-url 'http://10.0.0.2:3000' \
--backend-id 8 \
--backend-token 'ag_xxx' \
--gateway-type 'clash' \
--gateway-url 'http://127.0.0.1:9090' \
--gateway-token 'clash-secret'
Example: Surge
./neko-agent \
--server-url 'http://10.0.0.2:3000' \
--backend-id 9 \
--backend-token 'ag_xxx' \
--gateway-type 'surge' \
--gateway-url 'http://127.0.0.1:9091' \
--gateway-token 'surge-key'
Best-practice defaults for remote LAN
--gateway-poll-interval=2s--report-interval=2s--heartbeat-interval=10s(faster offline detection)