Paperclip

Použití

0. SSH na server

Připojte se k serveru jako root:

ssh root@<SERVER_IP>

Přihlaste se pomocí hesla.

1. Přepněte na uživatele aplikace

Všechny operace Paperclip musí běžet pod dedikovaným uživatelem:

su - paperclip

Paperclip NESPOUŠTĚJTE jako root.

2. První spuštění (průvodce nastavením)

Spusťte interaktivní nastavení:

paperclipai onboard

Tím se instance nakonfiguruje pro první použití.

3. Spusťte Paperclip

Spusťte aplikaci:

paperclipai run

Aby běžela i po odhlášení, použijte nástroje jako tmux

4. Výchozí služby

Po spuštění (pokud není překonfigurováno) systém zpřístupní:

• Server API → http://127.0.0.1:3100/api
• Kontrola zdraví → http://127.0.0.1:3100/api/health
• Uživatelské rozhraní → http://127.0.0.1:3100

Toto jsou výchozí nastavení a platí, dokud explicitně nezměníte binding, port nebo doménu během konfigurace.

5. Užitečné příkazy

# Help / CLI reference
paperclipai --help

# Diagnose issues
paperclipai doctor

# Reconfigure setup
paperclipai configure

# Print environment variables for deployment
paperclipai env

6. Zabezpečený přístup k UI (tunelování SSH)

Na svém lokálním počítači spusťte:

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

Přihlaste se pomocí přihlašovacích údajů uložených na serveru v:

/root/.cloudzy-creds

Přejděte na http://127.0.0.1:3100 v lokálním prohlížeči pro přístup k UI Paperclip.

Ujistěte se, že Paperclip běží na serveru, jinak UI ani API nebudou dostupné.

Důležité cesty

• Domovský adresář: /home/paperclip
• Konfigurace: /home/paperclip/.paperclip/instances/default/config.json
• Protokoly/data: /home/paperclip/.paperclip/
• NVM adresář: /home/paperclip/.nvm/

Poznámky

• Nepoužívat paperclipai příkazy jako root (vždy spouštějte pod uživatelem paperclip uživatel)
• The paperclip přihlašovací údaje jsou bezpečně uloženy v /root/.cloudzy-creds
• Můžete se také přihlásit přímo jako uživatel paperclip pomocí SSH: ssh paperclip@<SERVER_IP>
• Pokud jste přihlášeni jako root, před spuštěním jakýchkoli příkazů Paperclip vždy přepněte na uživatele aplikace: su - paperclip
• Spustit onboard pouze při prvním nastavení
• Použijte configure pro pozdější změny