Hiter začetek z Dockerjem
Z Docker Compose zaženite ločeno namestitev ReportHub na svojem strežniku. Izberite Community za javne prijave ali Safety / VZD za interne nevarnosti in korektivne ukrepe. Vsaka namestitev uporablja en modul.
Želite upravljano gostovanje? Pišite CELEONU za dogovor o namestitvi in obsegu upravljanja.
Že imate dostop do aplikacije? Začnite z uporabniškimi vodniki za Community in Safety / VZD.
1. Pripravite strežnik
Razdelek 1. Pripravite strežnikPotrebujete strežnik Linux z Docker Engine, dodatkom Docker Compose, curl in OpenSSL. Potrebujete tudi gostiteljsko ime, usmerjeno na strežnik, ter dostopna vhodna priključka 80 in 443 za Caddyjevo nastavitev HTTPS. Za vsako namestitev uporabite svojo mapo in gostiteljsko ime.
Ukazi so namenjeni novi namestitvi. Do izdelave skrbniškega računa omejite dostop do začetne nastavitve, na primer z začasnim pravilom požarnega zidu za svoj naslov IP.
mkdir reporthubcd reporthubcurl --fail --location \ --output docker-compose.yml \ https://reporthub.celeon.si/downloads/reporthub/docker-compose.ymlcurl --fail --location \ --output Caddyfile \ https://reporthub.celeon.si/downloads/reporthub/Caddyfile.txtcurl --fail --location \ --output .env \ https://reporthub.celeon.si/downloads/reporthub/env.exampledocker-compose.yml · Caddyfile · .env
Datoteke uporabljajo objavljeno sliko ghcr.io/cuaupro/reporthub; izvorni repozitorij in lokalna namestitev Node.js nista potrebna. Vključeni so Caddy, ReportHub in PostgreSQL/PostGIS. Javno je dostopen samo Caddy; aplikacija in podatkovna zbirka ostaneta v internem omrežju Compose.
2. Nastavite .env
Razdelek 2. Nastavite .envOdprite .env v urejevalniku besedila. Zamenjajte vzorčno gostiteljsko ime in e-pošto ter izpolnite obe prazni skrivnosti:
| Nastavitev | Kaj vpišete |
|---|---|
APP_HOST |
Gostiteljsko ime vaše namestitve, na primer reports.example.org, brez https:// in poti. DNS mora kazati na ta strežnik. |
CADDY_EMAIL |
E-poštni naslov, ki ga spremljate, za postopke s potrdili HTTPS. |
POSTGRES_PASSWORD |
Novo močno geslo podatkovne zbirke. |
ANALYTICS_HASH_SECRET |
Ločeno naključno skrivnost za psevdonimizacijo analitike aplikacije na podlagi privolitve. Med ponovnimi zagoni je ne spreminjajte. S tem ne omogočite analitike produktnega spletnega mesta. |
TZ |
Časovni pas IANA; predloga uporablja Europe/Ljubljana. |
REPORTHUB_TAG |
Oznako slike aplikacije. Predloga uporablja latest; za nadzorovano produkcijsko uvedbo izberite preverjeno oznako izdaje. |
Z naslednjim ukazom ustvarite vrednost, nato ga za drugo skrivnost zaženite še enkrat. Različna izpisa vnesite v .env:
openssl rand -hex 32Datoteko .env hranite zasebno in zunaj nadzora izvorne kode. V Linuxu omejite njene pravice:
chmod 600 .envPrivzeta shramba datotek je lokalna, v trajnem nosilcu Docker z javno in zasebno mapo. SMTP in shramba, združljiva s S3, sta neobvezna. Potrjevanje po e-pošti, vabila in e-poštna obvestila potrebujejo delujoč SMTP; pošiljanje je privzeto izključeno. V pregledu spremenljivk okolja so vse podprte nastavitve, primeri za pošto in S3 ter navodila za uveljavitev sprememb.
3. Zaženite ReportHub
Razdelek 3. Zaženite ReportHubV mapi s tremi prenesenimi datotekami zaženite:
docker compose config --quietdocker compose pulldocker compose up -ddocker compose psCompose ustvari trajne nosilce za podatkovno zbirko, datoteke in Caddy. Aplikacija ob zagonu izvede migracije. Počakajte, da so storitve zdrave, nato v brskalniku odprite https:// in svoje ime APP_HOST. Caddy samodejno pridobi potrdilo HTTPS, ko sta DNS in omrežni dostop ustrezno nastavljena.
Če zagon ne uspe, preglejte dnevnik aplikacije:
docker compose logs --tail 100 reporthubPreverite gostiteljsko ime, razpoložljivost priključkov, DNS in obvezne vrednosti .env. Ukaza docker compose down -v ne uporabljajte za odpravljanje težav: izbriše trajne nosilce in njihove podatke.
4. Začnite preizkus
Razdelek 4. Začnite preizkus- Ob prvem obisku izberite Community ali Safety / VZD.
- Ustvarite začetni skrbniški račun. Modul se shrani skupaj s tem računom in ga v tej namestitvi ni mogoče pozneje zamenjati.
- V razdelku Namestitev / licenca izberite Začni preizkus. 30-dnevni preizkus z vsemi funkcijami ne zahteva uvoza licenčne datoteke.
- Za napolnjeno testno okolje se vrnite v Namestitev / licenca (
/installation) in izberite Pripravi demo namestitev, preden vnesete lastne nastavitve ali prijave. Postopek zaključi nastavitve in ustvari izmišljene uporabnike, lokacije in prijave. Vaš skrbniški račun ostane ohranjen, pošiljanje e-pošte pa je izključeno. Demo računi uporabljajo geslo, prikazano v aplikaciji; dostop omejite na uporabnike preizkusa. - Namesto dema lahko zaključite nastavitve z lastnimi organizacijami, kategorijami, odgovornostmi in podatki o zasebnosti.
Preizkus začne teči ob začetku preizkusa, ne ob prenosu ali zagonu vsebnikov. Priprava dema samodejno začne še neuporabljen preizkus. Po poteku sta branje in izvoz ohranjena, oddaja in spremembe pa se ustavijo. Ustrezno komercialno licenco lahko uvozite med preizkusom ali po njem. Produkcijska uporaba zahteva komercialni dogovor ali pisno odobritev.
Nadaljujte s prvimi koraki v aplikaciji.
Ohranite nadzor nad namestitvijo
Razdelek Ohranite nadzor nad namestitvijoČe pogodba ne določa drugače, skrbite za varnost strežnika, posodobitve, nadzor, kopije podatkovne zbirke in datotek ter preverjanje obnovitve. Podatkovno zbirko in datoteke varnostno kopirajte skupaj; sama kopija podatkovne zbirke ne vsebuje fotografij, tlorisov ali dokazil.
Za začasno ustavitev, ki ohrani podatke:
docker compose stopIsto namestitev spet zaženete z docker compose up -d iz iste mape. Ohranite ime projekta Compose in .env; gesla že inicializirane podatkovne zbirke ne menjajte brez usklajene spremembe v podatkovni zbirki.