Agent kurulumu (systemd / Docker) | Yardım ve kılavuzlar ePulz.io

LAN aracısı, iç ağdaki Linux cihazınızda çalışan ve internetten erişilemeyen hizmetleri (dahili DNS, intranet, ERP, NAS, yazıcılar) kontrol eden küçük bir Python sürecidir. Dışarıya HTTPS üzerinden iletişim kurar, bu nedenle ağa doğru açık bir porta ihtiyaç duymaz.

Kısaca: Panoda bir aracı oluşturun, token'i kopyalayın ve hedef cihazda tek bir kurulum komutu çalıştırın. Tüm işlem 2 ila 3 dakika sürer.

Neye ihtiyacınız olacak

Root erişimi olan herhangi bir Linux (Debian, Ubuntu, Raspberry Pi OS, Fedora, Alma/Rocky, Arch, openSUSE, Alpine)
x86_64, aarch64 (Raspberry Pi 4/5), armv7l (Raspberry Pi 3) veya armv6l (RPi Zero) mimarisi
epulz.io adresine giden HTTPS bağlantısı (port 443)
Python 3.8 veya daha yenisi (eksikse kurulum aracı bunu paket yöneticisinden ekler)

Aracı yaklaşık 20 MB RAM ve boştayken yüzde 1'den az CPU kullanır. LXC kapsayıcısında, sanal makinede (Proxmox, VMware) veya Docker kapsayıcısında da çalışır. systemd'nin yanı sıra OpenRC'yi (Alpine) de destekler.

Tamamen denetlenebilir: aracının tamamı tek bir Python dosyasıdır (~600 satır, yalnızca standart kütüphane) ve kurulum aracı herkese açık bir betiktir. Çalıştırmadan önce her satırı okuyabilirsiniz: epulzio-agent.py ve install-agent.sh.

1. Bir aracı oluşturun ve token'i kopyalayın

Pano - LAN aracıları bölümünü açın.
Anlaşılır bir ad girin (örneğin "İstanbul sunucu odası" veya "Mağazadaki RPi") ve + Aracı oluştur düğmesine tıklayın.
Pano, aracı token'ini (epulzio_...) ve kopyalamaya hazır kurulum komutlarını gösterir.

Token yalnızca bir kez gösterilir. Hemen kopyalayın. Onu herkese açık şekilde paylaşmayın ve GitHub'da yayınlamayın. Kaybederseniz veya sızarsa, aracıyı panoda iptal edin (Revoke) ve yeni bir tane oluşturun.

2. Kurulum komutunu çalıştırın

Hedef cihazda bir terminalde (token'i kendinizinkiyle değiştirin):

curl -fsSL https://epulz.io/install-agent.sh | sudo bash -s epulzio_TOKENINIZ

Daha temkinli yaklaşım (ilk kurulumda öneririz): önce betiği indirin ve okuyun:

curl -fsSL https://epulz.io/install-agent.sh -o install-agent.sh
less install-agent.sh        # ne yaptığını okuyun (1 dk)
sudo bash install-agent.sh epulzio_TOKENINIZ

Kurulum aracı otomatik olarak:

Mimariyi ve dağıtımı tanır (apt / dnf / apk / pacman / zypper)
Python 3.8+ ve ping aracının varlığını doğrular, gerekirse bunları kurar
epulz.io bağlantısını test eder
Aracıyı /opt/epulzio-agent/ dizinine indirir
epulzio-agent hizmetini oluşturur (systemd, Alpine'de OpenRC) ve başlatır
Sistem yeniden başlatıldığında otomatik başlatmayı etkinleştirir

Tüm kurulum yaklaşık 30 saniye sürer.

3. Aracının çalıştığını doğrulayın

Cihazdaki hizmet durumu:

sudo systemctl status epulzio-agent

active (running) görmelisiniz.

ePulz.io panosunda çevrimiçi durumlu LAN aracıları listesi — Pano - LAN aracıları: durum, son temas ve aracı sürümü

Pano - LAN aracıları bölümünde durum 30 saniye içinde görünür:

çevrimiçi - son yaşam sinyali (heartbeat) 2 dakikadan kısa süre önce geldi
zaman damgası - son heartbeat 2 ila 10 dakika önceydi
çevrimdışı - son heartbeat 10 dakikadan eski (uyarı, yalnızca 5 dakika sessizlikten sonra gelir)

Docker varyantı

systemd yoksa (TrueNAS, Synology, Unraid, k3s) veya bir kapsayıcı tercih ediyorsanız panodaki komutu kullanın:

docker run -d --name epulzio-agent --restart unless-stopped \
  --network host \
  -e EPULZIO_AGENT_TOKEN=epulzio_TOKENINIZ \
  python:3.12-alpine sh -c "apk add -q --no-cache iputils && wget -qO /agent.py https://epulz.io/static/agent/epulzio-agent.py && python /agent.py"

--network host anahtarı önemlidir - aracının yalnızca dahili Docker köprüsünü değil, LAN ağınızı görmesi gerekir. Kapsayıcının her yeniden başlatılmasında aracının güncel sürümü indirilir.

macOS ve Windows

macOS için (10.15+, Intel ve Apple Silicon):

curl -fsSL https://epulz.io/install-agent-macos.sh -o install-agent-macos.sh
sudo bash install-agent-macos.sh epulzio_TOKENINIZ

Windows için (10+ / Server 2016+, yönetici olarak PowerShell):

Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process -Force
$env:EPULZIO_AGENT_TOKEN="epulzio_TOKENINIZ"; iwr -useb https://epulz.io/install-agent.ps1 | iex

Sorun giderme

Kurulum aracı "Missing agent token" bildiriyor

Komutta token eksik. Sonunda token ile çalıştırın: ... | sudo bash -s epulzio_TOKENINIZ.

Kurulum aracı "must run as root" bildiriyor

Onu sudo ile çalıştırın; root yalnızca kurulum için gereklidir (systemd hizmeti, /opt dizinine yazma).

"Cannot reach epulz.io"

Cihazın giden HTTPS bağlantısı yok. curl https://epulz.io/health ile elle test edin. Başarısız olursa güvenlik duvarını, DNS'i ve NAT'ı kontrol edin.

"Python 3.8+ required"

Çok eski bir sistem. Dağıtımı güncelleyin veya daha yeni bir Python kurun (Debian'da örneğin backports'tan apt install python3.9).

"Neither systemd nor OpenRC detected"

Desteklenen bir init sistemi olmayan sistem. Yukarıdaki Docker varyantını kullanın.

Aracı 2 dakika sonra bile panoda çevrimdışı kalıyor

Logları inceleyin: sudo journalctl -u epulzio-agent -n 50.
En sık görülen nedenler: yanlış yapıştırılmış token (epulzio_ önekiyle birlikte tamamının kopyalandığını kontrol edin), güvenlik duvarında engellenen HTTPS veya yanlış sistem saati (date komutuyla kontrol edin - SSL sertifikası doğrulaması doğru saati gerektirir).

Aracının güncellenmesi

Aynı kurulum komutunu aynı token ile tekrar çalıştırın. Kurulum aracı /opt/epulzio-agent/ dizinindeki dosyaların üzerine yazar ve hizmeti yeniden başlatır, token geçerli kalır.

Kaldırma

sudo systemctl stop epulzio-agent
sudo systemctl disable epulzio-agent
sudo rm -rf /opt/epulzio-agent /etc/systemd/system/epulzio-agent.service
sudo systemctl daemon-reload

Panoda ayrıca aracıyı token'ini geçersiz kılmak için Revoked olarak işaretleyin.

Sonraki adım

İlk LAN monitörünüzü oluşturma (ping, TCP, HTTP).

İlk LAN monitörü