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
• UI → 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 UI를 사용할 수 있습니다.

Paperclip가 서버에서 실행 중인지 확인하세요. 실행 중이 아니면 UI와 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 변경 사항 적용 시 사용