การใช้งาน
0. SSH ลงในเซิร์ฟเวอร์
เชื่อมต่อเซิร์ฟเวอร์ของคุณในฐานะ root:
ssh root@<SERVER_IP>
เข้าสู่ระบบด้วยรหัสผ่านของคุณ
1. เปลี่ยนไปใช้ผู้ใช้แอปพลิเคชัน
การดำเนินการทั้งหมดของ Paperclip ต้องรันภายใต้ผู้ใช้เฉพาะที่กำหนดไว้เท่านั้น:
su - paperclip
ห้ามรัน Paperclip ในฐานะ root
2. การตั้งค่าครั้งแรก (onboarding wizard)
รัน interactive setup:
paperclipai onboard
ขั้นตอนนี้จะตั้งค่า instance ของคุณสำหรับการใช้งานครั้งแรก
๓. เริ่มต้น Paperclip
เปิดใช้งานแอปพลิเคชัน:
paperclipai run
หากต้องการให้แอปทำงานต่อเนื่องหลังจาก logout ให้ใช้เครื่องมืออย่างเช่น tmux
4. บริการเริ่มต้น
เมื่อระบบทำงานแล้ว (เว้นแต่จะตั้งค่าใหม่) ระบบจะเปิดให้เข้าถึงที่:
- เซิร์ฟเวอร์ API →
http://127.0.0.1:3100/api - ตรวจสอบสุขภาพ →
http://127.0.0.1:3100/api/health - ส่วนต่อประสานผู้ใช้ →
http://127.0.0.1:3100
นี่คือการตั้งค่าเริ่มต้นที่จะมีผลโดยอัตโนมัติ เว้นแต่คุณจะเปลี่ยน binding, port หรือโดเมนระหว่างการตั้งค่าอย่างชัดเจน
5. คำสั่งที่มีประโยชน์
# Help / CLI reference
paperclipai --help
# Diagnose issues
paperclipai doctor
# Reconfigure setup
paperclipai configure
# Print environment variables for deployment
paperclipai env
6. เข้าถึง UI อย่างปลอดภัย (SSH tunneling)
จากเครื่องของคุณ ให้รัน:
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ใช้ภายหลังเมื่อมีการเปลี่ยนแปลง
