скріпка

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

0. SSH на сервер

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

ssh root@<SERVER_IP>

Увійдіть, використовуючи свій пароль.

1. Перейдіть до користувача програми

Усі операції зі скріпкою мають виконуватися під керуванням спеціального користувача:

su - paperclip

НЕ запускайте Paperclip як root.

2. Перше налаштування (майстер адаптації)

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

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 запущено на сервері, інакше інтерфейс користувача та API будуть недоступні.

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

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

Примітки

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