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ć?

MetodaPasuje do
Docker ComposeNajprostsza i zalecana instalacja
PodmanAlternatywa kompatybilna z Dockerem bez Docker Desktop
Node.js 24Przeglą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

  1. Pobierz repozytorium i otwórz folder projektu:
git clone https://github.com/Xoliul/condui-community.git
cd condui-community
  1. Pobierz opublikowany obraz i uruchom kontener:
docker compose up -d
  1. Otwórz http://localhost:8080. Po uruchomieniu kontenera pojawi się strona główna Condui Community.
  1. 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.yaml na przykład zmień 8080:8080 na 8081:8080, a następnie otwórz http://localhost:8081.
  • Kompilacja kodu źródłowego nie uruchamia się: sprawdź, czy node --version pokazuje 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 logs i 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.