januory/deepseek-harness-gateway
Agent half of a gateway that reaches customer dsh instances over an outbound-only tunnel, with no inbound port and no public IP.
Turns distributed dsh instances on customer machines into machines an administrator can operate from one portal. The agent bridges the machine's local dsh web over the reverse tunnel; the gateway holds the control plane — registration, approval, user assignment and audit — and the router that upgrades browser requests onto the right machine's tunnel. Operators then drive the assigned machine's dsh WebUI from the portal with zero public exposure on the customer side.
Install
dsh plugin --profile web add @januory/dsh-gateway-agentThe npm line installs the agent into a customer machine's dsh. The repository also contains the gateway server and portal (apps/gateway, apps/web) and the shared protocol and store packages; the README's local-checkout form targets ./plugins/dsh-gateway-agent, which is that monorepo layout rather than a second package. The agent is useless on its own: it needs a gateway to dial and a pairing code to be approved with.
Compatibility
The customer side needs no inbound listener, port mapping or public IP — the agent dials one outbound wss connection and the gateway relays the official dsh web UI (HTTP and WebSocket) untouched, so no fork of dsh is required. Machine onboarding is a pairing code plus an HMAC challenge-response approved by an administrator, and identity is issued by the gateway with all authorization enforced there rather than on the customer machine. Remote start/stop/restart of a machine's dsh is opt-in and needs a separate supervisor process. The gateway ships login rate-limit and session TTL defaults as environment variables (login attempts per IP and per account, idle session TTL 8h, absolute 24h), and those defaults are the security posture unless changed.
Details
- Repo: januory/deepseek-harness-gateway
- Category: Infrastructure & Deployment
- Stars: 2
- Version: 0.2.2 (npm)
Alternatives
sorsama/deepseek-harness-relay · KhanZou/Deepseek-Harness-as-Desktop · evanmormmm/deepseek-harness-desktop