Brug
0. SSH ind på serveren
Opret forbindelse til din server som root:
ssh root@<SERVER_IP>
Log ind med din adgangskode.
1. Skift til applikationsbrugeren
Alle Paperclip-handlinger skal køres under den dedikerede bruger:
su - paperclip
Kør IKKE Paperclip som root.
2. Første opsætning (installationsguide)
Kør den interaktive opsætning:
paperclipai onboard
Dette konfigurerer din instans til første brug.
3. Start Paperclip
Start applikationen:
paperclipai run
Brug værktøjer som f.eks. for at holde den kørende efter logout tmux
4. Standardtjenester
Når den kører (medmindre du har ændret konfigurationen), eksponerer systemet:
- API-server →
http://127.0.0.1:3100/api - Sundhedstjek →
http://127.0.0.1:3100/api/health - Brugergrænseflade →
http://127.0.0.1:3100
Dette er standardindstillingerne og gælder, medmindre du eksplicit ændrer binding, port eller domæne under konfigurationen.
5. Nyttige kommandoer
# Help / CLI reference
paperclipai --help
# Diagnose issues
paperclipai doctor
# Reconfigure setup
paperclipai configure
# Print environment variables for deployment
paperclipai env
6. Tilgå brugerfladen sikkert (SSH-tunneling)
Kør følgende fra din lokale maskine:
ssh -L 3100:127.0.0.1:3100 paperclip@<SERVER_IP>
Log ind med de legitimationsoplysninger, der er gemt på serveren her:
/root/.cloudzy-creds
Gå til http://127.0.0.1:3100 i din lokale browser for at tilgå Paperclip-brugerfladen.
Sørg for, at Paperclip kører på serveren, ellers vil brugerfladen og API ikke være tilgængelige.
Vigtige stier
- Hjemmemappe:
/home/paperclip - Konfiguration:
/home/paperclip/.paperclip/instances/default/config.json - Logfiler/data:
/home/paperclip/.paperclip/ - NVM-mappe:
/home/paperclip/.nvm/
Noter
- Kør ikke
paperclipaikommandoer som root (kør altid underpaperclipbruger) - Det
paperclipbrugeroplysninger er gemt sikkert i/root/.cloudzy-creds - Du kan også logge direkte ind som
paperclipbruger via SSH:ssh paperclip@<SERVER_IP> - Når du er logget ind som root, skal du altid skifte til applikationsbrugeren, før du kører Paperclip-kommandoer:
su - paperclip - Kør
onboardkun ved første opsætning - Brug
configuresenere ved ændringer