alireza0/s-ui

Overview

S-UI is a self-hosted web panel for SagerNet/Sing-Box, aimed at people who run their own proxy nodes and need a browser interface instead of hand-editing configuration. It covers inbound and outbound management, a traffic routing interface, per-client traffic caps and expiration dates, subscription links in link/JSON/Clash formats, and system status with online client, inbound and outbound traffic statistics. The panel ships in English, Farsi, Vietnamese, Simplified Chinese, Traditional Chinese and Russian, and provides a token-authenticated REST API under /apiv2.

Quick start

On Linux or macOS, the documented one-line installer downloads and runs the install script:

bash <(curl -Ls https://raw.githubusercontent.com/alireza0/s-ui/master/install.sh)

You can select the installer language with SUI_LANG (for example SUI_LANG=zhcn). On Alpine, install bash first with apk add bash, then run the same script; the installer sets up an OpenRC service.

After installation, the panel listens on port 2095 at path /app/, the subscription service on port 2096 at path /sub/, and the default credentials are admin/admin. Change the password before exposing the panel. If you prefer containers, the README offers a Docker Compose file and a docker run command that maps ports 2095, 2096, 443 and 80 and mounts ./db/ and ./cert/ as volumes.

On Windows, download the release ZIP, extract it, and run install-windows.bat as Administrator, then open http://localhost:2095/app.

Constraints

• The project targets Linux amd64/arm64/armv7/armv6/armv5/386/s390x and Windows amd64/386/arm64; macOS support is labeled experimental.
• The panel and subscription service are separate ports and paths, so both need to be reachable for subscription links to work.
• HTTPS for the panel and subscription requires a domain plus an SSL certificate supplied by the operator; the README shows a Certbot example.
• The README explicitly says the project is for personal learning and communication and should not be used in production.
• The license is GPL-3.0.

HotRepo's take

The repository collected snapshots over 2026-05-21 and 2026-05-22 with daily gains of 25 and 27 stars, then appeared on the Go weekly list dated 2026-11-04 with 78 stars added and a best position of 19. The two daily records are close in value and the weekly record is a different period and language list, so they do not establish a trend; they do show continued moderate visibility within the Go ecosystem. With over 10k stars and nearly 2k forks, the project has a visible community footprint, including third-party traffic-reset tools and a Telegram bot listed in the README, which suggests people are actively running it beyond the default panel.

Project source and documentation