dsh-static-token
Manifest validConfigurable static launch token for the DeepSeek Harness Web GUI across restarts and reverse proxies.
dsh-static-token
English | 中文
A DeepSeek Harness (DSH) plugin to configure a persistent, static launch token for the Web GUI, preventing session expiration and authentication issues behind reverse proxies or across remote devices.
The Problem
By default, DSH generates an ephemeral, in-memory launch token every time the service starts. On headless, reverse-proxied, or containerized deployments (such as Kubernetes with Traefik/Authentik), restarting the process invalidates the current token. Accessing the dashboard from a secondary device (e.g., a phone) requires retrieving a new token from the host logs.
The Solution
dsh-static-token hooks into the connection service and overrides the generated launch token with a fixed token defined via an environment variable or profile configuration.
Features
- Static Launch Token: Keep the same token across service restarts and host reboots.
- Minimum Length Enforcement: Enforces a minimum token length of 16 characters to prevent weak authentication credentials.
- Environment Variable Priority: Reads
DSH_WEB_TOKENfrom the process environment first, with fallback to profile plugin configuration. - Seamless Reverse Proxy Integration: Simplifies setting up bookmarks or forward-auth setups without constantly tracking server logs.
- Zero Overhead: Pure ESM, no external runtime dependencies, minimal memory footprint.
Security & Architecture Notes
- Token Strength: Tokens shorter than 16 characters are rejected on startup. Use a long, cryptographically random string (e.g.
openssl rand -hex 24). - Reverse Proxy & Host Header: When running behind a reverse proxy (Traefik, Nginx, Caddy), DSH's native connection plugin requires proxy domains to be listed under
trustedHostsin your DSH configuration (e.g.,dsh.lab.example.com).dsh-static-tokenonly configures authentication; routing and host validation remain DSH host settings. - Internal Host Property: This plugin overrides
ctx.connection.browserAuth.launchToken. Major upstream DSH updates that refactor connection internals might require corresponding plugin updates.
Installation
Via DSH CLI
dsh plugin --profile web add dsh-static-token
From Local Source
git clone https://github.com/mdalboni/dsh-static-token.git
dsh plugin --profile web add link:./dsh-static-token
Configuration
You can supply your static token in one of two ways:
1. Environment Variable (Recommended for Systemd / Containers)
Export DSH_WEB_TOKEN in your environment or service definition:
export DSH_WEB_TOKEN="your-custom-secure-token-here"
In a systemd service (e.g., /etc/systemd/system/dsh.service):
[Service]
Environment="DSH_WEB_TOKEN=your-custom-secure-token-here"
2. Plugin Configuration
Configure the token directly in your DSH profile configuration:
# cordis.patch.yml or profile configuration
dsh-static-token:
token: "your-custom-secure-token-here"
Usage
Once configured and restarted, authenticate any new device or browser by visiting:
https://your-dsh-domain.com/?token=your-custom-secure-token-here
DSH will set its standard 30-day signed session cookie and redirect to the clean URL.
Testing
Run the included test suite using Node.js:
node test.js
License
MIT © Maxwell Dalboni
Comments
Loading…
Similar plugins
by 0xshawn
Serve the DeepSeek Harness (dsh) Web UI through a non-localhost authority: trusted hosts, loopback page parity, pinned launch token, no patching.
★ 0
MIT
JavaScript
Nov 6, 2026
dsh plugin --profile web add dsh-dev-pluginsby siberiah2o
Remote access gateway for the DeepSeek Harness Web GUI: login auth + HTTP/WebSocket reverse proxy to the loopback DSH server.
★ 0
JavaScript
Aug 21, 2026
dsh plugin --profile web add dsh-plugin-remoteby lvxianchao
Password gate for the DeepSeek Harness Web UI: one login, automatic launch-token exchange, Host/Origin rewrite, and a secure-context polyfill. Zero dependencies.
★ 0
MIT
JavaScript
Nov 5, 2026
dsh plugin --profile web add @lvxianchao/dsh-guardby NYSM803
Draggable floating restart button for the DeepSeek Harness(dsh) Web GUI:confirm, then restart the app and host.
★ 1
MIT
JavaScript
Nov 8, 2026
dsh plugin --profile web add dsh-plugin-restart-buttonby zhouchengke2046
Independent one-click restart for DeepSeek Harness web (Settings page). · 独立的 DSH Web 一键重启插件。
★ 0
MIT
JavaScript
Aug 19, 2026
dsh plugin --profile web add dsh-restartby Bai-Ziyi
Pre-launch and runtime HTTP proxy control for DeepSeek Harness: writes the user-level .env so the launcher and the first requests are proxied, then keeps it in sync from a Plugins-page switch.
★ 0
MIT
JavaScript
Nov 3, 2026
dsh plugin --profile web add dsh-proxy-control