Instalowanie i budowanie Condui Community
Instalacja lokalna poprzez Docker, Podman lub kod źródłowy.
Condui Community to hostowana lokalnie edycja Condui. Pracuje bez konta, bazy danych i zarządzanej usługi Condui. Możesz samodzielnie zbudować kod źródłowy i uruchomić aplikację na własnym komputerze lub serwerze.
Community domyślnie zapisuje projekty w przeglądarce urządzenia lub opcjonalnie w folderze na własnym serwerze. Pobrane archiwa projektów Condui są kompatybilne z wersją hostowaną w obu kierunkach.
Wyświetl kod źródłowy społeczności Condui na GitHub.
Którą metodę instalacji wybrać?
| Metoda | Pasuje do |
|---|---|
| Docker Compose | Najprostsza i zalecana instalacja |
| Podman | Alternatywa kompatybilna z Dockerem bez Docker Desktop |
| Node.js 24 | Przeglądaj, modyfikuj i ręcznie twórz kod źródłowy |
Dołączony Dockerfile buduje standardowy obraz kontenera OCI. Obraz mogą zbudować także inne narzędzia zgodne ze standardem OCI, ale przetestowane ścieżki instalacji obejmują Docker i Podman.
Wymagania
Do Docker Compose lub Podman potrzebujesz:
- Git lub pobrana kopia repozytorium;
- Docker z wtyczką Compose lub najnowszą instalacją Podmana;
- wolny port lokalny, domyślny
8080; i - nowoczesna przeglądarka.
Do bezpośredniej kompilacji źródłowej będziesz potrzebować Node.js 24 i npm. Nie jest wymagany projekt Supabase, konto w chmurze ani osobna baza danych.
Zainstaluj za pomocą Docker Compose
- Pobierz repozytorium i otwórz folder projektu:
git clone https://github.com/Xoliul/condui-community.git
cd condui-community
- Pobierz opublikowany obraz i uruchom kontener:
docker compose up -d
- Otwórz http://localhost:8080. Po uruchomieniu kontenera pojawi się strona główna Condui Community.
- Sprawdź status lub logi, jeśli to konieczne:
docker compose ps
docker compose logs -f
Zatrzymaj aplikację za pomocą:
docker compose down
Zainstaluj za pomocą Podmana
Najpierw zbuduj obraz OCI:
podman build -t condui-community:local .
Następnie uruchom kontener:
podman run --name condui-community --rm -p 8080:8080 condui-community:local
Otwórz http://localhost:8080. Naciśnij Ctrl+C, aby zatrzymać kontener. W Podman Compose możesz również użyć dołączonego pliku compose.yaml.
Kompiluj i uruchamiaj z kodu źródłowego
Najpierw sprawdź, czy Node.js 24 działa:
node --version
Zainstaluj zależności zapisane w repozytorium, zbuduj wersję produkcyjną i uruchom serwer lokalny:
npm ci --ignore-scripts
npm run build
npm start
Następnie otwórz http://localhost:8080. Serwer lokalny udostępnia aplikację internetową oraz lokalne punkty końcowe konwersji obsługiwanych plików planów.
Aby zaktualizować
Pobierz nową konfigurację Compose i opublikowany obraz:
git pull
docker compose up -d
Utwórz archiwum ważnych projektów przed aktualizacją. Obsługiwane archiwa są migrowane po otwarciu, ale prywatna kopia zapasowa pozostaje najbezpieczniejszą opcją odzyskiwania.
Opcjonalne przechowywanie na własnym serwerze
Dodaj to mapowanie wolumenu pod usługą condui w compose.yaml i ponownie uruchom Compose:
volumes:
- ./condui-data:/data
Projekty, foldery, profil instalatora i preferencje są wtedy zapisywane w condui-data. Urządzenia otwierające tę samą instalację widzą tę samą listę projektów. Przy pierwszym otwarciu można przenieść istniejące projekty z przeglądarki na serwer. Jest to jedna wspólna instalacja bez oddzielnych kont użytkowników; samodzielnie twórz kopię zapasową całego folderu.
Bez hasła Community jest dostępne tylko we własnej sieci, w tym w sieci prywatnej takiej jak Tailscale. Aby uzyskać dostęp spoza niej, ustaw pod tą samą usługą CONDUI_PASSWORD na hasło o długości co najmniej ośmiu znaków. Przy dostępie przez internet używaj HTTPS przez odwrotny serwer proxy; hasło jest wtedy wymagane również we własnej sieci.
environment:
CONDUI_PASSWORD: "choose-your-own-password"
Przechowywanie projektów i kopie zapasowe
Bez przechowywania na serwerze projekty znajdują się w pamięci przeglądarki, a nie w kontenerze. Zastąpienie lub przebudowa kontenera zwykle nie powoduje wymazania pamięci przeglądarki. Przeglądarka traktuje każdą kombinację protokołu, nazwy hosta i portu jako osobne źródło. Dlatego przełączenie z localhost:8080 na inną nazwę hosta lub port może spowodować wyświetlenie pustej listy projektów.
Regularnie pobieraj ważne projekty w postaci archiwum projektu Condui i przechowuj je w kopii zapasowej. PDF jest dokumentem ostatecznym i nie zawiera osadzonego, edytowalnego projektu w Edycji społecznościowej.
Brak zarządzanej kopii zapasowej i wsparcia
Instalacja społecznościowa nie obejmuje zarządzanej pamięci masowej w chmurze, usługi odzyskiwania ani oficjalnej gwarancji wsparcia. Osoba zarządzająca instalacją jest odpowiedzialna za aktualizacje, dostępność i kopie zapasowe.
Typowe problemy
- Port 8080 jest już w użyciu: w
compose.yamlna przykład zmień8080:8080na8081:8080, a następnie otwórzhttp://localhost:8081. - Kompilacja kodu źródłowego nie uruchamia się: sprawdź, czy
node --versionpokazuje wersję 24. - Lista projektów wydaje się pusta: otwórz aplikację ponownie, używając dokładnie tej samej nazwy hosta i portu, albo zaimportuj wcześniej pobrane archiwum projektu.
- Kontener zatrzymuje się podczas budowania: wyświetl
docker compose logsi sprawdź, czy Docker ma wystarczającą ilość pamięci i wolnego miejsca na dysku. - Przeglądarka wyświetla pustą stronę: otwórz jej konsolę programisty. Aplikacja Community działa w przeglądarce; dzienniki Dockera pokazują tylko, czy lokalny serwer WWW został uruchomiony.