Paperclip

Użytkowanie

0. SSH do serwera

Połącz się z serwerem jako root:

ssh root@<SERVER_IP>

Zaloguj się używając swojego hasła.

1. Przełącz się na użytkownika aplikacji

Wszystkie operacje Paperclip muszą być uruchamiane przez dedykowanego użytkownika:

su - paperclip

NIE uruchamiaj Paperclip jako root.

2. Pierwsze uruchomienie (kreator konfiguracji)

Uruchom interaktywną konfigurację:

paperclipai onboard

To przygotowuje instancję do pierwszego użycia.

3. Uruchom Paperclip

Uruchom aplikację:

paperclipai run

Aby utrzymać działanie po wylogowaniu, użyj narzędzi takich jak tmux

4. Usługi domyślne

Po uruchomieniu (o ile nie zmieniono konfiguracji) system udostępnia:

• Serwer API → http://127.0.0.1:3100/api
• Sprawdzenie kondycji → http://127.0.0.1:3100/api/health
• Interfejs użytkownika → http://127.0.0.1:3100

To są domyślne ustawienia, które obowiązują, dopóki jawnie nie zmienisz powiązania, portu lub domeny podczas konfiguracji.

5. Przydatne polecenia

# Help / CLI reference
paperclipai --help

# Diagnose issues
paperclipai doctor

# Reconfigure setup
paperclipai configure

# Print environment variables for deployment
paperclipai env

6. Bezpieczny dostęp do interfejsu (tunelowanie SSH)

Na swoim lokalnym komputerze uruchom:

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

Zaloguj się przy użyciu danych uwierzytelniających przechowywanych na serwerze w:

/root/.cloudzy-creds

Przejdź do http://127.0.0.1:3100 w lokalnej przeglądarce, aby uzyskać dostęp do interfejsu Paperclip.

Upewnij się, że Paperclip działa na serwerze, w przeciwnym razie interfejs i API nie będą dostępne.

Ważne ścieżki

• Katalog domowy: /home/paperclip
• Konfiguracja: /home/paperclip/.paperclip/instances/default/config.json
• Dzienniki/dane: /home/paperclip/.paperclip/
• Katalog NVM: /home/paperclip/.nvm/

Notatki

• Nie uruchamiaj paperclipai polecenia jako root (zawsze uruchamiaj w ramach paperclip użytkownik)
• Trwałość paperclip dane uwierzytelniające użytkownika są bezpiecznie przechowywane w /root/.cloudzy-creds
• Możesz też zalogować się bezpośrednio jako paperclip użytkownik przy użyciu SSH: ssh paperclip@<SERVER_IP>
• Po zalogowaniu jako root przed uruchomieniem jakichkolwiek poleceń Paperclip zawsze przełącz się na użytkownika aplikacji: su - paperclip
• Uruchom onboard tylko przy pierwszej konfiguracji
• Użyj configure później przy wprowadzaniu zmian