Paperclip

Használat

0. SSH a szerverre

Csatlakozz a szerverhez root-ként:

ssh root@<SERVER_IP>

Lépj be a jelszavaddal.

1. Váltás az alkalmazás felhasználójára

Az összes Paperclip műveletet a dedikált felhasználó alatt kell futtatni:

su - paperclip

NE futtasd a Paperclip-t root-ként.

2. Első indítás (telepítési varázsló)

Futtasd az interaktív beállítást:

paperclipai onboard

Ez konfigurálja a példányt az első használatra.

3. A Paperclip indítása

Indítsd el az alkalmazást:

paperclipai run

Ha kijelentkezés után is futva szeretnéd tartani, használj olyan eszközt, mint például tmux

4. Alapértelmezett szolgáltatások

Elindítás után (ha nincs átkonfigurálva) a rendszer a következőket teszi elérhetővé:

• API kiszolgáló → http://127.0.0.1:3100/api
• Állapot ellenőrzés → http://127.0.0.1:3100/api/health
• Felhasználói felület → http://127.0.0.1:3100

Ezek az alapértelmezett beállítások, és érvényben maradnak, hacsak a konfigurálás során nem módosítod explicit módon a kötést, a portot vagy a domaint.

5. Hasznos parancsok

# Help / CLI reference
paperclipai --help

# Diagnose issues
paperclipai doctor

# Reconfigure setup
paperclipai configure

# Print environment variables for deployment
paperclipai env

6. A felhasználói felület biztonságos elérése (SSH tunneling)

A helyi gépedről futtasd:

ssh -L 3100:127.0.0.1:3100 paperclip@<SERVER_IP>

Jelentkezz be a szerveren tárolt hitelesítő adatokkal, amelyek itt találhatók:

/root/.cloudzy-creds

Navigáljon a következőhöz: http://127.0.0.1:3100 a helyi böngésződben a Paperclip felhasználói felület eléréséhez.

Győződj meg arról, hogy a Paperclip fut a szerveren, különben sem a felhasználói felület, sem a API nem lesz elérhető.

Fontos útvonalak

• Kezdőkönyvtár: /home/paperclip
• Konfiguráció: /home/paperclip/.paperclip/instances/default/config.json
• Naplók/adatok: /home/paperclip/.paperclip/
• NVM könyvtár: /home/paperclip/.nvm/

Megjegyzések

• Ne futtass paperclipai parancsokat root-ként (mindig a paperclip felhasználó)
• A paperclip a felhasználói hitelesítő adatok biztonságosan tárolva vannak itt: /root/.cloudzy-creds
• Közvetlenül is bejelentkezhetsz paperclip felhasználóként SSH segítségével: ssh paperclip@<SERVER_IP>
• Ha root-ként vagy bejelentkezve, a Paperclip parancsok futtatása előtt mindig válts át az alkalmazás felhasználójára: su - paperclip
• Futtat onboard csak az első beállításnál
• Használj configure később módosításokhoz