explaingit

sagernet/sing-box-dashboard

Analysis updated 2026-05-18

28TypeScriptAudience · developerComplexity · 2/5LicenseSetup · moderate

TLDR

A web dashboard for controlling the sing-box network proxy tool through a browser instead of config files, with a public hosted version already available.

Mindmap

mindmap
  root((sing-box-dashboard))
    What It Does
      Web UI for sing-box
      Visual proxy control
    Tech Stack
      TypeScript
    Use Cases
      Manage proxy visually
      Public hosted instance
    Audience
      Developers
      Proxy users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Open the publicly hosted dashboard to manage a sing-box proxy without touching configuration files.

USE CASE 2

Use it as a visual front end to observe and control a sing-box proxy setup.

What is it built with?

TypeScript

How does it compare?

sagernet/sing-box-dashboardaudemodo/audemodo-responsive-keepalivecahn91/gpt-repo-mcp
Stars282828
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderateeasymoderate
Complexity2/52/53/5
Audiencedeveloperdevelopervibe coder

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

README gives no self-hosting instructions, connecting a self-hosted copy to your own sing-box requires reading the source directly.

GPL v3: you can use and modify it, but if you distribute a modified version, you must release your changes under the same license.

In plain English

sing-box is a network proxy program designed for users who want to route their internet traffic through different servers or protocols. Examples of why someone might use it include accessing region-restricted content, improving connection stability, or running a private relay. This repository contains a web dashboard that sits on top of sing-box, giving users a visual interface to control and observe their proxy setup rather than managing it through configuration files or command lines. The dashboard is built with TypeScript and served as a web page you open in a browser. The project maintainers host a public version of this dashboard at sing-box-dashboard.sagernet.org, also reachable at the shorter address dash.sing-box.app. The README notes that Chrome users can load that public instance over HTTPS, while other browsers must use a plain HTTP connection instead. The repository documentation is minimal. There are no setup instructions, no description of what features the dashboard interface offers, and no explanation of how to connect it to a locally running sing-box instance. What the README does cover is the license, which is the GNU General Public License version 3. That license means anyone who distributes a modified version of this software must also release those modifications under the same license terms. Beyond the public instance URL and the license text, the project does not provide further documentation. If you are looking to use this dashboard, your starting point would be the public hosted version linked above. Connecting a self-hosted copy to your own sing-box server would require digging into the repository code directly, as the README gives no guidance on that path.

Copy-paste prompts

Prompt 1
Explain what sing-box is and why someone might want a dashboard for it.
Prompt 2
How do I connect this dashboard to my own self-hosted sing-box instance?
Prompt 3
What does GPL v3 mean for a project I want to modify and redistribute?

Frequently asked questions

What is sing-box-dashboard?

A web dashboard for controlling the sing-box network proxy tool through a browser instead of config files, with a public hosted version already available.

What language is sing-box-dashboard written in?

Mainly TypeScript. The stack also includes TypeScript.

What license does sing-box-dashboard use?

GPL v3: you can use and modify it, but if you distribute a modified version, you must release your changes under the same license.

How hard is sing-box-dashboard to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is sing-box-dashboard for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.