Initial vault setup
This commit is contained in:
@@ -0,0 +1,150 @@
|
||||
---
|
||||
title: Nezha
|
||||
created: 2026-06-07
|
||||
updated: 2026-06-07
|
||||
type: app
|
||||
tags: [catalogue, monitoring, server, go, dashboard, beginner]
|
||||
confidence: high
|
||||
contested: false
|
||||
sources: [https://selfh.st/apps/?tag=Monitoring, https://github.com/nezhahq/nezha]
|
||||
---
|
||||
# 📊 Nezha
|
||||
|
||||
> **Tableau de bord de monitoring serveur ultra-léger** : agents Go, UI moderne, alerting Telegram, et zéro base de données. Idéal pour surveiller une flotte de VPS en un coup d'œil.
|
||||
|
||||
## 📋 Informations Générales
|
||||
|
||||
| Champ | Valeur |
|
||||
| :--- | :--- |
|
||||
| **Site web** | [nezha.wiki](https://nezha.wiki/) |
|
||||
| **GitHub** | [nezhahq/nezha](https://github.com/nezhahq/nezha) |
|
||||
| **License** | Apache-2.0 |
|
||||
| **Langage** | Go |
|
||||
| **Étoiles GitHub** | 10 084 ⭐ |
|
||||
| **Dernière MAJ** | 2026-06-07 |
|
||||
| **Catégorie** | [[cat-monitoring|Monitoring]] |
|
||||
|
||||
## 📝 Description
|
||||
|
||||
**Nezha** (哪吒) est une **plateforme de monitoring serveur self-hosted** originaire de Chine et devenue très populaire dans la communauté homelab. Elle se distingue par son **architecture agent/serveur** minimaliste : un binaire Go léger poussé sur chaque machine, qui remonte en temps réel CPU, RAM, disque, réseau et uptime vers un dashboard central.
|
||||
|
||||
Contrairement à [[app-prometheus]] ou [[app-netdata]] qui sont orientés métriques/graphes, Nezha mise sur une **vision globale « cockpit »** : un seul écran affiche l'état de tous vos serveurs avec statuts colorés, alertes, et un historique de disponibilité.
|
||||
|
||||
- ✅ **Monitoring temps réel** : CPU, RAM, swap, disque, réseau, load average
|
||||
- ✅ **Agent ultra-léger** : binaire statique Go (~10 Mo), consomme < 50 Mo de RAM
|
||||
- ✅ **Alertes** : seuils CPU/RAM/disque, expiration de certificats, down de service
|
||||
- ✅ **Notifications** : Telegram, Discord, Slack, Email, Webhook, Bark, PushPlus
|
||||
- ✅ **Status page publique** personnalisable
|
||||
- ✅ **Commandes à distance** : exécuter un script sur un agent via le dashboard (avec confirmation)
|
||||
- ✅ **Multi-utilisateurs** avec rôles
|
||||
- ✅ **Pas de base de données** : stockage SQLite embarqué
|
||||
- ✅ **Docker, binaire Linux, One-Click scripts** (curl | bash)
|
||||
- ✅ **i18n** : chinois, anglais, japonais (FR partiel via traduction communautaire)
|
||||
|
||||
**Public cible** : **homelabeurs et admins de petits parcs** (< 100 serveurs) qui veulent un **cockpit visuel** sans se battre avec Prometheus + Grafana. Pour du graphique fin ou des millions de samples, partez sur [[app-netdata]] ou VictoriaMetrics.
|
||||
|
||||
## 🚀 Installation
|
||||
|
||||
### Option 1 : Docker Compose (serveur + agent intégrés)
|
||||
|
||||
```yaml
|
||||
# docker-compose.yml
|
||||
version: '3.8'
|
||||
services:
|
||||
nezha:
|
||||
image: ghcr.io/nezhahq/nezhahq:latest
|
||||
container_name: nezha
|
||||
restart: unless-stopped
|
||||
ports:
|
||||
- "8008:8008" # Web UI
|
||||
- "5555:5555" # Agent gRPC
|
||||
volumes:
|
||||
- nezha-data:/dashboard
|
||||
labels:
|
||||
- "traefik.enable=true"
|
||||
- "traefik.http.routers.nezha.rule=Host(`nezha.example.com`)"
|
||||
- "traefik.http.routers.nezha.entrypoints=websecure"
|
||||
- "traefik.http.routers.nezha.tls.certresolver=letsencrypt"
|
||||
- "traefik.http.services.nezha.loadbalancer.server.port=8008"
|
||||
|
||||
volumes:
|
||||
nezha-data:
|
||||
```
|
||||
|
||||
### Option 2 : One-Click install (script officiel)
|
||||
|
||||
```bash
|
||||
curl -L https://raw.githubusercontent.com/nezhahq/script/main/agent/install.sh -o nezha-agent.sh
|
||||
chmod +x nezha-agent.sh
|
||||
sudo ./nezha-agent.sh
|
||||
# Répondre aux questions : URL dashboard, secret
|
||||
```
|
||||
|
||||
### Option 3 : Binaire natif (agent seul)
|
||||
|
||||
```bash
|
||||
wget https://github.com/nezhahq/agent/releases/latest/download/nezha-agent_linux_amd64.zip
|
||||
unzip nezha-agent_linux_amd64.zip
|
||||
chmod +x nezha-agent
|
||||
sudo ./nezha-agent -s dashboard.example.com:5555 -p SECRET_KEY
|
||||
```
|
||||
|
||||
## ⚙️ Configuration Initiale
|
||||
|
||||
1. **Accéder au dashboard** : `https://nezha.example.com` (via [[app-traefik]])
|
||||
2. **Créer le compte admin** au premier lancement
|
||||
3. **Ajouter un serveur** : Servers > Add > récupérer la commande d'installation de l'agent
|
||||
4. **Déployer l'agent** sur chaque machine à surveiller (Docker, script, binaire, ou OpenWrt)
|
||||
5. **Configurer les canaux de notification** : Settings > Notification > Telegram/Discord
|
||||
6. **Définir les règles d'alerte** : par serveur, seuils CPU/RAM/disque, expiration SSL
|
||||
|
||||
## 🔄 Alternatives
|
||||
|
||||
### Open Source
|
||||
- [[app-netdata]] — Métriques système en temps réel avec graphs détaillés
|
||||
- [[app-glances]] — Monitoring console/terminal cross-platform
|
||||
- [[app-uptime-kuma]] — Focus uptime/HTTP plutôt que ressources système
|
||||
- [[app-prometheus]] + Grafana — Stack pro, alerting avancé, mais lourde
|
||||
|
||||
### Comparaison Nezha vs autres
|
||||
|
||||
| Critère | Nezha | Netdata | Uptime Kuma | Prometheus |
|
||||
| :--- | :--- | :--- | :--- | :--- |
|
||||
| Self-hosted | ✅ | ✅ | ✅ | ✅ |
|
||||
| UI moderne | ✅ | ✅ | ✅ | ❌ (Grafana) |
|
||||
| Agents distribués | ✅ | ✅ | ❌ | ✅ |
|
||||
| Métriques système | ✅ | ✅✅ | ⚠️ ping | ✅ |
|
||||
| Alertes | ✅ | ✅ | ✅ | ✅✅ |
|
||||
| Base de données | ❌ (SQLite) | ⚠️ | ❌ | ✅ TSDB |
|
||||
| Setup | 5 min | 10 min | 5 min | 30+ min |
|
||||
|
||||
**Verdict** : Nezha est le **meilleur compromis** pour un **dashboard centralisé multi-serveurs** sans usine à gaz. Si vous voulez des graphs d'une profondeur infinie, allez sur [[app-netdata]] ; pour du pro, Prometheus + Grafana.
|
||||
|
||||
### Propriétaires (ce que Nezha remplace)
|
||||
- **Uptime.com** — Monitoring fleet payant
|
||||
- **Better Stack** — Cockpit serveur/incident
|
||||
- **Hetrixtools** — Free tier basique
|
||||
- **Solarwinds** (enterprise)
|
||||
|
||||
## 🔐 Sécurité
|
||||
|
||||
- **Auth intégrée** avec sessions sécurisées + 2FA (TOTP)
|
||||
- **HTTPS obligatoire** via [[app-traefik]] (reverse proxy + Let's Encrypt)
|
||||
- **Agent ↔ Serveur** : communication chiffrée sur gRPC (port 5555)
|
||||
- **Commandes à distance** : restreindre les scripts autorisés (whitelist)
|
||||
|
||||
## 📚 Ressources
|
||||
|
||||
- [GitHub nezhahq/nezha](https://github.com/nezhahq/nezha)
|
||||
- [Documentation officielle](https://nezha.wiki/)
|
||||
- [Site du projet](https://nezhahq.github.io/)
|
||||
|
||||
## Pages Liées
|
||||
- [[cat-monitoring]] — Catégorie Monitoring
|
||||
- [[app-uptime-kuma]] — Monitoring uptime
|
||||
- [[app-netdata]] — Métriques système détaillées
|
||||
- [[app-prometheus]] — Stack pro
|
||||
- [[app-glances]] — Monitoring terminal
|
||||
- [[app-traefik]] — Reverse proxy HTTPS
|
||||
- [[observabilite]] — Concept d'observabilité
|
||||
- [[checklist-monitoring-minimal]] — Checklist de démarrage
|
||||
Reference in New Issue
Block a user