Paperclip

Использование

0. SSH на сервер

Подключитесь к серверу под пользователем root:

ssh root@<SERVER_IP>

Войдите с помощью пароля.

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

Все операции Paperclip должны выполняться от имени выделенного пользователя:

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. Безопасный доступ к UI (туннелирование 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 при последующих изменениях