Stapler

Stosowanie

0. SSH do serwera

Połącz się ze swoim serwerem jako root:

ssh root@<SERVER_IP>

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

1. Przejdź do użytkownika aplikacji

Wszystkie operacje związane ze spinaczem muszą być uruchamiane w ramach dedykowanego użytkownika:

su - paperclip

NIE uruchamiaj Paperclip jako root.

2. Pierwsza konfiguracja (kreator wdrażania)

Uruchom interaktywną konfigurację:

paperclipai onboard

Spowoduje to skonfigurowanie instancji do pierwszego użycia.

3. Uruchom Stapler

Uruchom aplikację:

paperclipai run

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

4. Usługi domyślne

Po uruchomieniu (chyba że zostanie ponownie skonfigurowany) system udostępnia:

• Serwer API → http://127.0.0.1:3100/api
• Kontrola stanu zdrowia → http://127.0.0.1:3100/api/health
• Interfejs użytkownika → http://127.0.0.1:3100

Są to ustawienia domyślne i będą obowiązywać, chyba że podczas konfiguracji jawnie zmienisz powiązanie, port lub domenę.

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 użytkownika (tunelowanie SSH)

Na komputerze lokalnym uruchom:

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

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

/root/.cloudzy-creds

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

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

Ważne ścieżki

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

Notatki

• Nie biegaj paperclipai polecenia jako root (zawsze uruchamiaj pod rozszerzeniem paperclip użytkownik)
• The paperclip dane uwierzytelniające użytkownika są bezpiecznie przechowywane w /root/.cloudzy-creds
• Możesz także zalogować się bezpośrednio jako użytkownik paperclip użytkownik korzystający z SSH: ssh paperclip@<SERVER_IP>
• Po zalogowaniu się jako root zawsze przełączaj się na użytkownika aplikacji przed uruchomieniem jakichkolwiek poleceń Paperclip: su - paperclip
• Uruchomić onboard tylko przy pierwszej konfiguracji
• Używać configure później na zmiany