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: 3 months ago
JSON representation
Just the panel for Hysteria2 / 仅仅是 Hysteria2 的面板
- Host: GitHub
- URL: https://github.com/jonssonyan/h-ui
- Owner: jonssonyan
- License: gpl-3.0
- Created: 2024-04-20T12:06:53.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2024-10-17T09:41:11.000Z (3 months ago)
- Last Synced: 2024-10-20T07:28:36.286Z (3 months ago)
- Topics: h-ui, hysteria2
- Language: Go
- Homepage:
- Size: 1.57 MB
- Stars: 863
- Watchers: 3
- Forks: 142
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome - jonssonyan/h-ui - Just the panel for Hysteria2 / 仅仅是 Hysteria2 的面板 (Go)
README
H UI
English / [简体中文](README_ZH.md)
Just the panel for Hysteria2
## 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
- Telegram notification
- 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: CentOS 8+/Ubuntu 20+/Debian 11+
CPU: x86_64/amd64 arm64/aarch64
Memory: ≥ 256MB
## Deployment
### Quick Install (Recommended)
Install Latest Version
```bash
bash <(curl -fsSL https://raw.githubusercontent.com/jonssonyan/h-ui/main/install.sh)
```
Install [Custom Version](https://github.com/jonssonyan/h-ui/releases)
```bash
bash <(curl -fsSL https://raw.githubusercontent.com/jonssonyan/h-ui/main/install.sh) v0.0.1
```
### systemd
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
# Custom web port, default is 8081
# sed -i "s|^ExecStart=.*|ExecStart=/usr/local/h-ui/h-ui -p 8081|" "/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/
```
### Docker
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 --cap-add=NET_ADMIN \
--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, default is 8081
```bash
docker run -d --cap-add=NET_ADMIN \
--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 8081
```
Set the time zone, default is Asia/Shanghai
```bash
docker run -d --cap-add=NET_ADMIN \
--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
```
## 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
- [TCP Brutal](https://github.com/apernet/tcp-brutal) (Recommended)
- [teddysun/across#bbrsh](https://github.com/teddysun/across#bbrsh)
- [Chikage0o0/Linux-NetSpeed](https://github.com/ylx2016/Linux-NetSpeed)
- [ylx2016/Linux-NetSpeed](https://github.com/ylx2016/Linux-NetSpeed)
## 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
Telegram Channel: 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
[](https://star-history.com/#jonssonyan/h-ui&Date)
## License
[GPL-3.0](LICENSE)