Przejdź do treści

Samodzielny hosting DueReason: co uruchamiasz i za co odpowiadasz

Co obejmuje samodzielny hosting DueReason: jeden Postgres, gotowy obraz z GHCR, Docker Compose, kopie zapasowe i aktualizacje po Twojej stronie.

Aktualizacja · 7 min czytania

W skrócie

  • Samodzielny hosting działa na jednej bazie Postgres i jednym gotowym obrazie pobieranym z GitHub Container Registry, z którego pochodzą web, worker i migrator - dzięki temu nie mogą się rozjechać.
  • Pobierz plik compose, szablon env i skrypt quickstart z tej strony, uruchom skrypt quickstart, a potem docker compose pull && docker compose up -d - bez klonowania repozytorium, bez budowania.
  • Gdy już działa, jest Twój: Ty robisz kopie zapasowe, Ty aktualizujesz i Ty utrzymujesz go online. To ścieżka w fazie beta, bez SLA i bez kanału aktualizacji.
  • Przed pierwszą rejestracją ustaw właściwy adres https, bo warstwa uwierzytelniania podpisuje nim ciasteczka i linki, a zmiana go później wylogowuje wszystkich.

Samodzielny hosting DueReason oznacza uruchomienie jednej bazy Postgres i jednego obrazu aplikacji, który Docker Compose rozdziela na trzy role: aplikację webową, worker w tle i jednorazowy migrator. To ścieżka w fazie beta, bez SLA: nie ma kanału aktualizacji ani umowy wsparcia, a po uruchomieniu aktualizacje, kopie zapasowe i dostępność są po Twojej stronie.

Co uruchamiasz

Wszystko pochodzi z jednego obrazu pobieranego z GitHub Container Registry, więc aplikacja webowa, worker i migrator bazy nigdy się od siebie nie rozjadą. Usługa migrator uruchamia migracje bazy i kończy działanie; web i worker czekają, aż się powiedzie. docker compose pull && docker compose up -d to domyślna ścieżka - bez etapu budowania, bez czekania przy pierwszym uruchomieniu. Postgres działa we własnym kontenerze z nazwanym wolumenem, więc dane przetrwają restarty i przebudowy kontenerów.

Wymagania

  • Docker Engine z wtyczką Compose (Compose w wersji 2).
  • Około 2 GB wolnej pamięci RAM dla Postgresa, web i workera razem.
  • Jeden wolny port dla aplikacji webowej (domyślnie 3000, konfigurowalny przez WEB_PORT).
  • openssl, używany do wygenerowania sekretów przy pierwszym tworzeniu pliku środowiskowego.
  • curl, używany do pobrania pliku compose, szablonu env i skryptu quickstart poniżej.

Jak to ustawiasz

Pobierz cztery pliki self-host z tej strony i uruchom skrypt quickstart, który zapisze .env ze świeżo wygenerowanymi sekretami, a potem pobierz i uruchom stos:

``bash mkdir duereason && cd duereason curl -fsSL https://duereason.com/self-host/docker-compose.yml -o docker-compose.yml curl -fsSL https://duereason.com/self-host/env.example -o .env.example curl -fsSL https://duereason.com/self-host/quickstart.sh -o quickstart.sh curl -fsSL https://duereason.com/self-host/health-check.sh -o health-check.sh chmod +x quickstart.sh health-check.sh ./quickstart.sh docker compose pull docker compose up -d ./health-check.sh # sprawdza liveness, readiness, Postgres i wersję migracji za jednym razem ``

docker compose pull pobiera ghcr.io/override-tech/duereason:latest (web, worker i migrator pochodzą z tego samego obrazu). Ten pakiet nie jest jeszcze publiczny, więc klienci self-host dostają dostęp do pobierania na żądanie przez formularz kontaktowy. Zamiast latest możesz przypiąć konkretną wydaną wersję przez DUEREASON_TAG=x.y.z w .env albo w linii poleceń.

Jeśli stawiasz DueReason za własnym serwerem proxy kończącym TLS (Caddy, Traefik, nginx lub podobnym), ustaw BETTER_AUTH_URL - i SITE_URL, jeśli jest inny - na swój prawdziwy adres https:// przed pierwszą rejestracją. Warstwa uwierzytelniania podpisuje tym adresem ciasteczka i linki, więc zmiana go później wylogowuje wszystkich i unieważnia oczekujące linki zaproszeń czy resetu hasła. Trzymaj usługę web dostępną tylko na 127.0.0.1 i niech to proxy będzie jedyną rzeczą z publicznym portem.

Pierwsze uruchomienie

Pierwsze konto założone pod /sign-up staje się właścicielem tej organizacji. Domyślnie dostarczanie poczty jest ustawione na outbox: e-maile z potwierdzeniem, resetem hasła i zaproszeniami trafiają do tabeli w bazie zamiast gdziekolwiek zostać wysłane, bo plik compose nie zawiera żadnego serwera pocztowego. To wystarcza, by potwierdzić własne konto i poznać konsolę; do czegokolwiek poza testami skonfiguruj Resend, by poczta faktycznie wychodziła. Po zalogowaniu tworzysz organizację z poziomu konsoli i dodajesz współpracowników w jej ustawieniach Członkowie.

Elementy opcjonalne

ZmiennaCo kontroluje
WEB_PORTPort, na którym nasłuchuje usługa web (domyślnie 3000).
DUEREASON_TAGPobiera konkretną wydaną wersję zamiast latest.
BETTER_AUTH_URL / SITE_URLTwój publiczny adres https; ustaw przed pierwszą rejestracją.
EMAIL_DELIVERYoutbox (domyślnie, zapis do bazy) albo resend dla prawdziwej poczty.
EVIDENCE_STOREpostgres (domyślnie, bez dodatkowej usługi) albo s3 z odpowiednimi zmiennymi S3_* dla zewnętrznego bucketu, np. MinIO, Backblaze B2 lub AWS.
WEBHOOK_ALLOWED_PRIVATE_HOSTSLista (po przecinku) dokładnych nazw hostów/adresów IP, pod które webhook może wskazywać mimo że są w Twojej sieci prywatnej (wewnętrzny n8n albo lokalny przekaźnik Zapier/Make). Domyślnie puste - odrzuca każdy prywatny cel tak samo jak w wersji hostowanej.

Rozliczenia Stripe, weryfikacja botów Turnstile, powiadomienia push VAPID i skanowanie ClamAV są opcjonalne i pozostają puste, dopóki ich nie skonfigurujesz.

Punkty końcowe webhooków zwykle muszą wskazywać na publiczny adres: ta kontrola powstrzymuje przejęte lub złośliwe konto przed wykorzystaniem Twojego serwera do dotarcia do innych hostów w Twojej sieci (SSRF). WEBHOOK_ALLOWED_PRIVATE_HOSTS rozluźnia tę kontrolę, dokładnie host po hoście, byś mógł wysyłać webhooki do automatyzacji działającej w tej samej sieci prywatnej - wpisuj tylko hosty, nad którymi masz kontrolę, bo każdy wpis to wyjątek w tym zabezpieczeniu.

Kopia zapasowa

Wszystko żyje w wolumenie własnej usługi Postgres. Logiczny zrzut narzędziem pg_dump obejmuje całą bazę i da się go przywrócić do świeżego wolumenu w ten sam sposób. Plik compose nie zawiera automatycznego harmonogramu kopii zapasowych, więc podłączenie tego zrzutu do własnego crona albo narzędzia do backupów jest po Twojej stronie.

Aktualizacja

Aktualizacja oznacza pobranie nowszego obrazu i odtworzenie kontenerów:

``bash docker compose pull docker compose up -d # odtwarza web/worker/migrator na nowym obrazie; migrator uruchamia się najpierw ``

Migrator uruchamia się przy każdym starcie; jeśli zawiedzie, web i worker pozostają wyłączone zamiast działać na niedokończonym schemacie, więc docker compose logs migrator to pierwsze miejsce do sprawdzenia, gdy aktualizacja nie wraca czysto do działania.

Rozwiązywanie problemów

Uruchom najpierw ./health-check.sh (w deploy/self-host/, albo ten pobrany powyżej): sprawdza liveness, własny widok Postgresa z perspektywy aplikacji web, dostępność Postgresa niezależnie od aplikacji oraz liczbę zastosowanych migracji względem tych w obrazie - za jednym razem, a jego wynik można bezpiecznie wkleić do zgłoszenia wsparcia. Poza tym: kontener, który kończy działanie od razu, zgłaszając nieprawidłowe pole środowiskowe, oznacza brakującą lub błędną zmienną - sprawdź ją względem opisu tego pola w szablonie .env. Jeśli usługa web nigdy nie zgłasza stanu zdrowego, sprawdź najpierw status migratora - web i worker na niego czekają. Utknięcie na ekranie potwierdzenia adresu e-mail niemal zawsze oznacza, że nadal działasz na domyślnym dostarczaniu outbox: uruchom docker compose exec web node dist/print-outbox.mjs ty@example.com, żeby wypisać najnowsze wiadomości outbox dla tego adresu razem z linkiem potwierdzającym/zapraszającym/resetującym z każdej z nich, albo przełącz się na Resend, żeby wysyłać prawdziwe e-maile.

Za co odpowiadasz

Samodzielny hosting wymienia zarządzane aktualizacje i wsparcie produktu w chmurze na pełną kontrolę: Ty decydujesz, kiedy aktualizować, Ty prowadzisz kopie zapasowe i Ty odpowiadasz za dostępność usługi. Ta ścieżka nie ma SLA ani automatycznego kanału aktualizacji - każda aktualizacja to świadome docker compose pull && docker compose up -d, które sam uruchamiasz.

Licencjonowanie

DueReason jest dostępny jako source-available na licencji Elastic License 2.0: możesz go uruchamiać, czytać i modyfikować, ale nie możesz odsprzedawać go innym jako usługi hostowanej lub zarządzanej ani przenosić, wyłączać czy omijać mechanizmu klucza licencyjnego. Samodzielny hosting jest dziś darmowy dla jednej organizacji z maksymalnie pięcioma członkami, ze wszystkimi podstawowymi funkcjami; roczny klucz licencyjny znosi te limity - podpisany Ed25519 i weryfikowany w całości offline, bez łączenia się z serwerem - i zaczyna działać od razu po wklejeniu go w Ustawienia > Licencja. Pytania o self-hosting lub licencję komercyjną: napisz do nas.

Pytania

Czy jest opublikowany obraz Dockera, który mogę po prostu pobrać?
Jeszcze nie publicznie. Pakiet ghcr.io/override-tech/duereason nie jest publiczny, więc klienci self-host dostają dostęp do pobierania na żądanie przez /contact zamiast zwykłego docker compose pull. Plik docker-compose.yml, szablon env, skrypt quickstart i skrypt health-check są już publiczne, więc możesz je pobrać i przejrzeć z tej strony, zanim poprosisz o dostęp.
Czy mogę użyć własnego bucketu S3?
Tak. Przechowywanie dowodów domyślnie korzysta z Postgresa, co nie wymaga dodatkowej usługi, ale ustawienie EVIDENCE_STORE na s3 i uzupełnienie odpowiednich zmiennych S3 kieruje je do MinIO, Backblaze B2, AWS lub innego bucketu zgodnego z S3.
Kto zajmuje się aktualizacjami, gdy już działa?
Ty. Samodzielny hosting nie ma automatycznego kanału aktualizacji; aktualizacja oznacza uruchomienie docker compose pull && docker compose up -d, a Ty decydujesz, kiedy to robisz.
Czy poczta działa od razu po uruchomieniu?
Nie prawdziwa poczta. Domyślne dostarczanie outbox zapisuje e-maile z potwierdzeniem, resetem i zaproszeniami do tabeli w bazie zamiast je wysyłać, co wystarcza na próbę; skonfigurowanie Resend włącza prawdziwe dostarczanie.

Wypróbuj samodzielny hosting DueReason

Pobierz plik compose, szablon env i skrypt quickstart z tego przewodnika, a potem poproś o dostęp do obrazu self-host i działaj w kilka minut - bez klonowania repozytorium.

Poproś o dostęp self-host

Źródła

Poradnik wyjaśnia przepisy tak, jak je rozumiemy; nie jest poradą prawną. Sprawdź tekst urzędowy i prawo krajowe, które może dodać obowiązki.

Zacznij z DueReason

Załóż bezpłatne konto, wypróbuj na żywo albo porozmawiaj z nami o swoim procesie.

Otrzymuj nowości o produkcie