Скрепка для бумаг

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

0. SSH на сервер

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

ssh root@<SERVER_IP>

Войдите, используя свой пароль.

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

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

su - paperclip

НЕ запускайте Paperclip от имени пользователя root.

2. Первоначальная настройка (мастер адаптации)

Запустите интерактивную настройку:

paperclipai onboard

Это настраивает ваш экземпляр для первого использования.

3. Запустите скрепку.

Запустите приложение:

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/
• Каталог НВМ: /home/paperclip/.nvm/

Примечания

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