Administratorzy

Uruchom własny serwer Welley

Nasze narzędzie wiersza poleceń instaluje wszystko, czego potrzebuje Welley, na jednej maszynie z Linuksem. Może to być serwer w chmurze, a także twój własny sprzęt.

Przeczytaj: Szybki start: minimalne wdrożenie Welley Przeczytaj: Welley CLI Zainstaluj Docker Engine

Planujemy w przyszłości udostępnić Welley jako oprogramowanie open source. Nie ogłosiliśmy jeszcze daty wydania ani licencji.

Przygotuj hosta, DNS i e-mail

To wymagania początkowe z przewodnika szybkiego startu. Ile mocy potrzebujesz, zależy od użytkowników i obciążenia.

Host z Linuksem

Ubuntu 24.04 LTS albo podobna aktualna dystrybucja.
Zacznij od 2 vCPU, 4 GB RAM i 60 GB dysku.
Użyj stałego publicznego adresu IPv4 i użytkownika innego niż root, z uprawnieniami sudo.

Sieć

Zezwól na ruch przychodzący TCP 80 i 443 z internetu. Zezwól na TCP 22 z własnej sieci.
Zostaw port 80 wolny dla wyzwania certyfikatu i cotygodniowego odnawiania certyfikatu.

DNS strony

Wskaż swoją domenę i storage.<domain> na adres IP hosta.
Utwórz oba rekordy przed instalacją. CLI je sprawdza i zatrzymuje się, jeśli nie wskazują na hosta.

SMTP i e-mail administratora

Przygotuj host SMTP, użytkownika, hasło i adres nadawcy. Domyślnie używany jest STARTTLS na porcie 587.
Potrzebujesz też adresu e-mail administratora do pierwszego logowania i odzyskiwania hasła.

DNS dla e-maila

Skonfiguruj SPF, DMARC i DKIM generowany przez twojego dostawcę dla domeny adresu nadawcy.
Użyj dokładnej wartości SPF od dostawcy. Połącz ją z istniejącym rekordem SPF zamiast dodawać drugi.
CLI ostrzega, jeśli brakuje SPF lub DMARC. Nie może sprawdzić selektora DKIM twojego dostawcy.

Zainstaluj Docker Engine i Compose

Postępuj według oficjalnej instrukcji Dockera dla swojej dystrybucji Linuksa. Potem daj użytkownikowi wdrożenia dostęp do Dockera.

Instalacja Docker Engine

Dodaj użytkownika do grupy Docker

Zastąp <user> swoim użytkownikiem wdrożenia innym niż root. Po uruchomieniu tego polecenia wyloguj się i zaloguj ponownie.

sudo usermod -aG docker <user>

Sprawdź Docker i Compose

Oba polecenia muszą działać dla tego użytkownika.

docker ps
docker compose version

Pobierz CLI

Wybierz plik binarny dla maszyny, na której będziesz uruchamiać CLI. Sam host wdrożenia musi działać na Linuksie.

Linux, x86-64

curl -fL "https://appstore.allroads.social/v1/social.wellesley.wlycli/latest?channel=stable&platform=linux/amd64" -o wlycli
chmod +x wlycli
./wlycli -v

Linux, ARM64

curl -fL "https://appstore.allroads.social/v1/social.wellesley.wlycli/latest?channel=stable&platform=linux/arm64" -o wlycli
chmod +x wlycli
./wlycli -v

macOS, Apple silicon

curl -fL "https://appstore.allroads.social/v1/social.wellesley.wlycli/latest?channel=stable&platform=darwin/arm64" -o wlycli
chmod +x wlycli
./wlycli -v

macOS, Intel

curl -fL "https://appstore.allroads.social/v1/social.wellesley.wlycli/latest?channel=stable&platform=darwin/amd64" -o wlycli
chmod +x wlycli
./wlycli -v

Te polecenia pobierają pliki ze stabilnego kanału i pokazują wersję CLI.
Wersja zmienia się z każdym nowym wydaniem. Podczas instalacji korzystaj z najnowszej dokumentacji CLI.

Utwórz wdrożenie

Uruchom to polecenie na przygotowanym hoście z Linuksem. Zastąp przykładową domenę, e-mail i wartości SMTP własnymi.

./wlycli deploy create \
-d example.com \
-e admin@example.com \
--smtp-host smtp.example.com \
--smtp-user "$MAIL_USER" \
--smtp-password "$MAIL_PASSWORD" \
--smtp-from noreply@example.com

Ustawienie	Wartość domyślna
Katalog instalacji	~/.welley/<project>. Przykładowa domena daje nazwę projektu example_com.
Baza danych	Dołączony PostgreSQL, z danymi w katalogu instalacji.
Stos	Platforma Welley, potok RAG, Nginx, Redis i PostgreSQL, z kontenerami do konserwacji.
Certyfikaty	Let’s Encrypt przez Certbot, z cotygodniowym odnawianiem.
Multimedia	Przesłane i statyczne pliki pod adresem https://storage.<domain>.
Aktualizacje	Stabilny kanał, sprawdzany codziennie. Proces aktualizacji w miarę możliwości unika przestojów.
Usługi opcjonalne	Minimalna konfiguracja nie dodaje zarządzanej bazy danych, CDN, telemetrii ani integracji ze Slackiem.

Zanim je uruchomisz, ustaw MAIL_USER i MAIL_PASSWORD na swoje dane logowania SMTP.
Przewodnik szybkiego startu wymaga tych sześciu flag.
Polecenie sprawdza DNS, zapisuje pliki wdrożenia, pobiera certyfikat przez Certbot i uruchamia kontenery.
Polecenie deploy jest aliasem polecenia deployment.

Wygenerowane hasło administratora znajdziesz w logu platformy. Nie udostępniaj tego wyniku.

Znajdź hasło początkowe

Ta nazwa kontenera dotyczy example.com. Dla własnej domeny zmień nazwę projektu.

docker logs example_com-platform-blue-1 | grep "Auto-init complete"

Zaloguj się

Otwórz swoją domenę i zaloguj się adresem e-mail administratora, podanym we fladze -e. Od razu zmień wygenerowane hasło.

Sprawdź kontenery

Przewodnik szybkiego startu oczekuje, że zobaczysz nginx, platform-blue, rag-pipeline-blue, postgres, redis, autoheal i snoopy.

docker ps

Używaj CLI do administracji

CLI ma też polecenia dla API platformy. Twoje konto nadal potrzebuje uprawnień do każdej operacji.

Zanim uruchomisz operację, sprawdź jej aktualne flagi w pomocy polecenia.
Polecenie login przyjmuje bazowy adres URL API, e-mail i hasło. Zapisuje otrzymany token sesji.
Obecnie polecenie logowania wypisuje token sesji w logu po udanym zalogowaniu. Nie pokazuj tych danych nikomu.

Grupy poleceń: accounts, posts, apps, emojis, feeds, reports, rules, settings.

Pokaż dostępne polecenia

./wlycli --help

Pokaż polecenia wdrożenia

./wlycli deployment --help

Pokaż opcje logowania

./wlycli login --help

Pokaż opcje ustawień

./wlycli settings --help

Aktualizacje i odzyskiwanie

Domyślnie wdrożenie codziennie sprawdza, czy są stabilne aktualizacje. Administrator serwera może zarządzać wydaniami w interfejsie administracyjnym.

Jeśli pliki wdrożenia są nadal poprawne, ale niektóre kontenery nie działają, szybki start zaleca uruchomienie polecenia restart, które tworzy kontenery na nowo.
Polecenie create nie uruchomi się ponownie, dopóki istnieje katalog projektu lub jego kontenery.
Opcja force-delete usuwa pliki wdrożenia i dołączoną bazę danych. To nie jest krok odzyskiwania i nie zachowuje twoich danych.
Umiejętność deploy-server nadal używa nazwy deployment update. Obecne CLI ma zamiast tego deployment auto-update. Zanim zrobisz konserwację ręcznie, sprawdź aktualną pomoc CLI.

Utwórz kontenery od nowa na podstawie istniejącego wdrożenia

./wlycli deploy restart -d example.com

Tworzy kontenery od nowa na podstawie zapisanej konfiguracji. Nie usuwa danych wdrożenia.

Wdrożenie z asystentem AI

Jeśli twój asystent AI obsługuje pakiety SKILL.md, pobierz naszą oficjalną umiejętność deploy-server. Prowadzi przez wdrożenie na DigitalOcean.

Na razie umiejętność obejmuje tylko DigitalOcean. Szybki start w CLI działa też z innymi chmurami i z twoim własnym hostem z Linuksem.

Jak z tego korzystać

Rozpakuj pakiet i wczytaj katalog deploy-server tak, jak twój asystent instaluje umiejętności.
Poproś asystenta, żeby użył $deploy-server.
Umiejętność zapyta cię o domenę, dostęp do DNS, konfigurację SSH, dane SMTP i adres e-mail administratora.
Może założyć maszynę wirtualną DigitalOcean i, jeśli chcesz, zarządzaną bazę danych PostgreSQL. Prosi cię o potwierdzenie danych wdrożenia i ceny zarządzanej bazy danych.

Zanim pobierzesz

Pakiet jest niezmienioną kopią oryginalnej umiejętności.
Jego przykłady pobierania i aktualizacji są nieaktualne. Aktualny adres URL do pobrania stabilnej wersji znajdziesz w szybkim starcie na tej stronie. Przed konserwacją sprawdź pomoc CLI.
Umiejętność nie zawiera danych dostępowych do chmury ani działającego serwera i nie możemy zagwarantować, że działa z każdym asystentem.

Pakiet zawiera SKILL.md, agents/openai.yaml i references/digitalocean.md. Obie wersje do pobrania zawierają te same pliki.

Pobierz deploy-server.zip (10,7 KB)Pobierz deploy-server.skill (10,7 KB)

Dokumentacja

Pełna dokumentacja CLI i pliki umiejętności wdrożenia. Możesz je przeczytać tutaj bez konta.