Používání
0. SSH na server
Připojte se k serveru jako root:
ssh root@<SERVER_IP>
Přihlaste se pomocí svého hesla.
1. Přepněte na uživatele aplikace
Všechny operace s kancelářskými sponkami musí běžet pod vyhrazeným uživatelem:
su - paperclip
NEPOUŽÍVEJTE Paperclip jako root.
2. První nastavení (průvodce registrací)
Spusťte interaktivní nastavení:
paperclipai onboard
Tím se nakonfiguruje vaše instance pro první použití.
3. Spusťte kancelářskou sponku
Spusťte aplikaci:
paperclipai run
Chcete-li jej udržet v chodu 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 odhaluje:
- API server →
http://127.0.0.1:3100/api - Kontrola zdravotního stavu →
http://127.0.0.1:3100/api/health - UI →
http://127.0.0.1:3100
Toto jsou výchozí nastavení a budou platit, pokud během konfigurace výslovně nezměníte vazbu, port nebo doménu.
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. Bezpečný přístup k uživatelskému rozhraní (tunelování SSH)
Z místního počítače 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 na adrese:
/root/.cloudzy-creds
Přejděte na http://127.0.0.1:3100 v místním prohlížeči pro přístup k uživatelskému rozhraní Paperclip.
Ujistěte se, že Paperclip běží na serveru, jinak nebudou uživatelské rozhraní a API přístupné.
Důležité cesty
- Domovský adresář:
/home/paperclip - Konfigurace:
/home/paperclip/.paperclip/instances/default/config.json - Protokoly/data:
/home/paperclip/.paperclip/ - Adresář NVM:
/home/paperclip/.nvm/
Poznámky
- Neutíkej
paperclipaipříkazy jako root (vždy spouštět podpaperclipuživatel) - The
paperclippřihlašovací údaje uživatele jsou bezpečně uloženy/root/.cloudzy-creds - Můžete se také přihlásit přímo jako
paperclipuživatel používající SSH:ssh paperclip@<SERVER_IP> - Když jste přihlášeni jako root, vždy se před spuštěním jakýchkoli příkazů Paperclip přepněte na uživatele aplikace:
su - paperclip - Běh
onboardpouze při prvním nastavení - Použití
configurepozději pro změny