Gemkapocs

Használat

0. SSH a szerverbe

Csatlakozás a szerverhez rootként:

ssh root@<SERVER_IP>

Jelentkezzen be jelszavával.

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

Minden iratkapocs-műveletnek a dedikált felhasználó alatt kell futnia:

su - paperclip

NE futtassa a Paperclip-et rootként.

2. Első beállítás (bevezető varázsló)

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

paperclipai onboard

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

3. Indítsa el a Gémkapcsot

Indítsa el az alkalmazást:

paperclipai run

Ahhoz, hogy kijelentkezés után is működjön, használjon olyan eszközöket, mint pl tmux

4. Alapértelmezett szolgáltatások

Futás után (hacsak nincs újrakonfigurálva) a rendszer a következőket teszi közzé:

• API szerver → http://127.0.0.1:3100/api
• Egészségügyi ellenőrzés → http://127.0.0.1:3100/api/health
• UI → http://127.0.0.1:3100

Ezek az alapértelmezett beállítások, és akkor érvényesek, ha a konfiguráció során kifejezetten nem módosítja az összerendelést, a portot vagy a tartományt.

5. Hasznos parancsok

# Help / CLI reference
paperclipai --help

# Diagnose issues
paperclipai doctor

# Reconfigure setup
paperclipai configure

# Print environment variables for deployment
paperclipai env

6. Biztonságos hozzáférés a felhasználói felülethez (SSH alagút)

A helyi gépről futtasd:

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

Jelentkezzen be a kiszolgálón tárolt hitelesítő adatokkal:

/root/.cloudzy-creds

Navigáljon ide http://127.0.0.1:3100 helyi böngészőjében a Paperclip UI eléréséhez.

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

Fontos útvonalak

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

Megjegyzések

• Ne fuss paperclipai parancsokat rootként (mindig a paperclip felhasználó)
• A paperclip a felhasználói hitelesítő adatokat biztonságosan tárolják /root/.cloudzy-creds
• Közvetlenül is bejelentkezhet a paperclip SSH-t használó felhasználó: ssh paperclip@<SERVER_IP>
• Ha root felhasználóként jelentkezik be, mindig váltson az alkalmazás felhasználójára, mielőtt bármilyen gemkapocs-parancsot futtatna: su - paperclip
• Fut onboard csak az első beállításnál
• Használat configure később a változtatások miatt