Jak zainstalować certyfikat SSL na TrueNAS
W skrócie
W TrueNAS otwórz „Credentials” → „Certificates” → „Import”, wklej fullchain.pem w pole „Certificate” i privkey.pem w pole „Private Key”. Potem wybierz certyfikat w „System” → „General Settings” → „GUI SSL Certificate”.
Dla TrueNAS Community Edition 25.10 (dawniej TrueNAS SCALE). Certyfikat zadziała, gdy otwierasz panel TrueNAS pod adresem ze swojej domeny (np. nas.twojadomena.pl). Przy wejściu przez adres IP przeglądarka nadal pokaże ostrzeżenie.
Potrzebne pliki
fullchain.pem i privkey.pem. Ich zawartość wklejasz w formularz TrueNAS.
Wgrywaj certyfikat z trybu produkcyjnego. Certyfikat z trybu testowego służy tylko do sprawdzenia procesu: przeglądarki mu nie ufają, a część paneli w ogóle go nie przyjmie.
Zanim zaczniesz
- TrueNAS sam potrafi pobierać certyfikaty Let's Encrypt i odnawiać je automatycznie. Robi to tylko przez rekord DNS u kilku dostawców (Cloudflare, DigitalOcean, Amazon Route 53, OVHcloud) i potrzebuje do tego klucza API do Twojej domeny. Jeśli domenę masz u jednego z nich, wbudowana funkcja jest wygodniejsza, bo nie musisz pamiętać o odnowieniu. Nasz generator przydaje się, gdy domenę obsługuje inny dostawca DNS albo nie chcesz zapisywać w NAS-ie klucza API. Domenę potwierdź wtedy rekordem DNS: NAS nie musi być widoczny z internetu.
- Adres z certyfikatu (np. nas.twojadomena.pl) musi prowadzić do NAS-a. Najprościej dodać w strefie DNS domeny rekord A z adresem IP NAS-a w sieci lokalnej (np. 192.168.1.20) albo ustawić taki wpis w routerze.
Krok po kroku
- Zaloguj się do TrueNAS i otwórz „Credentials” → „Certificates”.
- W ramce „Certificates” kliknij „Import”.
- W polu „Name” wpisz nazwę certyfikatu, np. nas-twojadomena-pl. TrueNAS przyjmuje tu tylko litery, cyfry oraz znaki - i _, więc nie używaj kropek.
- Wklej zawartość plików w dwa pola (niżej, co gdzie). Pole „Add To Trusted Store” zostaw niezaznaczone. Pola „Passphrase” i „Confirm Passphrase” zostaw puste, bo klucz z generatora nie ma hasła. Kliknij „Import”.
- Otwórz „System” → „General Settings” i w ramce „GUI” kliknij „Settings”.
- W polu „GUI SSL Certificate” wybierz nowy certyfikat i kliknij „Save”. TrueNAS zapyta o ponowne uruchomienie usługi WWW: zaznacz „Confirm” i kliknij „Continue”. Panel na chwilę się rozłączy.
- Otwórz panel pod adresem ze swojej domeny, np. https://nas.twojadomena.pl.
Co wkleić w które pole
- Certificate: cała zawartość pliku fullchain.pem (certyfikat razem z certyfikatem pośrednim)
- Private Key: cała zawartość pliku privkey.pem
Jak skopiować zawartość pliku
- Windows: kliknij plik prawym przyciskiem myszy, wybierz „Otwórz za pomocą”, a potem „Notatnik”. Mac: kliknij plik z klawiszem Control, wybierz „Otwórz za pomocą”, a potem „TextEdit”.
- Zaznacz całą treść (Ctrl+A, na Macu Cmd+A) i skopiuj ją (Ctrl+C, na Macu Cmd+C).
- W panelu kliknij w pole i wklej (Ctrl+V, na Macu Cmd+V). Wklej całość razem z liniami BEGIN i END i niczego nie zmieniaj.
Sprawdzenie
Otwórz swoją stronę przez https:// i kliknij kłódkę (albo ikonę ustawień) obok adresu. Szczegóły certyfikatu powinny pokazać wystawcę Let's Encrypt i datę ważności zgodną z panelem. Jeśli przeglądarka nadal pokazuje stary certyfikat, odczekaj kilka minut i odśwież stronę.
Jeśli zamiast strony widzisz ostrzeżenie, kod błędu wyjaśniamy na stronie „Połączenie nie jest prywatne”. Jeśli strona otwiera się przez https, ale wygląda źle albo coś nie działa, zobacz mieszana zawartość. Na koniec włącz przekierowanie z http na https, żeby wszyscy trafiali na bezpieczną wersję.
Dobrze wiedzieć
- Jeśli TrueNAS odrzuci klucz, sprawdź, czy privkey.pem i fullchain.pem pochodzą z tego samego zamówienia. Jeśli tak, wygeneruj certyfikat jeszcze raz z kluczem RSA 2048 (krok 1 generatora, „Rodzaj klucza”).
- Certyfikatu wgranego z pliku TrueNAS nie odnawia sam. Przy odnowieniu wgrywasz nowy (niżej).
- W TrueNAS 25.04 zamiast przycisku „Import” jest „Add”. W kreatorze jako „Type” wybierz „Import Certificate”.
- TrueNAS CORE ma inne menu i według producenta jest już po końcu wsparcia, dlatego ta instrukcja go nie opisuje.
Przy odnowieniu
W zaimportowanym certyfikacie TrueNAS nie pozwala podmienić plików. Zaimportuj nowy certyfikat pod nową nazwą (np. z datą: nas-twojadomena-pl-2027-01), wybierz go w „GUI SSL Certificate” tak jak w krokach 5 i 6, a potem w „Credentials” → „Certificates” usuń stary przyciskiem „Delete” przy jego wierszu.
Panele hostingów co jakiś czas się zmieniają. Jeśli coś wygląda inaczej niż w opisie, napisz na kontakt@freessl.pl, a poprawimy instrukcję.