Skip to main content

Keila Önálló Hosztolása: Konfiguráció

Amikor önállóan hosztolod a Keilát, az alkalmazás legtöbb aspektusát környezeti változók segítségével konfigurálhatod.

Adatbázis

Konfiguráld a Keila által használt PostgreSQL adatbázist:

Változó Kötelező Alapértelmezett Leírás
DB_URL igen - URL, ami a postgres://felhasznalo:jelszo@hoszt/adatbazis sémát követi
DB_ENABLE_SSL nem hamis Használjon SSL/TLS-t az adatbázis kapcsolathoz
DB_VERIFY_SSL_HOST nem igaz SSL hosztnév ellenőrzésének engedélyezése (tiltsd le, ha közvetlenül IP-címhez kapcsolódsz)
DB_CA_CERT nem - SSL tanúsítvány (PEM) az adatbázishoz való kapcsolódáshoz

Gyökér Felhasználó

Amikor először indítod el a Keilát, létrejön egy gyökér felhasználó. Ha másképp nem rendelkezel, egy véletlenszerű jelszóval rendelkező felhasználó jön létre, amelyet a stdouton ír ki.

Változó Kötelező Alapértelmezett Leírás
KEILA_USER root@localhost A gyökér felhasználó e-mail címe
KEILA_PASSWORD véletlenszerű A gyökér felhasználó jelszava

URL

Konfiguráld a Keila által generált nyilvánosan látható URL-eket a következő változókkal:

Változó Kötelező Alapértelmezett Leírás
URL_HOST igen - A Keila példányod domainje
URL_PATH / A Keila példányod útvonala
URL_SCHEMA http http vagy https. A Keila példányod URL sémája
URL_PORT 443, ha az URL_SCHEMA https
különben a PORT értéke
A Keila példányod portja

Telepítés

Változó Kötelező Alapértelmezett Leírás
PORT 4000 Port, amelyen a Keila hallgatni fog
SECRET_KEY_BASE igen - Erős titok, legalább 64 karakter hosszú. Generálható a head -c 48 /dev/urandom | base64 parancs használatával
HASHID_SALT SECRET_KEY_BASE-ből származtatva Só a Hashid-ok létrehozásához. További információk
DISABLE_REGISTRATION false A felhasználói regisztráció letiltása a változó true értékre állításával
DISABLE_PRECEDENCE_HEADER false A Precedence: Bulk fejléc letiltása a változó true értékre állításával
USER_CONTENT_DIR ./uploads Elérési út egy könyvtárhoz, ahol a felhasználói feltöltések tárolódnak. Konténerek használata esetén ez az útvonal egy kötet elérési útjára kell mutasson, hogy a feltöltések megmaradjanak.
USER_CONTENT_BASE_URL - Az alap URL, ahol a USER_CONTENT_DIR-ben tárolt fájlok a weben elérhetőek. Ajánlott egy külön szerver (pl. Nginx vagy Apache) beállítása a felhasználói tartalom kiszolgálására. Ha nincs beállítva, a Keila közvetlenül szolgálja ki a felhasználói tartalmi fájlokat.

Rendszer e-mail küldő

A Keila-nak képesnek kell lennie rendszer e-mailek küldésére, pl. regisztrációhoz és jelszó visszaállításhoz. Egy SMTP küldő konfigurálása erre a célra a következő változókkal:

Változó Kötelező Alapértelmezett Leírás
MAILER_TYPE smtp Jelenleg csak az smtp támogatott
MAILER_SMTP_HOST igen - Az SMTP szerver hosztneve
MAILER_SMTP_PORT 587 Az SMTP szerver portja
MAILER_SMTP_USER igen - Felhasználónév az SMTP szerveren
MAILER_SMTP_PASSWORD igen - Jelszó az SMTP szerveren
MAILER_SMTP_FROM_EMAIL MAILER_SMTP_USER Feladó e-mail címe
MAILER_ENABLE_SSL false SSL/TLS engedélyezése true értékre állítva
MAILER_ENABLE_STARTTLS false STARTTLS engedélyezése true értékre állítva

Captcha

A Keila hCaptcha vagy Friendly Captcha használatával védi a feliratkozási űrlapokat. A captcha szolgáltató konfigurálása a következő változókkal:

Változó Kötelező Alapértelmezett Leírás
CAPTCHA_PROVIDER hcaptcha Captcha szolgáltató, hcaptcha vagy friendly_captcha közül választható
CAPTCHA_SITE_KEY - Captcha szolgáltató oldal kulcsa
CAPTCHA_SECRET_KEY - Captcha szolgáltató titkos kulcsa
CAPTCHA_URL változó Captcha szolgáltató ellenőrző URL-je, alapértelmezett érték https://hcaptcha.com/siteverify a hcaptcha esetén és https://api.friendlycaptcha.com/api/v1/siteverify a friendly_captcha esetén