VPS: Instalacja Standard Notes na Linuxie
Ten poradnik został stworzony z wykorzystaniem następujących produktów:
(Szczegóły mogą się różnić w zależności od produktów różnych dostawców, ale główne koncepcje pozostają takie same)
Wprowadzenie
Standard Notes to open-source’owa aplikacja do notatek, która chroni Twoje dane dzięki audytowanemu szyfrowaniu end-to-end. Tylko Ty masz kontrolę nad kluczami deszyfrującymi. Synchronizuje Twoje zaszyfrowane notatki i pliki bezproblemowo na nieograniczoną liczbę urządzeń, zapewnia dostęp offline i aktywnie chroni Twoje treści przed dostępem z zewnątrz.
Myślisz o samodzielnym hostowaniu tego serwisu? Przeprowadzimy Cię przez każdy krok instalacji i konfiguracji oraz podpowiemy, na co zwrócić uwagę.
Wymagania wstępne
Przed instalacją Standard Notes upewnij się, że Twoje środowisko hostingowe spełnia poniższe wymagania, aby instalacja przebiegła gładko, a wydajność była optymalna.
| Sprzęt | Minimum | Rekomendacja ZAP-Hosting |
|---|---|---|
| CPU | 1 rdzeń vCPU | 4 rdzenie vCPU |
| RAM | 2 GB | 4 GB |
| Miejsce na dysku | 5 GB | 25 GB |
Oprogramowanie wymaga zainstalowania wszystkich niezbędnych zależności oraz działania na wspieranym systemie operacyjnym. Upewnij się, że Twój serwer spełnia poniższe wymagania przed przystąpieniem do instalacji:
Zależności: Docker (Engine 26+ i Compose)
System operacyjny: Najnowsza wersja Ubuntu/Debian wspierająca Docker 26+
Zadbaj o to, by wszystkie zależności były zainstalowane, a system operacyjny miał odpowiednią wersję, aby uniknąć problemów z kompatybilnością podczas instalacji Standard Notes.
Przygotowanie
Przed konfiguracją Standard Notes musisz przygotować swój system. Obejmuje to aktualizację systemu operacyjnego do najnowszej wersji oraz instalację wszystkich wymaganych zależności. Te kroki zapewnią stabilne środowisko i pomogą uniknąć problemów podczas lub po instalacji.
Aktualizacja systemu
Aby mieć pewność, że Twój system działa na najnowszym oprogramowaniu i ma aktualizacje bezpieczeństwa, zawsze zacznij od aktualizacji systemu. Wykonaj polecenie:
sudo apt update && sudo apt upgrade -y
Dzięki temu Twój system będzie miał najnowsze poprawki bezpieczeństwa i wersje oprogramowania przed dalszymi krokami.
Instalacja zależności
Po zakończeniu aktualizacji możesz przejść do instalacji zależności. Standard Notes będzie uruchamiany na Twoim VPS za pomocą zestawu kontenerów Docker, więc najpierw musisz zainstalować Dockera. Wykonaj polecenia:
curl -fsSL https://get.docker.com -o get-docker.sh
sh get-docker.sh
Pełny poradnik instalacji i obsługi Dockera znajdziesz w naszym poradniku Docker.
Instalacja
Gdy spełnisz wszystkie wymagania i przygotujesz system, możesz przejść do instalacji Standard Notes.
Najpierw utwórz folder, w którym będą przechowywane wszystkie pliki konfiguracyjne i instalacyjne. Ten folder będzie Twoim katalogiem roboczym podczas instalacji.
mkdir standardnotes
cd standardnotes
Następnie utwórz plik .env w katalogu roboczym i wypełnij go domyślnymi wartościami z przykładowej konfiguracji projektu:
touch .env
curl https://raw.githubusercontent.com/standardnotes/server/main/.env.sample > .env
Ten plik zawiera minimalny zestaw zmiennych potrzebnych do działania. Pełną listę aktualnie używanych zmiennych znajdziesz tutaj: docker-entrypoint.sh
Otwórz plik .env i upewnij się, że wszystkie klucze w sekcji KEYS są poprawnie ustawione. Wygeneruj losowe wartości dla każdej wymaganej zmiennej środowiskowej za pomocą:
openssl rand -hex 32
Wklej te wartości do pliku .env. Standard Notes wymaga skryptu bootstrap dla LocalStack. Pobierz go do katalogu roboczego i nadaj mu prawa do wykonania:
curl https://raw.githubusercontent.com/standardnotes/server/main/docker/localstack_bootstrap.sh > localstack_bootstrap.sh
chmod +x localstack_bootstrap.sh
Pobierz oficjalny przykład konfiguracji i zapisz go jako docker-compose.yml w swoim folderze roboczym. Ten plik definiuje wszystkie usługi kontenerowe potrzebne do Standard Notes.
curl https://raw.githubusercontent.com/standardnotes/server/main/docker-compose.example.yml > docker-compose.yml
Gdy wszystko jest gotowe, pobierz najnowsze obrazy i uruchom usługi w trybie odłączonym:
docker compose pull && docker compose up -d
Konfiguracja
Domyślna konfiguracja w dostarczonym pliku docker-compose.yml może być dostosowana do Twoich potrzeb. Kluczową sekcją jest usługa server, gdzie możesz zmienić mapowanie portów w właściwości ports. Pozwala to wybrać, na których portach hosta aplikacja będzie dostępna, co pomaga uniknąć konfliktów z innymi usługami lub dopasować się do preferowanej konfiguracji sieci.
Zabezpieczenie bazy danych to kolejny ważny krok. Domyślne hasła powinny zostać zastąpione silnymi, losowo wygenerowanymi ciągami. Możesz wygenerować bezpieczne hasło poleceniem:
openssl rand -hex 12
Dodaj wygenerowaną wartość do pliku .env jako DB_PASSWORD. Ta sama wartość musi być ustawiona również dla MYSQL_ROOT_PASSWORD i MYSQL_PASSWORD w pliku docker-compose.yml, aby kontenery były zsynchronizowane.
Te zmiany konfiguracji zapewnią, że Twoja instalacja będzie nie tylko działająca, ale też bezpieczna i dopasowana do Twojego środowiska.
Połączenie z serwerem synchronizacji
Aby skonfigurować konto w Standard Notes, kliknij ikonę avatara w prawym dolnym rogu aplikacji. W wyświetlonym menu wybierz „Utwórz konto”, aby rozpocząć tworzenie nowego profilu użytkownika. Wprowadź ważny adres e-mail oraz bezpieczne hasło.
Przed zakończeniem procesu otwórz sekcję „Opcje zaawansowane”. W polu „Serwer synchronizacji” wybierz opcję „Niestandardowy” i wpisz adres IP oraz port swojego serwera w formacie IP:Port. Dzięki temu Twoje notatki nie będą synchronizowane przez domyślną usługę Standard Notes, lecz przez Twój własny, samodzielnie hostowany serwer.
Podsumowanie i dodatkowe materiały
Gratulacje! Właśnie pomyślnie zainstalowałeś i skonfigurowałeś Standard Notes na swoim VPS. Polecamy też zapoznać się z poniższymi materiałami, które mogą Ci pomóc i wesprzeć podczas konfiguracji serwera:
- Standardnotes.com - Oficjalna strona
- Standardnotes.com/help - Centrum pomocy Standard Notes (dokumentacja)
Masz pytania, które nie zostały tu poruszone? Jeśli potrzebujesz dalszej pomocy, śmiało kontaktuj się z naszym zespołem wsparcia, który jest dostępny codziennie, by Ci pomóc! 🙂