Gebruik
0. SSH naar de server
Maak verbinding met je server als root:
ssh root@<SERVER_IP>
Log in met uw wachtwoord.
1. Schakel over naar de applicatiegebruiker
Alle Paperclip-bewerkingen moeten worden uitgevoerd onder de specifieke gebruiker:
su - paperclip
Voer Paperclip NIET uit als root.
2. Eerste installatie (onboardingwizard)
Voer de interactieve installatie uit:
paperclipai onboard
Hiermee configureert u uw exemplaar voor het eerste gebruik.
3. Start Paperclip
Start de applicatie:
paperclipai run
Om het na het uitloggen actief te houden, gebruik je tools zoals tmux
4. Standaardservices
Eenmaal actief (tenzij opnieuw geconfigureerd), toont het systeem:
- API-server →
http://127.0.0.1:3100/api - Gezondheidscontrole →
http://127.0.0.1:3100/api/health - Gebruikersinterface →
http://127.0.0.1:3100
Dit zijn de standaardinstellingen en zijn van toepassing tenzij u tijdens de configuratie expliciet de binding, poort of domein wijzigt.
5. Handige commando's
# Help / CLI reference
paperclipai --help
# Diagnose issues
paperclipai doctor
# Reconfigure setup
paperclipai configure
# Print environment variables for deployment
paperclipai env
6. Veilig toegang krijgen tot de gebruikersinterface (SSH-tunneling)
Voer vanaf uw lokale computer het volgende uit:
ssh -L 3100:127.0.0.1:3100 paperclip@<SERVER_IP>
Log in met de inloggegevens die zijn opgeslagen op de server op:
/root/.cloudzy-creds
Navigeer naar http://127.0.0.1:3100 in uw lokale browser om toegang te krijgen tot de Paperclip-gebruikersinterface.
Zorg ervoor dat Paperclip op de server draait, anders zijn de gebruikersinterface en API niet toegankelijk.
Belangrijke paden
- Thuismap:
/home/paperclip - Configuratie:
/home/paperclip/.paperclip/instances/default/config.json - Logboeken/gegevens:
/home/paperclip/.paperclip/ - NVM-directory:
/home/paperclip/.nvm/
Opmerkingen
- Niet rennen
paperclipaicommando's als root (altijd uitgevoerd onder depaperclipgebruiker) - De
paperclipgebruikersgegevens worden veilig opgeslagen in/root/.cloudzy-creds - Je kunt ook direct inloggen als de
paperclipgebruiker die SSH gebruikt:ssh paperclip@<SERVER_IP> - Wanneer u bent ingelogd als root, schakel dan altijd over naar de applicatiegebruiker voordat u Paperclip-opdrachten uitvoert:
su - paperclip - Loop
onboardalleen bij de eerste installatie - Gebruik
configurelater voor wijzigingen