الاستخدام
0.SSH في الخادم
اتصل بالخادم الخاص بك كجذر:
ssh root@<SERVER_IP>
قم بتسجيل الدخول باستخدام كلمة المرور الخاصة بك.
1. قم بالتبديل إلى مستخدم التطبيق
يجب أن تعمل جميع عمليات مشبك الورق تحت المستخدم المخصص:
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 - واجهة المستخدم →
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. الوصول إلى واجهة المستخدم بشكل آمن (نفق 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الأوامر كجذر (يتم تشغيلها دائمًا ضمنpaperclipمستخدم) - ال
paperclipيتم تخزين بيانات اعتماد المستخدم بشكل آمن في/root/.cloudzy-creds - يمكنك أيضًا تسجيل الدخول مباشرة باسم
paperclipالمستخدم باستخدام SSH:ssh paperclip@<SERVER_IP> - عند تسجيل الدخول كجذر، قم دائمًا بالتبديل إلى مستخدم التطبيق قبل تشغيل أي أوامر Paperclip:
su - paperclip - يجري
onboardفقط في الإعداد الأول - يستخدم
configureفي وقت لاحق للتغييرات
