English | δΈζ
A minimalist and beautiful server monitoring dashboard. Powered by Go, millisecond-level latency, one-click deployment.
Thanks to the following sponsors for supporting this project!
|
|
|
|
|
|
- π Real-time Monitoring - WebSocket real-time push of system metrics
- π₯οΈ Multi-Server Management - Support monitoring multiple servers
- π» CPU / Memory / Disk / Network - Comprehensive monitoring
- π¨ Modern UI - Glassmorphism design with smooth animations
- π Secure Authentication - JWT authentication protects admin interfaces
- β‘ One-Click Deployment - Docker / script one-click installation
- Data aggregation and optimization
- Billing and cycle management
- Global map view
- Performance testing (speedtest / latency)
- Media unlock detection
- Custom banner / slogan
- Referral & affiliate settings
- Alert notifications (Email / Telegram / Discord / Webhook)
- Custom dashboard layout
- Mobile responsive optimization
- Server grouping and tagging
- Dark / Light theme switching
- Custom theme
- Improve vstats-cli
- Improve vstats-cloud
| Resource | Link |
|---|---|
| π Full Documentation | vstats.zsoft.cc |
| π― Online Demo | vps.zsoft.cc |
| π³ Docker Hub | zsai001/vstats-server |
| π¦ GitHub Releases | Download Page |
# Docker one-click deployment
mkdir -p data
sudo chown -R 1000:1000 data
docker run -d --name vstats-server -p 3001:3001 \
-v $(pwd)/data:/app/data zsai001/vstats-server:latestFor more installation methods, please visit Documentation Site
Use the official installation script to install Server with one command:
curl -fsSL https://vstats.zsoft.cc/install.sh | sudo bashOr use wget:
wget -qO- https://vstats.zsoft.cc/install.sh | sudo bashAfter installation, visit http://your-server-ip:3001 to access the control panel.
Get Admin Password:
# Linux
journalctl -u vstats | grep -i password
# macOS
tail -20 ~/.vstats/data/vstats.log | grep -i password
# Or reset password
/opt/vstats/vstats-server --reset-password # Linux
~/.vstats/vstats-server --reset-password # macOSRun the following command on the monitored server to install Agent:
curl -fsSL https://vstats.zsoft.cc/agent.sh | sudo bash -s -- \
--server http://your-server-ip:3001 \
--name "$(hostname)" \
--token "your-admin-token"Parameter Description:
--server: Server access address--name: Server display name (optional, defaults to hostname)--token: Admin Token (obtained from Server control panel)
Server Upgrade:
curl -fsSL https://vstats.zsoft.cc/install.sh | sudo bash -s -- upgradeAgent Upgrade:
curl -fsSL https://vstats.zsoft.cc/agent.sh | sudo bash -s -- --upgradeServer Uninstall:
curl -fsSL https://vstats.zsoft.cc/install.sh | sudo bash -s -- uninstallAgent Uninstall:
curl -fsSL https://vstats.zsoft.cc/agent.sh | sudo bash -s -- --uninstallAfter installation, Server and Agent will be registered as systemd services and can be managed using systemctl commands.
Check Service Status:
systemctl status vstatsStart Service:
systemctl start vstatsStop Service:
systemctl stop vstatsRestart Service:
systemctl restart vstatsReload Configuration (without restart):
systemctl reload vstatsEnable Auto-start on Boot:
systemctl enable vstatsDisable Auto-start on Boot:
systemctl disable vstatsView Service Logs:
# View all logs
journalctl -u vstats
# View logs in real-time (similar to tail -f)
journalctl -u vstats -f
# View last 100 lines of logs
journalctl -u vstats -n 100
# View logs for a specific time period
journalctl -u vstats --since "2024-01-01 00:00:00" --until "2024-01-02 00:00:00"Check Service Status:
systemctl status vstats-agentStart Service:
systemctl start vstats-agentStop Service:
systemctl stop vstats-agentRestart Service:
systemctl restart vstats-agentEnable Auto-start on Boot:
systemctl enable vstats-agentDisable Auto-start on Boot:
systemctl disable vstats-agentView Service Logs:
# View all logs
journalctl -u vstats-agent
# View logs in real-time
journalctl -u vstats-agent -f
# View last 100 lines of logs
journalctl -u vstats-agent -n 100# View all enabled services
systemctl list-units --type=service --state=running
# Check if service is running
systemctl is-active vstats
systemctl is-active vstats-agent
# Check if service is enabled for auto-start
systemctl is-enabled vstats
systemctl is-enabled vstats-agent
# Reload systemd configuration (required after modifying service files)
systemctl daemon-reloadEncountered issues or have suggestions? Welcome to join the Telegram group for real-time feedback:
yeah.cx with ipv6 vps for testing
MIT License
Welcome to submit Issues and Pull Requests!