Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/jonssonyan/h-ui

Just the panel for Hysteria2 / 仅仅是 Hysteria2 的面板
https://github.com/jonssonyan/h-ui

h-ui hysteria2

Last synced: 9 days ago
JSON representation

Just the panel for Hysteria2 / 仅仅是 Hysteria2 的面板

Lists

README

        

H UI

H UI

English / [简体中文](README_ZH.md)

Just the panel for Hysteria2

仅仅是 Hysteria2 的面板


License: GPL-3.0
GitHub stars
GitHub forks
GitHub release
Docker pulls

![cover](./docs/images/cover.png)

## Features

- Lightweight, low resource usage, easy to deploy
- Monitor system status and Hysteria2 status
- Limit user traffic, user online status, force users to log off, number of online users, reset user traffic
- Limit the number of users' online devices at the same time, the number of online devices
- User subscription link, node URL, import and export users
- Managing Hysteria2 configurations and Hysteria2 versions
- Change the Web port, modify the Hysteria2 traffic multiplier
- View, import, and export system logs and Hysteria2 logs
- I18n: English, 简体中文
- Page adaptation, support night mode, custom page themes
- More features waiting for you to discover

## Recommended OS

OS version: CentOS 8+/Ubuntu 20+/Debian 11+

CPU Architecture: x86_64/amd64

Memory: ≥ 128MB

## Deployment

### Docker (Recommended)

1. Install Docker

https://docs.docker.com/engine/install/

```bash
bash <(curl -fsSL https://get.docker.com)
```

2. Start a container

```bash
docker pull jonssonyan/h-ui

docker run -d --name h-ui --restart always \
--network=host \
-v /h-ui/bin:/h-ui/bin \
-v /h-ui/data:/h-ui/data \
-v /h-ui/export:/h-ui/export \
-v /h-ui/logs:/h-ui/logs \
jonssonyan/h-ui
```

Custom web port

```bash
docker run -d --name h-ui --restart always \
--network=host \
-v /h-ui/bin:/h-ui/bin \
-v /h-ui/data:/h-ui/data \
-v /h-ui/export:/h-ui/export \
-v /h-ui/logs:/h-ui/logs \
jonssonyan/h-ui \
./h-ui -p [port]
```

Set the time zone, default is Asia/Shanghai

```bash
docker run -d --name h-ui --restart always \
--network=host \
-e TZ=Asia/Shanghai \
-v /h-ui/bin:/h-ui/bin \
-v /h-ui/data:/h-ui/data \
-v /h-ui/export:/h-ui/export \
-v /h-ui/logs:/h-ui/logs \
jonssonyan/h-ui
```

Uninstall

```bash
docker rm -f h-ui
docker rmi jonssonyan/h-ui
rm -rf /h-ui
```

### Manual

Executable files: https://github.com/jonssonyan/h-ui/releases

```bash
mkdir -p /usr/local/h-ui/
curl -fsSL https://github.com/jonssonyan/h-ui/releases/latest/download/h-ui-linux-amd64 -o /usr/local/h-ui/h-ui && chmod +x /usr/local/h-ui/h-ui
curl -fsSL https://raw.githubusercontent.com/jonssonyan/h-ui/main/h-ui.service -o /etc/systemd/system/h-ui.service
systemctl daemon-reload
systemctl enable h-ui
systemctl restart h-ui
```

Uninstall

```bash
systemctl stop h-ui
rm -rf /etc/systemd/system/h-ui.service /usr/local/h-ui/
```

## Default Installation Information

- Panel Port: 8081
- Username/Password: sysadmin

## System Upgrade

Export the user, system configuration, and Hysteria2 configuration in the management background, redeploy the latest
version of h-ui, and import the data into the management background after the deployment is complete.

## FAQ

[English > FAQ](./docs/FAQ.md)

## Performance Optimization

- Scheduled server restart

```bash
0 4 * * * /sbin/reboot
```

- Install Network Accelerator
- [Chikage0o0/Linux-NetSpeed](https://github.com/ylx2016/Linux-NetSpeed)
- [ylx2016/Linux-NetSpeed](https://github.com/ylx2016/Linux-NetSpeed)
- [teddysun/across#bbrsh](https://github.com/teddysun/across#bbrsh)

## Client

https://v2.hysteria.network/docs/getting-started/3rd-party-apps/

## Development

Go >= 1.20, Node.js >= 18.12.0

- frontend

```bash
cd frontend
pnpm install
npm run dev
```

- backend

```bash
go run main.go
```

## Build

- frontend

```bash
npm run build:prod
```

- backend

Windows: [build.bat](build.bat)

Mac/Linux: [build.sh](build.sh)

## Other

Contact me: https://t.me/jonssonyan_channel

You can subscribe to my channel on YouTube: https://www.youtube.com/@jonssonyan

## Contributors

Thanks to everyone who contributed to this project.



## Star History

[![Star History Chart](https://api.star-history.com/svg?repos=jonssonyan/h-ui&type=Date)](https://star-history.com/#jonssonyan/h-ui&Date)

## License

[GPL-3.0](LICENSE)