Dla administratorów
← Wszystkie tematy

Instalacja krok po kroku

Pełny przewodnik: pobranie i sprawdzenie paczki, ./draften install, HTTPS, licencja, poczta i zabezpieczenie serwera.

Całe postępowanie od pustego serwera do zabezpieczonej pracy: pobranie paczki, instalacja, HTTPS, pierwsze logowanie, ustawienia i zabezpieczenie serwera. Jakie wymagania musi spełniać serwer, opisuje strona Obsługiwane środowisko; z czego składa się instalacja, opisuje strona Instalacja na własnym serwerze.

Zanim zaczniesz

Przygotuj:

Krok 1: Przygotuj serwer

Zainstaluj Docker Engine z wtyczką compose. Na Ubuntu z oficjalnego repozytorium Dockera:

sudo apt-get update
sudo apt-get install -y ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

Na innych dystrybucjach postępuj według https://docs.docker.com/engine/install/. Pakiet docker.io z repozytoriów dystrybucji bywa stary i nie ma wtyczki compose.

Sprawdź wersje – Docker musi być w wersji 24 lub nowszej, a docker compose musi odpowiedzieć:

docker version --format '{{.Server.Version}}'
docker compose version

Krok 2: Pobierz paczkę

Paczkę pobiera się z download.draften.ai kluczem, który jest w pliku licencji. Te polecenia wyciągają klucz z licencji i wypisują dostępne wydania:

KEY=$(sed -n 's/.*"payload":"\([^"]*\)".*/\1/p' licence-<numer>.json | tr '_-' '/+' | awk '{ while (length($0) % 4) $0 = $0 "="; print }' | base64 -d | sed -n 's/.*"key": *"\([^"]*\)".*/\1/p')
curl -fsS -H "Authorization: Bearer $KEY" https://download.draften.ai/v1/latest.json | sed -n 's/.*"payload":"\([^"]*\)".*/\1/p' | tr '_-' '/+' | awk '{ while (length($0) % 4) $0 = $0 "="; print }' | base64 -d

Wynik pokazuje wydania z ostatnich sześciu miesięcy – przy każdym wersję, datę, informacje o wydaniu, rozmiar i sumę kontrolną sha256 – a pod latest najnowsze, które nie zostało wycofane. Pobierz tę wersję:

curl -fS -H "Authorization: Bearer $KEY" -o draften-<wersja>.tar https://download.draften.ai/v1/bundles/draften-<wersja>.tar

Paczka ma około 500 MB. Gdy brama odpowie błędem 403, licencja jest nieznana, unieważniona albo wygasła – komunikat powie dlaczego.

Serwer bez internetu: pobierz paczkę na innej maszynie tymi samymi poleceniami i przenieś ją na serwer (na przykład scp). Sumę kontrolną możemy ci w takim przypadku wysłać razem z paczką.

Krok 3: Sprawdź paczkę

Oblicz sumę kontrolną i porównaj ją z wartością sha256 tej wersji w wyniku z kroku 2:

sha256sum draften-<wersja>.tar

Jeśli sumy się różnią, nie instaluj paczki i skontaktuj się z nami. To jedyne ręczne sprawdzenie: każdą kolejną aktualizację instalacja sprawdza sama względem naszych kluczy.

Krok 4: Rozpakuj paczkę i uruchom instalator

Wybierz katalog, w którym będzie instalacja, rozpakuj do niego paczkę i uruchom instalator:

sudo mkdir /srv/draften
sudo tar -xf draften-<wersja>.tar -C /srv/draften
cd /srv/draften
sudo ./draften install

Instalator najpierw wczyta obrazy (minutę lub dwie) i sprawdzi podpis i zawartość paczki. Gdy sprawdzenie się nie powiedzie („this bundle does not check out”), paczka jest uszkodzona – pobierz ją ponownie.

Krok 5: Odpowiedz na pytania instalatora

Instalator pyta po angielsku:

PytanieCo wpisać
Where will people open draften (the full address)adres łącznie z https://, na przykład https://draften.firma.cz. Musi to być adres, którego ludzie naprawdę używają – na jego podstawie powstają też adresy powrotu przy logowaniu przez Microsoft i Google
The organisation's namenazwa twojej organizacji
Its short namekrótka nazwa: małe litery, cyfry i myślniki. Instalator zaproponuje ją na podstawie nazwy organizacji
The first administrator's e-maile-mail pierwszego administratora. Zostaje właścicielem organizacji i operatorem całej instalacji
Their namejego imię i nazwisko
Their languagecs, en, de, fr, es, it, pt albo pl (domyślnie en)
Run the updateryes albo no (domyślnie yes). Updater pozwala aktualizować, zmieniać liczbę procesów, wymieniać klucz szyfrowania i robić kopie zapasowe z interfejsu webowego. Ma dostęp do Dockera, co oznacza prawa roota na serwerze. Bez niego wszystko działa z wiersza poleceń
HTTPS certificate file (PEM)ścieżka do certyfikatu, jeśli HTTPS ma się kończyć bezpośrednio w draften; w przeciwnym razie zostaw puste
Its private key fileścieżka do klucza certyfikatu

Z certyfikatem adres musi zaczynać się od https://. Każdą odpowiedź można też podać od razu w poleceniu, więc instalację da się oskryptować; opcje wypisuje ./draften help:

sudo ./draften install --url https://draften.firma.cz --org "Firma sp. z o.o." \
  --admin-email jan@firma.cz --admin-name "Jan Novák" --locale en --updater yes

Krok 6: Co zrobi instalator

  1. Zapisze ustawienia i sekrety do pliku .env – czytelnego tylko dla właściciela. Hasła bazy danych, klucz szyfrowania MASTER_KEY i sekret sesji wygeneruje losowo i nigdzie ich nie wypisze.
  2. Utworzy foldery data/, backups/ oraz pierwszą organizację z administratorem.
  3. Uruchomi draften i sprawdzi, czy odpowiada.
  4. Na końcu wypisze adres i link do ustawienia hasła pierwszego administratora oraz przypomni o zapisaniu kopii .env.

Gdy pierwsze uruchomienie się nie powiedzie („the first start failed”), zajrzyj do docker compose ps i docker compose logs. Gdy instalator nie wypisze linku, znajdziesz go poleceniem docker compose logs worker | grep set-password – worker wypisuje go przy każdym starcie, dopóki hasło nie istnieje.

Od razu zapisz kopię .env poza serwerem – przynajmniej wartość MASTER_KEY. Tym kluczem są zaszyfrowane dostępy do skrzynek, klucze modeli i hasła do wysyłki poczty. Bez niego nikt ich nie odczyta, nawet z kopii zapasowej – a my go nie mamy.

Krok 7: Opublikuj draften przez HTTPS

Zależnie od tego, gdzie kończy się HTTPS, wybierz jeden wariant. Rekord DNS swojego adresu skieruj na serwer (albo na proxy).

HTTPS bezpośrednio w draften

Jeśli instalator dostał certyfikat, draften nasłuchuje na porcie 443 i z portu 80 przekierowuje na HTTPS. Wystarczy DNS i otwarte porty 80 i 443. Certyfikat można dodać także później, a tym samym poleceniem wymienisz go po odnowieniu bez utraty choćby jednego żądania:

sudo ./draften certificate cert.pem key.pem --url https://draften.firma.cz

O odnawianie certyfikatu (na przykład klientem ACME) dbasz samodzielnie; po każdym odnowieniu uruchom to polecenie.

Twoje reverse proxy

Bez certyfikatu draften nasłuchuje tylko na 127.0.0.1:8085. Proxy na tej samej maszynie przesyła żądania na ten adres i przekazuje nagłówki Host i X-Forwarded-Proto. Na przykład dla Caddy (certyfikat zdobędzie sam):

draften.firma.cz {
    reverse_proxy 127.0.0.1:8085
}

albo dla nginx:

server {
    listen 443 ssl;
    server_name draften.firma.cz;
    ssl_certificate     /etc/ssl/draften/fullchain.pem;
    ssl_certificate_key /etc/ssl/draften/privkey.pem;

    location / {
        proxy_pass http://127.0.0.1:8085;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-Proto https;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

Gdy proxy działa na innej maszynie, ustaw w .env WEB_BIND=0.0.0.0:8085, uruchom sudo docker compose up -d i udostępnij port 8085 tylko proxy (zobacz krok 13).

Cloudflare Tunnel

Nie potrzebuje żadnego otwartego portu. W Cloudflare Zero Trust utwórz tunel i skopiuj jego token. Do .env wpisz CLOUDFLARE_TUNNEL_TOKEN=<token>, do COMPOSE_PROFILES dodaj tunnel (na przykład COMPOSE_PROFILES=updater,tunnel) i uruchom:

sudo docker compose up -d

W Cloudflare dodaj potem przy tunelu publiczny adres (Public hostname) prowadzący na http://127.0.0.1:8085. WEB_BIND zostaw na 127.0.0.1:8085. Obraz cloudflared Docker pobierze z Docker Hub – nie ma go w paczce.

Krok 8: Ustaw hasło i zaloguj się

Otwórz link, który wypisał instalator, ustaw hasło – od razu się zalogujesz. Link działa raz i jest ważny 7 dni. Jak wygląda strona z ustawieniem hasła, pokazuje instrukcja Logowanie.

Nigdzie nie kopiuj ani nie przekazuj dalej tego linku – kto go ma, ten ustawi hasło administratora.

Krok 9: Prześlij licencję

W interfejsie otwórz Instalacja → Instalacja, na dole na karcie Licencja wybierz plik i prześlij go. Dopóki instalacja nie ma licencji, asystenci nie przetwarzają poczty i nie można utworzyć skrzynki ani asystenta. Z licencją updater sam pilnuje nowych wydań. Więcej w Licencji.

Krok 10: Ustaw domyślne klucze i wysyłkę poczty

Na tej samej stronie Instalacja:

Krok 11: Podłącz pocztę i ludzi

  1. Zdecyduj, jak asystent dostanie się do poczty, i przygotuj to w Microsoft albo Google: Microsoft 365, Google Workspace, inna skrzynka przez IMAP.
  2. Kto ma się logować kontem Microsoft lub Google, ustaw w Logowaniu członków.
  3. Dodaj i podłącz skrzynkę.
  4. Skonfiguruj asystenta kreatorem.
  5. Zaproś kolejne osoby – Osoby i role.

Krok 12: Sprawdź, czy wszystko działa

sudo ./draften status

wypisuje wersję, stan interfejsu webowego i workerów, stan HTTPS i kopii zapasowej. W interfejsie strona Utrzymanie pokazuje, czy workery się zgłaszają – zobacz Utrzymanie i przepustowość. Gdy coś nie działa, pomoże Rozwiązywanie problemów; plik dla naszego wsparcia utworzy sudo ./draften diagnose.

Krok 13: Zabezpiecz serwer

Kto ma dostęp do serwera, ma dostęp do wszystkiego: do poczty w wiadomościach, do .env z kluczem i do kopii zapasowych. Dlatego chroń serwer jak serwer pocztowy.

Firewall. Z zewnątrz przepuszczaj tylko to, co potrzebne:

Docker omija reguły UFW (i firewalld) dla portów, które publikuje. ufw deny 8085 nie zamknie portu, który Docker otworzył na 0.0.0.0. Dlatego zostaw WEB_BIND na 127.0.0.1:8085, gdzie się da; gdzie nie, ogranicz dostęp firewallem przed serwerem albo regułami w łańcuchu DOCKER-USER.

Połączenia wychodzące wystarczy zezwolić na adresy z Obsługiwanego środowiska.

SSH. Logowanie tylko kluczem (PasswordAuthentication no), bez bezpośredniego logowania roota (PermitRootLogin no), administratorzy z własnymi kontami i sudo.

Kto ma dostęp do Dockera. Członkostwo w grupie docker oznacza prawa roota. Dawaj je tylko administratorom serwera.

Aktualizacje systemu. Włącz automatyczne aktualizacje bezpieczeństwa (na Ubuntu unattended-upgrades) i aktualizuj Dockera razem z systemem. Aktualizacje draften zapewnia updater – zobacz Aktualizacja przez updater.

Updater. Ma dostęp do Dockera, czyli prawa roota. Jeśli go nie potrzebujesz, wyłącz go: w .env usuń updater z COMPOSE_PROFILES i w katalogu instalacji uruchom sudo docker compose rm -sf updater. Aktualizacje i kopie zapasowe robisz wtedy z wiersza poleceń.

Pliki instalacji. .env jest czytelny tylko dla właściciela, folder backups/ także – zostaw to tak. Nie udostępniaj katalogu instalacji.

Kopie zapasowe poza serwerem. draften codziennie robi kopię zapasową bazy danych do backups/ na tym samym dysku. Ustaw kopiowanie backups/ i .env w inne miejsce, w postaci zaszyfrowanej – zrzuty zawierają pocztę. Szczegóły: Kopia zapasowa i odtwarzanie.

Klucz szyfrowania. Gdy odejdzie ktoś, kto znał .env, wymień MASTER_KEY (sudo ./draften rotate-key albo w Instalacja → Instalacja) i nową kopię .env zapisz poza serwerem.

Dalej

Wersja tekstowa