Αν διαχειρίζεστε υπηρεσίες στον δικό σας server — είτε πρόκειται για Nextcloud, Audiobookshelf, Plex, Proxmox ή οτιδήποτε άλλο — γνωρίζετε πόσο σημαντικό είναι να μαθαίνετε αμέσως όταν κάτι πάει στραβά. Η αναμονή να ανακαλύψετε τυχαία ότι μια υπηρεσία «έπεσε» δεν είναι διαχείριση — είναι τύχη.
Σε αυτό το άρθρο θα δούμε πώς να συνδέσουμε το Uptime Kuma v2 με το Nextcloud Talk, ώστε κάθε φορά που μια υπηρεσία αποτυγχάνει ή ανακάμπτει, να λαμβάνετε αυτόματη ειδοποίηση απευθείας σε μια συνομιλία του Talk. Όλα αυτά χωρίς εξωτερικές υπηρεσίες, χωρίς συνδρομές, 100% open source.
🐻 Τι είναι το Uptime Kuma;
Το Uptime Kuma είναι ένα ελεύθερο, ανοιχτού κώδικα εργαλείο παρακολούθησης υπηρεσιών (monitoring), εμπνευσμένο από υπηρεσίες όπως το UptimeRobot. Διαθέτει φιλικό web interface μέσω του οποίου μπορείτε να παρακολουθείτε HTTP endpoints, TCP ports, DNS, υπηρεσίες Docker, ping και πολλά ακόμα. Το Uptime Kuma v2 — που κυκλοφόρησε το 2025 — έφερε σημαντικές βελτιώσεις στη βάση δεδομένων, στα notifications και, μεταξύ άλλων, ενσωματωμένη υποστήριξη για Nextcloud Talk ως πάροχο ειδοποιήσεων. Τρέχει εύκολα μέσω Docker και αποτελεί την ιδανική επιλογή για αυτόνομες εγκαταστάσεις.
Πώς λειτουργεί η ενσωμάτωση
Η επικοινωνία μεταξύ Uptime Kuma και Nextcloud Talk γίνεται μέσω ενός Talk Bot: το Uptime Kuma στέλνει HTTP αιτήματα υπογεγραμμένα με ένα shared secret απευθείας στο Talk API, και το bot δημοσιεύει το μήνυμα στην επιλεγμένη συνομιλία. Δεν απαιτείται κανένας ενδιάμεσος server ή webhook service.
│
│ HTTP αίτημα (υπογεγραμμένο με HMAC-SHA256)
▼
Nextcloud Talk Bot API
│
▼
Talk conversation (π.χ. infra-alerts)
Τα μηνύματα που λαμβάνετε έχουν αυτή τη μορφή:
Προαπαιτούμενα
Πριν ξεκινήσουμε, βεβαιωθείτε ότι έχετε:
- Nextcloud 32.x εγκατεστημένο μέσω Nextcloud AIO (All-in-One Docker)
- Την εφαρμογή Nextcloud Talk εγκατεστημένη και ενεργοποιημένη
- Uptime Kuma v2 σε λειτουργία (π.χ. μέσω Docker)
- Διαχειριστική πρόσβαση στο Nextcloud (admin account)
- Πρόσβαση σε τερματικό SSH στον server σας
1 Δημιουργία συνομιλίας στο Nextcloud Talk
Το πρώτο βήμα είναι να δημιουργήσουμε μια αποκλειστική συνομιλία (conversation / room) στο Talk, μέσα στην οποία θα αποστέλλονται οι ειδοποιήσεις monitoring. Συνιστούμε να μην χρησιμοποιείτε υπάρχουσα ομαδική συνομιλία, για να κρατάτε τις ειδοποιήσεις οργανωμένες.
- Συνδεθείτε στη διεπαφή web του Nextcloud.
- Ανοίξτε την εφαρμογή Talk.
- Κάντε κλικ στο «Νέα συνομιλία» (New conversation).
- Δώστε ένα περιγραφικό όνομα, π.χ.
infra-alertsήmonitoring. - Δημιουργήστε τη συνομιλία.
2 Εύρεση του Conversation Token
Κάθε συνομιλία στο Talk ταυτοποιείται με ένα μοναδικό token που εμφανίζεται στη διεύθυνση URL της συνομιλίας. Αυτό το token θα το χρειαστούμε αργότερα για να «πούμε» στο Uptime Kuma πού να στέλνει τις ειδοποιήσεις.
Αφού ανοίξετε τη νέα συνομιλία, κοιτάξτε τη διεύθυνση URL στον browser σας. Θα μοιάζει κάπως έτσι:
Το τμήμα μετά το /call/ είναι το Conversation Token — στο παράδειγμά μας το abcd1234. Αντιγράψτε το και κρατήστε το.
3 Δημιουργία του Talk Bot
Τώρα πρέπει να δημιουργήσουμε το bot που θα στέλνει μηνύματα στη συνομιλία. Αυτό γίνεται αποκλειστικά μέσω γραμμής εντολών, μέσα στο Docker container του Nextcloud AIO.
Το Nextcloud Talk προσφέρει δύο εντολές για τη δημιουργία bot:
talk:bot:create— δημιουργεί bot με αυτόματα παραγόμενο secret, με τη δυνατότηταresponseμόνο (το bot μπορεί να στέλνει μηνύματα στο chat).talk:bot:install— πιο προχωρημένη εντολή που απαιτεί και webhook URL, για bots που θέλουν επίσης να λαμβάνουν μηνύματα.
Για το Uptime Kuma, αρκεί η talk:bot:create, γιατί το bot μόνο αποστέλλει ειδοποιήσεις — δεν χρειάζεται να λαμβάνει ή να απαντά σε μηνύματα. Εκτελέστε την παρακάτω εντολή:
php occ talk:bot:create "Uptime Kuma Bot"
Μπορείτε επίσης να ορίσετε εσείς το secret (πρέπει να είναι μεταξύ 40 και 128 χαρακτήρων) χρησιμοποιώντας την παράμετρο --secret:
php occ talk:bot:create "Uptime Kuma Bot" --secret YOUR_SECRET_HERE
Αν δεν ορίσετε secret, το Nextcloud θα δημιουργήσει αυτόματα ένα τυχαίο string 64 χαρακτήρων. Το αποτέλεσμα θα μοιάζει κάπως έτσι:
Bot ID: 16
Secret: 3cfa8b8c5e4e1f7b7d2c2a0c0a9c0e4f7c8a3b9e2d1c6f5a4b3c2d1e0f9a8b7
4 Προσθήκη του Bot στη συνομιλία
Το bot δημιουργήθηκε στο σύστημα, αλλά δεν έχει ακόμα πρόσβαση σε καμία συνομιλία. Πρέπει να το «συνδέσουμε» με τη συνομιλία που δημιουργήσαμε. Αυτό γίνεται με την εντολή talk:bot:setup, η οποία δέχεται το Bot ID και το Conversation Token:
php occ talk:bot:setup 16 abcd1234
Αντικαταστήστε 16 με το πραγματικό Bot ID σας και abcd1234 με το Conversation Token της συνομιλίας σας. Αν η εντολή εκτελεστεί σωστά, θα δείτε:
Το bot είναι τώρα μέλος της συνομιλίας και έχει δικαίωμα αποστολής μηνυμάτων.
5 Επαλήθευση της ρύθμισης του Bot
Για να επιβεβαιώσουμε ότι το bot εγκαταστάθηκε σωστά, μπορούμε να εκτελέσουμε την εντολή talk:bot:list που εμφανίζει όλα τα bots του συστήματος:
php occ talk:bot:list
Παράδειγμα εξόδου:
16 | Uptime Kuma Bot | response
Η στήλη features δείχνει response, που σημαίνει ότι το bot μπορεί να δημοσιεύει μηνύματα στις συνομιλίες — ακριβώς αυτό που χρειαζόμαστε για το Uptime Kuma.
Μπορείτε επίσης να φιλτράρετε τη λίστα για μια συγκεκριμένη συνομιλία περνώντας το token ως παράμετρο: php occ talk:bot:list abcd1234. Αυτό είναι χρήσιμο αν έχετε πολλά bots και θέλετε να δείτε ποια είναι ενεργά σε συγκεκριμένη συνομιλία.
6 Ρύθμιση notification στο Uptime Kuma
Ανοίξτε τη web διεπαφή του Uptime Kuma και μεταβείτε στις ρυθμίσεις ειδοποιήσεων:
Στη λίστα τύπων notification, επιλέξτε «Nextcloud Talk». Θα εμφανιστεί φόρμα με τα εξής πεδία:
| Πεδίο | Τιμή | Σχόλιο |
|---|---|---|
| Friendly Name | Nextcloud Talk Alerts | Όνομα ειδοποίησης (εσωτερικό στο Uptime Kuma) |
| Nextcloud Host | https://cloud.example.com | Η διεύθυνση του Nextcloud σας (χωρίς trailing slash) |
| Conversation Token | abcd1234 | Το token από το Βήμα 2 |
| Bot Secret | 3cfa8b8c5e4e1f7b... | Το secret από το Βήμα 3 |
Αποθηκεύστε τη ρύθμιση κάνοντας κλικ στο «Save».
7 Δοκιμή της ειδοποίησης
Κάντε κλικ στο κουμπί «Test» δίπλα στη νέα ειδοποίηση. Αν όλα έχουν ρυθμιστεί σωστά, σε λίγα δευτερόλεπτα θα εμφανιστεί ένα δοκιμαστικό μήνυμα στη συνομιλία του Talk:
Αν δεν εμφανιστεί μήνυμα, ελέγξτε:
- Ότι το Bot Secret που πληκτρολογήσατε είναι ακριβώς το ίδιο με αυτό που παράχθηκε (χωρίς κενά).
- Ότι το Conversation Token αντιστοιχεί στη σωστή συνομιλία.
- Ότι η διεύθυνση Nextcloud Host είναι προσβάσιμη από τον server του Uptime Kuma (DNS, firewall, κ.λπ.).
- Ότι εκτελέσατε το
talk:bot:setupμε το σωστό token.
8 Ανάθεση της ειδοποίησης σε monitors
Η ειδοποίηση δεν ενεργοποιείται αυτόματα για όλα τα monitors. Πρέπει να την αναθέσετε ξεχωριστά σε κάθε monitor που θέλετε να παρακολουθείτε:
- Ανοίξτε ένα monitor στο Uptime Kuma.
- Κάντε κλικ στο «Edit».
- Κυλήστε κάτω στην ενότητα «Notifications».
- Επιλέξτε «Nextcloud Talk Alerts» (ή το όνομα που δώσατε).
- Αποθηκεύστε τις αλλαγές.
Από εδώ και πέρα, κάθε φορά που η κατάσταση αυτού του monitor αλλάζει (Down ↔ Up), το Uptime Kuma θα στέλνει αυτόματα ειδοποίηση στο Talk.
💡 Συμβουλές για καλύτερες ειδοποιήσεις
Η ποιότητα μιας ειδοποίησης εξαρτάται σε μεγάλο βαθμό από το όνομα που δίνετε στο monitor. Αντί για γενικά ονόματα όπως «Server 1» ή «HTTP Check», χρησιμοποιήστε περιγραφικά ονόματα που σας λένε αμέσως ποια υπηρεσία επηρεάζεται. Χρήση emoji βοηθά στην οπτική γρήγορη αναγνώριση:
Με αυτά τα ονόματα, οι ειδοποιήσεις στο Talk θα εμφανίζονται έτσι:
Είναι αμέσως κατανοητό ποια υπηρεσία έχει πρόβλημα, χωρίς να χρειαστεί να ανοίξετε το dashboard του Uptime Kuma.
🔧 Χρήσιμες εντολές διαχείρισης
Αν χρειαστεί να διαχειριστείτε τα bots σας στο μέλλον, οι παρακάτω εντολές θα σας φανούν χρήσιμες:
php occ talk:bot:list
# Λίστα bots σε συγκεκριμένη συνομιλία
php occ talk:bot:list abcd1234
# Αφαίρεση bot από συνομιλία (χωρίς απεγκατάσταση)
php occ talk:bot:remove 16 abcd1234
# Πλήρης απεγκατάσταση bot από το σύστημα
php occ talk:bot:uninstall 16
Θυμηθείτε να προσθέτετε πάντα το prefix sudo docker exec -it nextcloud-aio-nextcloud πριν από κάθε php occ ... εντολή όταν χρησιμοποιείτε Nextcloud AIO.
Συμπέρασμα
Η ενσωμάτωση Uptime Kuma v2 με Nextcloud Talk είναι μια 100% open source, self-hosted λύση που σας επιτρέπει να λαμβάνετε ειδοποιήσεις monitoring απευθείας στο chat σας — χωρίς εξωτερικές υπηρεσίες, χωρίς κόστος.
Με λίγες εντολές OCC και μια σύντομη ρύθμιση στο Uptime Kuma, έχετε ένα πλήρες σύστημα ειδοποιήσεων που σας ενημερώνει αμέσως για κάθε αλλαγή κατάστασης στις υπηρεσίες σας.
0 Σχόλια