Skip to content

NodePassProject/NodePassDash

Repository files navigation

NodePassDash

Language: English | 简体中文

Version GitHub license

NodePassDash is a modern web dashboard for managing NodePass endpoints, tunnels, and services. It ships as a single Go binary (Gin + GORM + SQLite) with an embedded React (Vite + TypeScript + HeroUI) frontend, and provides real-time telemetry via SSE/WebSocket.

Demo

Important: demo environment — do not change the password and do not submit any sensitive information.

Highlights

  • Modern, clean dashboard: responsive UI built with React + Vite + TypeScript + HeroUI.
  • Real-time monitoring: SSE/WebSocket updates for tunnel status, traffic, and logs.
  • Multi-dimensional charts: traffic trends (hour/day/week) with detailed drill-down views.
  • Powerful NodePass management: endpoints, tunnels, and services in one place (including batch actions & sorting).
  • Scenario-based creation: guided wizards/templates to create common setups faster and safer.
  • OAuth2 login support: configure providers (e.g. GitHub / Cloudflare) and optionally disable password login.
  • i18n: built-in multilingual UI support.
  • Personalization: privacy mode, theme/language onboarding, and configurable experience.
  • Operational tooling: file-log viewer, network debugging utilities, and endpoint system stats charts.
  • Mobile-friendly workflows: QR code output for importing into the mobile app.
  • Safer at scale: search/filter/sort, grouping, tagging, and batch operations for day-to-day maintenance.
  • Release awareness: built-in version visibility and update notifications to help you stay current.
  • Portable architecture: embedded frontend + single-service runtime, easy to run as a container or a systemd service.

Screenshots

Login Dashboard Tunnels
Tunnel Details Endpoints Endpoint Details
Services Service Details Settings

Quick Start

  • Docker (recommended): docs/en/DOCKER.md
  • Binary + systemd: docs/en/BINARY.md
  • Development: docs/en/DEVELOPMENT.md

Documentation

CLI Flags

./nodepassdash --help
./nodepassdash --version
./nodepassdash --port 8080
./nodepassdash --log-level INFO
./nodepassdash --cert /path/to/cert.pem --key /path/to/key.pem
./nodepassdash --disable-login
./nodepassdash --sse-debug-log
./nodepassdash --resetpwd

License

BSD-3-Clause. See LICENSE.

Disclaimer

This project is provided “as is”, without any express or implied warranties. You are responsible for complying with local laws and regulations and using it only for lawful purposes. The authors are not liable for any direct, indirect, incidental, or consequential damages. The authors reserve the right to modify features and this statement at any time.

Support

Sponsors

Stargazers

Star History Chart