DSH Plugins Marketplace

DSH Plugins

Plugins

/

Security & Audit

/

dsh-static-token

d

dsh-static-token

Manifest valid

Configurable static launch token for the DeepSeek Harness Web GUI across restarts and reverse proxies.

hasBundlePatch

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_TOKEN from 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

  1. Token Strength: Tokens shorter than 16 characters are rejected on startup. Use a long, cryptographically random string (e.g. openssl rand -hex 24).
  2. 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 trustedHosts in your DSH configuration (e.g., dsh.lab.example.com). dsh-static-token only configures authentication; routing and host validation remain DSH host settings.
  3. 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

dsh-dev-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.

Manifest valid

★ 0

MIT

JavaScript

Nov 6, 2026

dsh plugin --profile web add dsh-dev-plugins

by siberiah2o

Remote access gateway for the DeepSeek Harness Web GUI: login auth + HTTP/WebSocket reverse proxy to the loopback DSH server.

Tools & CapabilitiesTerminal & ClientsManifest valid

★ 0

JavaScript

Aug 21, 2026

dsh plugin --profile web add dsh-plugin-remote

by 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.

Security & AuditManifest valid

★ 0

MIT

JavaScript

Nov 5, 2026

dsh plugin --profile web add @lvxianchao/dsh-guard

by NYSM803

Draggable floating restart button for the DeepSeek Harness(dsh) Web GUI:confirm, then restart the app and host.

UI & ExperienceDevelopment & InfrastructureManifest valid

★ 1

MIT

JavaScript

Nov 8, 2026

dsh plugin --profile web add dsh-plugin-restart-button

by zhouchengke2046

Independent one-click restart for DeepSeek Harness web (Settings page). · 独立的 DSH Web 一键重启插件。

Manifest valid

★ 0

MIT

JavaScript

Aug 19, 2026

dsh plugin --profile web add dsh-restart

by 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.

Tools & CapabilitiesTerminal & ClientsManifest valid

★ 0

MIT

JavaScript

Nov 3, 2026

dsh plugin --profile web add dsh-proxy-control