คลิป

การใช้งาน

0. SSH เข้าสู่เซิร์ฟเวอร์

เชื่อมต่อกับเซิร์ฟเวอร์ของคุณในฐานะรูท:

ssh root@<SERVER_IP>

เข้าสู่ระบบโดยใช้รหัสผ่านของคุณ

1. สลับไปยังผู้ใช้แอปพลิเคชัน

การดำเนินการคลิปหนีบกระดาษทั้งหมดจะต้องทำงานภายใต้ผู้ใช้เฉพาะ:

su - 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 tunneling)

จากเครื่องท้องถิ่นของคุณ ให้รัน:

ssh -L 3100:127.0.0.1:3100 paperclip@<SERVER_IP>

เข้าสู่ระบบโดยใช้ข้อมูลรับรองที่เก็บไว้บนเซิร์ฟเวอร์ที่:

/root/.cloudzy-creds

นำทางไปยัง http://127.0.0.1:3100 ในเบราว์เซอร์ท้องถิ่นของคุณเพื่อเข้าถึง Paperclip UI

ตรวจสอบให้แน่ใจว่าคลิปหนีบกระดาษทำงานบนเซิร์ฟเวอร์ ไม่เช่นนั้นจะไม่สามารถเข้าถึง UI และ API ได้

Path ที่สำคัญ

• โฮมไดเร็กตอรี่: /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>
• เมื่อเข้าสู่ระบบในฐานะ root ให้สลับไปที่ผู้ใช้แอปพลิเคชันทุกครั้งก่อนที่จะรันคำสั่งคลิปหนีบกระดาษ: su - paperclip
• วิ่ง onboard เฉพาะในการตั้งค่าครั้งแรกเท่านั้น
• ใช้ configure ภายหลังสำหรับการเปลี่ยนแปลง