Skip to content

heruhendri/nezha

 
 

Repository files navigation



LOGO designed by 熊大 .

GitHub release (with filter)   Translation status

:trollface: Nezha Monitoring: Self-hostable, lightweight, servers and websites monitoring and O&M tool.

Supports monitoring system status, HTTP (SSL certificate change, upcoming expiration, expired), TCP, Ping and supports push alerts, run scheduled tasks and web terminal.

>> Official Forum | 官方论坛: 有点意思
>> Telegram Channel: 哪吒监控(中文通知频道)

>> Use Cases | 我们的用户 (Google)
>> Telegram Group: Nezha Monitoring Global (English Only), 哪吒监控(中文群组)

User Guide

Instalation

install Nezha Monitoring di VPS (Ubuntu 20.04/22.04). Nezha adalah panel monitoring seperti uptime monitor (mirip dengan Uptime Kuma) yang menggunakan agen client-server.


🔧 Persiapan

  1. Gunakan VPS dengan sistem operasi Ubuntu 20.04 / 22.04.

  2. Akses root atau user dengan sudo.

  3. Port yang harus terbuka:

    • TCP 80 & 443 (web dashboard)
    • TCP 5555 (default Nezha server port)
    • UDP 443 (untuk agen komunikasi via QUIC)

🖥️ Install Nezha Server

1. Update & Install dependencies

sudo apt update && sudo apt install -y curl wget unzip socat

2. Install Docker & Docker Compose

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

3. Jalankan Script Auto Install Server

Gunakan script resmi Nezha Server (dari GitHub):

bash <(curl -Ls https://raw.githubusercontent.com/heruhendri/nezhahq/main/script/install_server.sh)

Ikuti instruksi:

  • Masukkan domain (wajib sudah mengarah ke IP VPS)
  • Script akan mengatur SSL otomatis via acme.sh
  • Setelah selesai, panel akan tersedia di https://domain-anda

🧾 Login Nezha Panel

Setelah berhasil, buka https://domain-anda Login default:

  • Username: admin
  • Password: admin

Ganti password setelah login pertama.


⚙️ Install Nezha Agent (Di VPS/Server yang akan dimonitor)

Login ke dashboard → Tambah Agen → Salin perintah install agent. Contoh perintah:

bash <(curl -Ls https://raw.githubusercontent.com/nezhahq/nezhahq/main/script/install_agent.sh) \
--server your-domain.com:443 --key AGENT-KEY

Pastikan VPS agent bisa konek ke domain server Nezha (port 443 UDP terbuka).


🔁 Cek Status

  • Setelah agent dijalankan, status server akan muncul di dashboard.
  • Jika tidak muncul, pastikan port dan domain benar.

📌 Tips Tambahan

  • Gunakan Cloudflare DNS untuk domain.
  • Aktifkan firewall hanya jika port 80, 443, dan 5555 (TCP) serta 443 (UDP) dibuka.
  • Untuk multi-server monitoring, cukup jalankan agent di tiap VPS.

Contributing

Translation

Translation status

Is Nezha not in your language, or the translation is incorrect or incomplete? Get involved in the translations on Hosted Weblate.

Screenshots

用户前台 @hamster1963 管理后台 @nezhahq
user admin
hamster1963/nezha-dash nezhahq/admin-frontend

add your theme to service/singleton/frontend-templates.yaml

Contributors

naiba

UUBulb Akkia 卖女孩的小火柴 nap0o 黑歌 xykt MikoyChinese Weblate (bot) JackieSung4ev Kris Lemoe spiritlhl 刘颜溪 CosmosZ-code Ko no dio Kris Mmx233 rootmelo92118 Moraxyc Xu 1ridic 仓鼠 zhucaidan Sean lyj fscarmen no-name-now JSker9 Hsukqi Lee Darc Z. Creling Core F adminsama Acgpiano eya46 guoyongchang hiDandelion honeok IYUANWEIZE igophper lvyaoting quanljh unclezs 缘生 严浩 凌 榆木 93 Tony TomyJan Tater Li Tao Chen Spetrum Nanjing Hopefun Network Technology Co. Ltd. Mingzhuo Yin Martijn Lindeman Leon KorenKrita Ian Li GreenTeodoro839 Esdese :D Coming

Special Thanks

  • IPInfo for providing an accurate GeoIP Database.

Star History

Star History Chart

About

:trollface: Self-hosted, lightweight server and website monitoring and O&M tool

Resources

License

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Go 96.3%
  • Shell 3.2%
  • Other 0.5%