Paperclip

Використання

0. SSH до сервера

Підключіться до сервера як root:

ssh root@<SERVER_IP>

Увійдіть за допомогою пароля.

1. Переключіться на користувача застосунку

Всі операції Paperclip повинні виконуватись від імені виділеного користувача:

su - paperclip

НЕ запускайте Paperclip від імені root.

2. Початкове налаштування (майстер onboarding)

Запустіть інтерактивне налаштування:

paperclipai onboard

Це підготовляє ваш інстанс до першого використання.

3. Запустити Paperclip

Запустіть застосунок:

paperclipai run

Щоб він продовжував працювати після виходу з системи, використовуйте такі інструменти, як tmux

4. Типові послуги

Після запуску (якщо налаштування не змінювались) система відкриває доступ до:

• сервер API → http://127.0.0.1:3100/api
• Перевірка здоров'я → http://127.0.0.1:3100/api/health
• Користувацький інтерфейс → http://127.0.0.1:3100

Це стандартні параметри, які діють, якщо ви явно не змінили прив'язку, порт або домен під час конфігурації.

5. Корисні команди

# Help / CLI reference
paperclipai --help

# Diagnose issues
paperclipai doctor

# Reconfigure setup
paperclipai configure

# Print environment variables for deployment
paperclipai env

6. Безпечний доступ до інтерфейсу (тунелювання SSH)

На локальній машині виконайте:

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

Увійдіть за допомогою облікових даних, збережених на сервері за шляхом:

/root/.cloudzy-creds

Перейти до http://127.0.0.1:3100 у браузері на локальній машині, щоб відкрити інтерфейс Paperclip.

Переконайтеся, що Paperclip запущено на сервері, інакше інтерфейс і API будуть недоступні.

Важливі шляхи

• Домашня директорія: /home/paperclip
• Конфіг: /home/paperclip/.paperclip/instances/default/config.json
• Журнали/дані: /home/paperclip/.paperclip/
• Директорія NVM: /home/paperclip/.nvm/

Нотатки

• Не запускати paperclipai команди від імені root (завжди виконуйте під paperclip користувач)
• Той paperclip облікові дані користувача зберігаються захищено в /root/.cloudzy-creds
• Ви також можете увійти безпосередньо як paperclip користувач через SSH: ssh paperclip@<SERVER_IP>
• Увійшовши як root, перед виконанням будь-яких команд Paperclip завжди перемикайтесь на користувача застосунку: su - paperclip
• Запустити onboard лише під час першого налаштування
• Використовуйте configure пізніше для внесення змін