الاستخدام
0. الاتصال بـ SSH بالخادم
اتصل بخادمك بصفة root:
ssh root@<SERVER_IP>
سجّل الدخول باستخدام كلمة المرور الخاصة بك.
1. التبديل إلى مستخدم التطبيق
يجب تشغيل جميع عمليات Paperclip تحت المستخدم المخصص:
su - paperclip
لا تشغّل Paperclip بصلاحيات root.
٢. الإعداد الأولي (معالج التهيئة)
شغّل الإعداد التفاعلي:
paperclipai onboard
يُهيئ هذا الأمر نسختك للاستخدام لأول مرة.
٣. تشغيل Paperclip
أطلق التطبيق:
paperclipai run
للإبقاء عليه يعمل بعد تسجيل الخروج، استخدم أدوات مثل tmux
٤. الخدمات الافتراضية
بعد التشغيل (ما لم يُعاد تكوينه)، يعرض النظام:
- خادم API ←
http://127.0.0.1:3100/api - فحص الحالة ←
http://127.0.0.1:3100/api/health - واجهة المستخدم ←
http://127.0.0.1:3100
هذه هي الإعدادات الافتراضية وستُطبَّق ما لم تغيّر صراحةً الارتباط أو المنفذ أو النطاق أثناء التكوين.
٥. أوامر مفيدة
# Help / CLI reference
paperclipai --help
# Diagnose issues
paperclipai doctor
# Reconfigure setup
paperclipai configure
# Print environment variables for deployment
paperclipai env
٦. الوصول إلى واجهة المستخدم بأمان (نفق SSH)
من جهازك المحلي، شغّل:
ssh -L 3100:127.0.0.1:3100 paperclip@<SERVER_IP>
سجّل الدخول باستخدام البيانات المخزّنة على الخادم في:
/root/.cloudzy-creds
انتقل إلى http://127.0.0.1:3100 في متصفحك المحلي للوصول إلى واجهة Paperclip.
تأكد من تشغيل Paperclip على الخادم، وإلا لن تكون واجهة المستخدم ولا 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لاحقاً عند إجراء التغييرات
