Plesk
Pozwól Konrado sprawdzać subskrypcję, której dotyczy każde zgłoszenie, przez API Plesk lub wtyczkę Konrado.
Po podłączeniu Plesk Konrado sprawdza subskrypcję, której dotyczy zgłoszenie: klienta, plan, domeny, DNS, SSL, pocztę i bazy danych. Konrado tylko czyta. Na Twoim serwerze nic się nie zmienia.
Serwer podłączasz na jeden z dwóch sposobów. Przez API Konrado czyta Plesk za pomocą tajnego klucza i nic nie trzeba instalować. Przy opcji Wtyczka Konrado uruchamiasz jedno polecenie jako root, a Konrado czyta też logi WWW, foldery skrzynek pocztowych i kolejkę poczty na serwerze. API to obecny sposób. Wtyczka to starsza metoda: działa dalej tam, gdzie jest zainstalowana, a nowy serwer powinien korzystać z API. Wybierz zakładkę poniżej: każda sekcja pokaże treść dla Twojego wyboru.
Co czyta Konrado
Konrado znajduje subskrypcję, stronę, subdomenę lub alias, których dotyczy zgłoszenie, i czyta tylko te dane.
| Dane | Do czego się przydają |
|---|---|
| Konto | Właściciel subskrypcji, reseller nad nią, jej status, plan usług, limity i wykorzystanie |
| Strona | Katalog główny strony, adres IP, handler i wersja PHP, przekierowanie na SSL, używany certyfikat i rekordy DNS |
| Poczta | Każdy adres, to, czy skrzynka jest włączona, jej limit i wykorzystanie, aliasy, przekierowania i autoresponder |
| Pliki | Użytkownik systemowy, ścieżka katalogu głównego i konta FTP. Z kluczem administratora także lista plików w folderze domowym domeny |
| Bazy danych | Każda baza, jej silnik, serwer i użytkownicy |
| Kopie zapasowe | Kopie zapasowe Plesk z kluczem administratora oraz kopie JetBackup 5, jeśli jest zainstalowany |
| Serwer | Wersja Plesk, nazwa hosta, usługi i oczekujące aktualizacje. Tylko z kluczem administratora |
Klucz administratora czyta wszystkie subskrypcje i dane serwera. Klucz resellera lub klienta czyta tylko to, co należy do danego konta.
| Dane | Do czego się przydają |
|---|---|
| Przegląd domeny | Właściciel i subskrypcja, status i to, co zawiera subskrypcja |
| Strona | Błędy HTTP, SSL, wersja i ustawienia PHP oraz ostatnie wpisy z logów WWW i PHP |
| Poczta | Skrzynki, ich foldery, liczba wiadomości i rozmiar, kolejka poczty oraz sprawdzenie rekordów MX i SPF |
| Wykorzystanie | Dysk, transfer i limit oraz to, jak blisko domena jest limitów planu |
| Dostęp | Użytkownicy FTP i SFTP oraz katalog główny strony |
| Pliki | Drzewo katalogu głównego strony i pliki konfiguracyjne, które da się odczytać |
| DNS, bazy danych i cron | Rekordy DNS domeny, bazy danych i zaplanowane zadania |
| Kopie zapasowe | Możliwości przywrócenia domeny |
| Serwer | Licencja Plesk i stan serwera |
Czego Konrado nie potrafi
| Nie da się | Dlaczego |
|---|---|
| Utworzyć, zawiesić, zmienić na wyższy plan ani usunąć subskrypcji, klienta lub planu | Konrado tylko czyta. Zmiany robisz w Plesk albo w systemie rozliczeń |
| Zmienić DNS, poczty, SSL, PHP, plików, baz danych, użytkowników FTP, zadań ani limitów | Konrado może je odczytać, ale nie zmienić |
| Przywrócić kopii zapasowej ani wyczyścić kolejki poczty | Dane o kopiach i poczcie służą tylko do diagnozy |
| Pokazać haseł, kluczy ani treści wiadomości | Hasła, klucze i prywatne wiadomości nigdy nie trafiają do odpowiedzi |
| Sprawdzić czegoś poza serwerem | Problem u rejestratora, w CDN albo u innego dostawcy poczty trzeba sprawdzić osobno |
Uruchomić plesk bin, poleceń powłoki ani SQL | Konrado korzysta ze stałych zapytań, nie z terminala |
| Sprawdzić przez API, czy dotarła konkretna wiadomość | API Plesk pokazuje tylko ustawienia poczty. Wtyczka Konrado może zajrzeć do folderów skrzynek |
Konrado łączy się z Plesk przez HTTPS za pomocą jednego tajnego klucza, który możesz w każdej chwili unieważnić. Nigdy nie wpisuj w Konrado hasła administratora. Po zapisaniu klucza konsola pokazuje tylko jego ostatnie znaki.
- Działają tylko adresy
https://, a certyfikat TLS musi być ważny. - Adres musi prowadzić do publicznego IP. Konrado odrzuca adresy prywatne, loopback i inne wewnętrzne zakresy.
- Konrado najpierw usuwa z każdej odpowiedzi dane poufne. Hasła i klucze prywatne nigdy do niego nie trafiają.
- Konrado korzysta z siedmiu stałych zapytań. Nie może uruchomić na serwerze niczego innego.
Polecenie instalacji zawiera klucz, który łączy serwer z Twoją organizacją, więc traktuj je jak hasło. Konrado łączy się potem z wtyczką na porcie 8000, domyślnym. Otwórz ten port dla adresów IP Konrado i dla nikogo więcej.
- "Do której subskrypcji należy example.com? Czy to domena główna, subdomena czy alias?"
- "Brakuje poczty w skrzynce. Czy skrzynka istnieje i czy jest pełna?"
- "Wysyłana poczta wraca. Czy były ostatnio błędy dostarczenia albo czy kolejka stoi?"
- "SSL nie obejmuje aliasu. Jakiego certyfikatu używa domena?"
- "Strona pokazuje błąd 500. Na jakiej wersji PHP i z jakim handlerem działa?"
- "Klient pyta o przywrócenie. Jakie kopie zapasowe istnieją, zanim przekażemy sprawę dalej?"
Zanim zaczniesz
- Plesk pod publicznym adresem HTTPS z ważnym certyfikatem, na porcie 8443, chyba że wpiszesz inny. Konrado został w pełni przetestowany na Plesk Obsidian 18.0.71.
- Dostęp SSH jako root do serwera Plesk, aby utworzyć tajny klucz.
- Jeśli Plesk stoi za zaporą lub WAF, wpuść adresy IP Konrado na port 8443.
- Podłączony helpdesk, a w systemie rozliczeń usługa hostingowa klienta. Konrado znajduje subskrypcję przez tę usługę, więc jej serwer musi mieć tę samą nazwę hosta lub IP co adres Plesk.
- Dostęp SSH jako root do serwera Plesk, z
curl,unzipi systemd. - Dostęp do internetu z serwera. Instalator pobiera wtyczkę i zgłasza się do
app.konrado.ai. - Port 8000 otwarty dla adresów IP Konrado (zobacz listę).
- Podłączony helpdesk, a w systemie rozliczeń usługa hostingowa klienta. Konrado znajduje subskrypcję przez tę usługę, więc jej serwer musi mieć tę samą nazwę hosta lub IP co serwer, na którym instalujesz wtyczkę.
Podłączanie
Utwórz tajny klucz
Zaloguj się na serwer Plesk przez SSH jako root i uruchom:
plesk bin secret_key --create -description "Konrado"Polecenie pokazuje klucz tylko raz. Skopiuj go do menedżera haseł. Plesk przechowuje tylko jego skrót, więc jeśli zgubisz klucz, usuń go i utwórz nowy. Ten klucz to klucz administratora. Jeśli Twoja konfiguracja na to pozwala, ogranicz też klucz lub zaporę panelu do adresów IP Konrado (zobacz listę).
Podłącz w Konrado
Otwórz Ustawienia obszaru roboczegoIntegracje, kliknij Dodaj integrację i wybierz Plesk. W sekcji Jak Konrado ma łączyć się z tym serwerem? opcja Klucz API jest już wybrana.
| Pole | Co wpisać |
|---|---|
| Nazwa integracji | Nazwę dla Twojego zespołu, np. Plesk EU |
| Adres Plesk | Adres panelu, np. https://plesk.example.com:8443. Jeśli pominiesz port, Konrado użyje portu 8443 |
| Klucz API | Tajny klucz z serwera |
Kliknij Testuj połączenie. Zielone pole potwierdza, że klucz działa. Przy kluczu administratora pokazuje też wersję Plesk. Kliknij Podłącz.
Wtyczka to starsza metoda podłączania. Serwery już podłączone przez nią działają dalej. Dla nowego serwera wybierz zakładkę API, chyba że potrzebujesz logów WWW, folderów skrzynek pocztowych lub kolejki poczty, które czyta tylko wtyczka.
Wybierz wtyczkę. Otwórz Ustawienia obszaru roboczegoIntegracje, kliknij Dodaj integrację i wybierz Plesk. W pytaniu Jak Konrado ma łączyć się z tym serwerem? wybierz Wtyczka Konrado. Okno pokazuje trzy kroki i polecenie instalacji.
Uruchom polecenie jako root. Zaloguj się na serwer Plesk przez SSH jako root. Kliknij przycisk kopiowania obok polecenia i wklej je w sesji. Okno ukrywa Twój klucz na ekranie, ale skopiowane polecenie go zawiera, więc traktuj je jak hasło. Klucz działa przez 24 godziny, na dowolnej liczbie serwerów.
bash <(curl -s https://repo.konrado.ai/init.sh) --api-key=YOUR_KEY --callback-url=https://app.konrado.ai/api/integrations/servers/install --platform=pleskOdpowiedz instalatorowi. Pyta o kilka ustawień, każde ma wartość domyślną: naciśnij Enter, aby ją zachować. Liczą się dwie odpowiedzi. Aby później aktualizować wtyczkę z konsoli, odpowiedz Yes na pytanie Do you want to be able to upgrade this plugin through the Konrado panel? Adres serwera, który proponuje, na przykład http://203.0.113.10:8000/mcp, to adres, pod którym Konrado łączy się z wtyczką.
Poczekaj na połączenie. Okno pokazuje Nasłuchiwanie serwera… i sprawdza co 5 sekund. Gdy wtyczka się zgłosi, pokazuje Połączono pomyślnie i adres serwera. Kliknij Gotowe. Okno możesz zamknąć wcześniej: serwer pojawi się na liście, gdy się połączy. Ponowne uruchomienie polecenia jest bezpieczne.
Sprawdź, czy działa
Serwer jest widoczny na stronie Integracje ze statusem Połączono. W kolumnie Typ widać Plesk · API, a pod spodem wersję Plesk, jeśli klucz należy do administratora. Konrado co godzinę ponownie testuje połączenie. Otwórz wiersz: zakładka Narzędzia pokazuje siedem zapytań.
Aby później zmienić klucz, otwórz wiersz, kliknij Zmień obok pola Klucz API, wklej nowy klucz i kliknij Zapisz.
Serwer jest na stronie Integracje ze statusem Połączono. Jego Typ to Plesk · Wtyczka, z wersją wtyczki pod spodem. Wiersz nazywa się plesk Server: kliknij go, aby zmienić nazwę. Ponowne uruchomienie polecenia instalacji przywraca tę nazwę. Konrado sprawdza połączenie co godzinę.
Jeśli coś nie działa
Otwórz wiersz na stronie Integracje. Serwer, który przestał działać, ma status Nie działa, podpowiedź, co sprawdzić, i dokładny błąd w sekcji Szczegóły techniczne.
| Co widzisz | Co zrobić |
|---|---|
| Plesk URL must use HTTPS. | Wpisz pełny adres https://. Zwykłe HTTP nie działa |
| Plesk URL cannot contain credentials, query parameters, or a fragment. | Wpisz tylko adres i port, np. https://plesk.example.com:8443 |
| Plesk TLS verification failed. | Zainstaluj ważny certyfikat dla nazwy hosta Plesk, z pełnym łańcuchem |
| Plesk rejected the configured API key. | Sprawdź, czy skopiowano cały klucz i czy nie jest ograniczony do innego adresu IP |
| This Plesk API key cannot read that capability. | Konto, do którego należy klucz, nie widzi tej części. Do plików, kopii zapasowych Plesk i stanu serwera użyj klucza administratora |
| The Plesk API request timed out. | Sprawdź, czy Plesk odpowiada na porcie 8443 i czy zapora lub WAF wpuszcza adresy IP Konrado (zobacz listę) |
| Adres prowadzi do sieci prywatnej | Użyj publicznej nazwy hosta. Konrado odrzuca adresy prywatne i wewnętrzne |
| Brak wersji po kliknięciu Testuj połączenie | To klucz resellera lub klienta. Połączenie działa, ale Konrado czyta tylko to, co należy do tego konta |
| Konrado sprawdza niewłaściwą subskrypcję | Sprawdź, czy usługa ze zgłoszenia w systemie rozliczeń jest na tym serwerze |
| Co widzisz | Co zrobić |
|---|---|
| Polecenie od razu się zatrzymuje | Uruchom je jako root bezpośrednio na serwerze Plesk |
| Komunikat Nasłuchiwanie serwera… się nie zmienia | Sprawdź, czy instalator zakończył pracę bez błędów i czy serwer łączy się z app.konrado.ai przez HTTPS. Po 2 minutach okno pokazuje komunikat Trwa dłużej niż zwykle? z tymi samymi wskazówkami |
| Brakuje danych subskrypcji | Sprawdź, czy na tym serwerze działa Plesk i czy w konsoli wybrano Plesk |
| Konrado sprawdza niewłaściwą subskrypcję | Sprawdź, czy usługa ze zgłoszenia w systemie rozliczeń jest na tym serwerze |
Krok instalacji pokazuje Błąd połączenia. Podaje adres serwera i przyczynę. Sprawdź obie usługi wtyczki, przeczytaj ich ostatnie logi i uruchom je ponownie:
systemctl status konrado-server.service konrado-root.service
journalctl -u konrado-server.service -u konrado-root.service --since "15 minutes ago" --no-pager
systemctl restart konrado-server.service konrado-root.service
systemctl enable konrado-server.service konrado-root.service
ss -ltnp | grep ':8000'Ostatni wiersz pokazuje, czy wtyczka nasłuchuje na porcie 8000. Konrado musi mieć dostęp do tego portu: zezwól na adresy IP Konrado w swojej zaporze. Potem uruchom polecenie instalacji ponownie.
Usuń integrację
Otwórz Ustawienia obszaru roboczegoIntegracje, otwórz menu wiersza (trzy kropki) i wybierz Usuń. Następnie usuń tajny klucz w Plesk.
Aby tylko wstrzymać działanie i zachować ustawienia, wybierz zamiast tego Odłącz.
Odinstaluj wtyczkę z serwera, a potem otwórz Ustawienia obszaru roboczegoIntegracje, otwórz menu wiersza (trzy kropki) i wybierz Usuń.
Aby tylko wstrzymać działanie i zachować ustawienia, wybierz zamiast tego Odłącz.
Ostatnia aktualizacja: