클립

용법

0. 서버에 SSH로 접속

루트로 서버에 연결합니다.

ssh root@<SERVER_IP>

비밀번호를 사용하여 로그인하세요.

1. 애플리케이션 사용자로 전환

모든 Paperclip 작업은 전용 사용자로 실행되어야 합니다.

su - paperclip

Paperclip을 루트로 실행하지 마십시오.

2. 최초 설정(온보딩 마법사)

대화형 설정을 실행합니다.

paperclipai onboard

이렇게 하면 처음 사용할 인스턴스가 구성됩니다.

3. 페이퍼클립 시작

애플리케이션을 실행합니다:

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 명령은 루트로 실행됩니다(항상 paperclip 사용자)
• 그만큼 paperclip 사용자 자격 증명은 안전하게 저장됩니다. /root/.cloudzy-creds
• 다음과 같이 직접 로그인할 수도 있습니다. paperclip SSH를 사용하는 사용자: ssh paperclip@<SERVER_IP>
• 루트로 로그인한 경우 Paperclip 명령을 실행하기 전에 항상 응용 프로그램 사용자로 전환하십시오. su - paperclip
• 달리다 onboard 첫 번째 설정에서만
• 사용 configure 나중에 변경사항을 위해