Mikä on Uptime Kuma?

Uptime Kuma on itse ylläpidettävä valvontatyökalu. Se tarkistaa säännöllisin väliajoin verkkosivustoja, TCP-portteja, DNS-tietueita, Docker-säilöjä ja muuta, lähettää ilmoituksen, kun jokin poistuu käytöstä, ja voi julkaista tilasivuja. Projekti tarjoaa virallisen imagen louislam/uptime-kuma, joka kuuntelee porttia 3001 ja säilyttää kaiken /app/data-kansiossa.

Työkalun kuvaus

Tämä työkalu luo Uptime Kumalle compose.yaml-tiedoston. Se aloittaa Uptime Kuma -repositoriossa olevasta tiedostosta ja lisää siihen tavallisesti tarvittavat asetukset: imagen version ja variantin, isäntäportin ja sidontaosoitteen, tietojen tallennuspaikan, Docker-socketin käyttöoikeuden Docker-isäntämonitoreita varten sekä tietokannan. Kun tietokantana käytetään omassa säilössään olevaa MariaDB:tä, työkalu lisää tiedostoon toisen palvelun ja kuntotarkistuksen, joten Uptime Kuma käynnistyy vasta, kun tietokanta on valmis. Asetukset, joille lomakkeessa ei ole omaa kenttää, voidaan lisätä ympäristömuuttujina. Kaikki luodaan selaimessa.

Ominaisuudet

  • 2-, 1- ja beta-imagetunnisteet sekä version 2 standard-, slim-, rootless- ja slim rootless -variantit
  • Isäntäportti ja sidontaosoite, kuten 127.0.0.1, käyttöön käänteisen proxyn takana
  • Isännän datakansio tai nimetty Docker-taltio, joka määritellään puolestasi
  • Valinnainen /var/run/docker.sock-käyttöoikeus Docker-isäntämonitoreita varten sekä varoitus siitä, mitä se mahdollistaa
  • SQLite, upotettu MariaDB, tiedostoon lisättävä MariaDB-säilö tai ulkoinen MariaDB-palvelin
  • Luotu tietokannan salasana, jossa $-merkit on suojattu niin, että Compose säilyttää ne
  • Asetukset iframeen upottamista, WebSocket-alkuperän tarkistusta ja Cloudflare Tunnel -tokenia varten
  • Mikä tahansa muu ympäristömuuttuja, tiedoston selittävät kommentit sekä lataus compose.yaml-tiedostona

Esimerkit

Oletusasetukset tuottavat saman tiedoston kuin Uptime Kuma -repositoriossa oleva tiedosto:

services:
  uptime-kuma:
    image: louislam/uptime-kuma:2
    ports:
      - "3001:3001"
    volumes:
      - ./data:/app/data
    restart: unless-stopped

MariaDB-säilön valitseminen tietokannaksi lisää mariadb-palvelun ja yhdistää Uptime Kuman siihen UPTIME_KUMA_DB_TYPE-, UPTIME_KUMA_DB_HOSTNAME- ja muiden UPTIME_KUMA_DB_*-muuttujien avulla.

Vinkkejä

  • Tallenna tulos tyhjään kansioon nimellä compose.yaml ja käynnistä se komennolla docker compose up -d. Avaa sitten http://localhost:3001
  • NFS:n kaltaisia tiedostojärjestelmiä ei tueta datakansiossa. Käytä paikallista kansiota tai Docker-taltiota
  • Slim-imaget eivät sisällä Chromiumia, jota selainmonitori tarvitsee, eivätkä upotettua MariaDB:tä
  • Rootless-imaget toimivat node-käyttäjänä, jonka UID on 1000, joten isännän datakansion on oltava tämän käyttäjän kirjoitettavissa
  • Uptime Kuma käyttää WebSocket-yhteyksiä. Kun se sijoitetaan käänteisen proxyn taakse, proxyn on välitettävä Upgrade- ja Connection-otsakkeet
  • Docker-socket antaa Uptime Kumalle täyden hallinnan isännän Dockerista. Liitä se vain, kun tarvitset Docker-isäntämonitoreita, äläkä altista Uptime Kumaa internetille
  • Versio 1 tukee vain SQLiteä, joten tietokantavaihtoehdot piilotetaan siinä
  • Salasanakenttien arvot päätyvät tiedostoon selväkielisinä. Pidä tiedosto yksityisenä tai siirrä salasana .env-tiedostoon ja viittaa siihen muodossa ${DB_PASSWORD}