@jamiexiongr/panda-agent
v0.1.9
Published
Panda agent runtime
Readme
@jamiexiongr/panda-agent
Published agent runtime for Panda.
Usage
panda-agent
panda-agent tailscareserv
panda-agent tailscareserv-pubtailscareserv and --tailscale-serve both enable automatic tailnet-only tailscale serve publishing.
tailscareserv-pub, --tailscale-serve-pub, and tailscale-funnel enable public tailscale funnel publishing.
When enabled, agent startup will:
- detect whether
tailscaleis available and online - run
tailscale serve --bgortailscale funnel --bg - print the generated Tailscale or public HTTPS URL in the startup log
- use the generated
https/wssURL as the direct agent address unless you already setPANDA_AGENT_DIRECT_BASE_URLorPANDA_AGENT_WS_BASE_URL
Environment
PANDA_AGENT_PORTLocal agent listen port. Default:4242PANDA_HUB_URLOptional hub control-plane URLPANDA_AGENT_TAILSCALE_SERVE_PORTTailscale HTTPS port. Default: same asPANDA_AGENT_PORTPANDA_AGENT_TAILSCALE_PUBLISH_MODEOptional publish mode. SupportsserveorfunnelPANDA_TAILSCALE_SERVE=1Optional env alternative to the startup flag
Notes
- Tailscale Serve publishes a tailnet HTTPS address, not a public Internet address.
- Tailscale Funnel publishes a public Internet HTTPS address and corresponding
wssendpoint. - If the agent and hub run on the same machine, use different Tailscale HTTPS ports to avoid collisions. The default setup is
hub -> 443,agent -> agent port.
