2s-ui

2S-UI

English · فارسی · Tiếng Việt · 简体中文 · 繁體中文 · Русский

An actively maintained sing-box web panel for multi-protocol proxy management, subscription delivery, traffic monitoring, and self-hosted deployment.

Disclaimer: This project is only for personal learning and communication, please do not use it for illegal purposes, please do not use it in a production environment

If you think this project is helpful to you, you may wish to give a🌟

Want to contribute? See CONTRIBUTING.md for development setup, coding conventions, testing, and the pull request process.

2S-UI is based on alireza0/s-ui and is maintained as a continued fork. It keeps the original panel direction while updating sing-box support, multi-protocol capabilities, deployment scripts, and ongoing fixes. Thanks to the original author and contributors.

Quick Overview

Supported Platforms

Screenshots

Other UI Screenshots

API Documentation

API-Documentation Wiki

Default Installation Information

• Panel Port: 2095
• Panel Path: /app/
• Subscription Port: 2096
• Subscription Path: /sub/
• User/Password: admin

Install & Upgrade to Latest Version

Linux/macOS

bash <(curl -Ls https://raw.githubusercontent.com/shenaba/2s-ui/main/install.sh)

Windows

1. Download the latest Windows release from GitHub Releases
2. Extract the ZIP file
3. Run install-windows.bat as Administrator
4. Follow the installation wizard

Install legacy Version

Step 1: To install your desired legacy version, add the version to the end of the installation command. e.g., ver v1.5.5:

VERSION=v1.5.5 && bash <(curl -Ls https://raw.githubusercontent.com/shenaba/2s-ui/$VERSION/install.sh) $VERSION

Manual installation

Linux/macOS

1. Get the latest version of 2S-UI based on your OS/Architecture from GitHub: https://github.com/shenaba/2s-ui/releases/latest
2. OPTIONAL Get the latest version of s-ui.sh https://raw.githubusercontent.com/shenaba/2s-ui/main/s-ui.sh
3. OPTIONAL Copy s-ui.sh to /usr/bin/s-ui and run chmod +x /usr/bin/s-ui.
4. Extract s-ui tar.gz file to a directory of your choice and navigate to the directory where you extracted the tar.gz file.
5. Copy *.service files to /etc/systemd/system/ and run systemctl daemon-reload.
6. Enable autostart and start 2S-UI service using systemctl enable s-ui --now
7. Start sing-box service using systemctl enable sing-box --now

Windows

1. Get the latest Windows version from GitHub: https://github.com/shenaba/2s-ui/releases/latest
2. Download the appropriate Windows package (e.g., s-ui-windows-amd64.zip)
3. Extract the ZIP file to a directory of your choice
4. Run install-windows.bat as Administrator
5. Follow the installation wizard
6. Access the panel at http://localhost:2095/app

Uninstall 2S-UI

sudo -i

systemctl disable s-ui  --now

rm -f /etc/systemd/system/sing-box.service
systemctl daemon-reload

rm -fr /usr/local/s-ui
rm /usr/bin/s-ui

Install using Docker

curl -fsSL https://get.docker.com | sh

mkdir 2s-ui && cd 2s-ui
wget -q https://raw.githubusercontent.com/shenaba/2s-ui/main/docker-compose.yml
docker compose up -d

mkdir 2s-ui && cd 2s-ui
docker run -itd \
    -p 2095:2095 -p 2096:2096 -p 443:443 \
    -v $PWD/db/:/app/db/ \
    -v $PWD/cert/:/root/cert/ \
    --name s-ui --restart=unless-stopped \
    ghcr.io/shenaba/2s-ui:latest

git clone https://github.com/shenaba/2s-ui
docker build -t 2s-ui .

Manual run ( contribution )

./runSUI.sh

# clone repository
git clone https://github.com/shenaba/2s-ui

# remove old frontend compiled files
rm -fr web/html/*
# apply new frontend compiled files
cp -R frontend/dist/ web/html/
# build
go build -o sui main.go

./sui

Languages

• English
• Farsi
• Vietnamese
• Chinese (Simplified)
• Chinese (Traditional)
• Russian

Features

• Supported protocols:
  • General: Mixed, SOCKS, HTTP, HTTPS, Direct, Redirect, TProxy
  • V2Ray based: VLESS, VMess, Trojan, Shadowsocks
  • Other protocols: ShadowTLS, Hysteria, Hysteria2, Naive, TUIC
• Supports XTLS protocols
• An advanced interface for routing traffic, incorporating PROXY Protocol, External, and Transparent Proxy, SSL Certificate, and Port
• An advanced interface for inbound and outbound configuration
• Clients’ traffic cap and expiration date
• Displays online clients, inbounds and outbounds with traffic statistics, and system status monitoring
• Subscription service with ability to add external links and subscription
• HTTPS for secure access to the web panel and subscription service (self-provided domain + SSL certificate)
• Automatic SSL certificates — just enter a domain and 2S-UI issues and auto-renews a free Let's Encrypt certificate for you (no certbot, no cron jobs)
• Dark/Light theme

Environment Variables

SSL Certificate

🔐 Automatic Certificates (ACME / Let's Encrypt) — Recommended

Just enter a domain in Panel Settings (certificate mode → ACME) and 2S-UI auto-issues and auto-renews a free Let's Encrypt certificate — no certbot, no cron jobs. Web panel and subscription service can be enabled independently. Once done, the panel is reachable at https://<your-domain>:2095/app.

Requires TCP port 80 reachable from the internet (HTTP-01 challenge). To publish port 80 with Docker: uncomment the 80:80 line in docker-compose.yml, or add -p 80:80 to docker run. Certificates are stored under cert/ and survive restarts. If the domain/port is misconfigured, 2S-UI falls back to HTTP.

snap install core; snap refresh core
snap install --classic certbot
ln -s /snap/bin/certbot /usr/bin/certbot

certbot certonly --standalone --register-unsafely-without-email --non-interactive --agree-tos -d <Your Domain Name>

Stargazers over Time