mikrus-setup

mikrus-setup

Konfiguruje połączenie z serwerem VPS Mikrus i testuje je.

Konfiguracja docelowa

Plik ~/.mikrus/config.json (poza repozytorium pluginu; na Windows %USERPROFILE%\.mikrus\config.json):

Pole	Znaczenie	Źródło
srv	nazwa serwera (np. a123)	panel / mail powitalny
host	host SSH (np. srv03.mikr.us)	mail powitalny
sshPort	port SSH = 10000 + numer maszyny	wyliczany
user	root	stałe
identityFile	ścieżka do prywatnego klucza SSH	użytkownik
apiKey	klucz API	https://mikr.us/panel/?a=api
apiBase	https://api.mikr.us	stałe

Procedura

1. Zapytaj użytkownika o: numer maszyny, host, nazwę serwera (srv), ścieżkę do klucza prywatnego, klucz API.
2. Wylicz sshPort = 10000 + numer maszyny. Potwierdź wynik z użytkownikiem.
3. Zaimportuj moduł i zapisz konfigurację:

   Import-Module "$env:CLAUDE_PLUGIN_ROOT/lib/mikrus.psm1" -Force
   $dir = Join-Path $HOME '.mikrus'
   if (-not (Test-Path $dir)) { New-Item -ItemType Directory -Force $dir | Out-Null }
   @{
     srv='a123'; host='srv03.mikr.us'; sshPort=10123; user='root'
     identityFile=(Join-Path $HOME '.ssh/mikrus_ed25519')
     apiKey='WKLEJ_KLUCZ'; apiBase='https://api.mikr.us'
   } | ConvertTo-Json | Set-Content -Path (Join-Path $dir 'config.json') -Encoding utf8
   

4. Jeśli klucz publiczny nie jest jeszcze na serwerze, poinstruuj użytkownika, by go wgrał (np. przez panel Mikrus lub ssh-copy-id-odpowiednik); bez tego logowanie kluczem nie zadziała.
5. Test połączenia:

   $cfg = Get-MikrusConfig
   "API /info:";  Invoke-MikrusApi -Endpoint '/info' -Config $cfg
   "SSH echo:";   (Invoke-MikrusSSH -Command 'echo ok' -Config $cfg).Output
   

6. Raportuj wynik: co działa (API / SSH), a co wymaga poprawy (np. brak klucza na serwerze, zły apiKey).

Uwagi

• Nigdy nie wypisuj apiKey w odpowiedzi do użytkownika ani nie commituj config.json.
• Port 22 jest zablokowany po nieudanych próbach — używamy wyłącznie portu sshPort i klucza.