صفحه‌ی افزونه‌ها
افزونه برنامه‌ای جداست که کنار پنل کار می‌کند: یک فروشگاه، یک اعلان‌رسان، یک بات از خودتان. در کانتینر یا سرویس خودش اجرا می‌شود، با رابط و دیتابیس خودش، و از راه شبکه به پنل می‌رسد. پنل هرگز کد افزونه را اجرا نمی‌کند و هرگز صفحه‌هایش را درون صفحه‌های خودش نشان نمی‌دهد. آنچه نگه می‌دارد همان است که برای کار با افزونه لازم دارد: آدرسش، لینکی به رابطش، یک مسیر سلامت، و دو چیزی که ممکن است به آن داده شود، یک توکن API و یک وب‌هوک. این صفحه زیر سرویس‌ها ← افزونه‌ها است و مدیران اصلی به آن دسترسی دارند.
برای اینکه چه افزونه‌هایی وجود دارد، ببینید افزونه‌ها. برای اولین نصب از ابتدا تا انتها، ببینید نصب افزونه.
دو زبانه
- ثبت‌شده: افزونه‌هایی که این پنل با آن‌ها کار می‌کند، و هر نصبی که هنوز منتظر جواب افزونه است.
- مرور: فهرست افزونه‌ها در addons.nexora-panel.org، که روزی یک بار و هر وقت خواندن الان را بزنید خوانده می‌شود. هر افزونه آنجا رسمی، تأییدشده یا غیررسمی است؛ معنای این سطح‌ها، و اینکه چطور با تغییر منبع پنل را به یک آینه اشاره دهید، در دایرکتوری افزونه‌ها آمده است.
وقتی فهرست نسخه‌ی تازه‌تری از افزونه‌ای که دارید داشته باشد، منوی افزونه‌ها یک نقطه می‌گیرد.
نصب از فهرست
در مرور، یک افزونه را انتخاب کنید و نصب را بزنید. فرم از توضیح خود افزونه ساخته می‌شود و این‌ها را می‌پرسد:
- چه کسی اجرا می‌کند: خودم دستور را اجرا می‌کنم، پنل، با SSH، یا پنل، روی همین سرور (وقتی پنل مستقیم روی یک سرور لینوکس اجرا می‌شود و نه در Docker، پیشنهاد می‌شود).
- روش: به‌صورت سرویس، با Docker یا فایل compose.
- آدرسی که پنل به آن می‌رسد و آدرسی که افزونه به پنل می‌رسد.
- سؤال‌های آن: یک پورت، یک رمز، پاسخ HTTPS، و هر چیز دیگری که افزونه اعلام کند.
با خودم دستور را اجرا می‌کنم، ساختن دستور یک دستور می‌دهد که باید با کاربر root روی سرور افزونه اجرا شود؛ دستوری که رازی را که تایپ کرده‌اید دارد فقط یک بار نشان داده می‌شود. با SSH یا روی همین سرور، نصب آن را اجرا می‌کند و لاگ را زنده نشان می‌دهد. در هر حال پنل سپس منتظر می‌ماند تا افزونه در آدرسش پاسخ دهد، آنچه را درخواست می‌کند نشان می‌دهد، و وقتی تأیید و ثبت را بزنید ثبتش می‌کند. در این فاصله می‌توانید فرم را ببندید و با ادامه برگردید. نصب افزونه همه‌ی انتخاب‌ها را قدم‌به‌قدم توضیح می‌دهد.
ثبت افزونه‌ای که از قبل اجرا می‌شود
افزونه‌ی امضاشده، با کد ادعا
افزونه‌ای که از راه فهرست منتشر شده توضیحی امضاشده از خودش دارد. برای ثبت افزونه‌ای که خودتان اجرا کرده‌اید:
- افزونه را اجرا کنید. یک کد ادعای یک‌بارمصرف در لاگ یا صفحه‌ی خودش نشان می‌دهد.
- ثبت افزونهٔ امضاشده را بزنید، آدرس افزونه را تایپ کنید و خواندن را بزنید.
- پنل توضیح افزونه را می‌خواند، امضایش را بررسی می‌کند و آنچه را درخواست می‌کند نشان می‌دهد: هر دسترسی توکنش با دلیلش، نرخ درخواستی که می‌خواهد، و هر رویدادی که وب‌هوکش باید بشنود. آن را بخوانید. افزونه‌ی غیررسمی هشداری دارد که نکسورا آن را بازبینی نکرده است.
- کد ادعا را تایپ کنید و تأیید و ثبت را بزنید.
پنل دقیقاً همان توکن و وب‌هوک را می‌سازد و به افزونه می‌دهد، که فقط با کد خودش آن‌ها را می‌پذیرد. کد اشتباه هیچ چیزی به جا نمی‌گذارد. پیش از تأیید شما هیچ چیزی ساخته نمی‌شود.
توکن افزونه به مالک پنل وابسته است و اگر مالکیت واگذار شود همراه آن منتقل می‌شود (ببینید ادمین‌ها).
افزونه‌ی خودتان، به‌صورت دستی
باتی یا اسکریپتی که خودتان اجرا می‌کنید با افزودن افزونهٔ خودتان اضافه می‌شود:
| فیلد | |
|---|---|
| نام | |
| شناسهٔ افزونه | یک شناسه‌ی کوتاه (a-z، 0-9، _، -)؛ اگر خالی باشد از نام گرفته می‌شود، و پس از ثبت ثابت است |
| آدرس | جایی که پنل به آن می‌رسد |
| لینک ورود | جایی که رابط خودش است: یک مسیر زیر آدرس، یا یک URL کامل |
| سلامت | مسیری که پنل می‌تواند بررسی کند؛ خالی یعنی بدون بررسی |
| توکن API | روشنش کنید و دسترسی‌هایش را انتخاب کنید |
| وب‌هوک | روشنش کنید، یک مسیر زیر آدرس یا یک URL کامل بدهید و رویدادها را انتخاب کنید |
افزونه به توکن، وب‌هوک یا هر دو نیاز دارد. ذخیره، توکن و کلید امضای وب‌هوک را یک بار نشان می‌دهد: آن‌ها را در تنظیمات برنامه‌تان بگذارید. همین فرم بعداً ویرایششان می‌کند.
آدرس
http:// ساده فقط برای افزونه‌ای روی همین سرور، یک شبکه‌ی خصوصی یا یک شبکه‌ی Docker پذیرفته می‌شود. هر جای دیگر باید https:// با گواهی‌ای باشد که پنل به آن اعتماد دارد، چون توکن افزونه به آنجا فرستاده می‌شود.
فهرست ثبت‌شده‌ها
هر ردیف نام و نسخه‌ی افزونه، اینکه امضاشده (و توسط چه کسی) یا شخصی است، وضعیتش، دسترسی‌هایش و آخرین زمان استفاده از توکنش را نشان می‌دهد. وضعیت یکی از این‌هاست:
| وضعیت | معنی |
|---|---|
| ثبت‌شده | عادی کار می‌کند |
| معلق | شما متوقفش کرده‌اید (پایین‌تر) |
| ناسالم | مسیر سلامتش دو بار پشت سر هم شکست خورده |
منوی ردیف کارهایی را که می‌توانید با آن بکنید دارد:
- باز کردن: رابط خود افزونه، در یک زبانه‌ی تازه.
- لینک ورود (افزونه‌های امضاشده) یا ویرایش (افزونه‌های خودتان).
- بررسی به‌روزرسانی (افزونه‌های امضاشده).
- بررسی به‌روزرسانی، وقتی یکی منتظر است.
- گواهی.
- آپدیت روی سرورش و حذف از سرورش، برای افزونه‌ای که پنل با SSH یا روی همین سرور نصب کرده.
- تعلیق یا ازسرگیری.
- حذف.
لینک ورود
آدرسی که ثبت می‌کنید جایی است که پنل به افزونه می‌رسد. با Docker این اغلب نام کانتینری است که مرورگرتان نمی‌تواند باز کند. لینک ورود آدرسی را تعیین می‌کند که مرورگرتان برای باز کردن استفاده می‌کند؛ خالی از آدرسی استفاده می‌کند که افزونه اعلام می‌کند، و نسخه‌ی تازه‌تر افزونه آدرس شما را نگه می‌دارد.
سلامت
وقتی افزونه مسیر سلامت دارد، پنل هر دقیقه از آن می‌پرسد؛ 200 یعنی سالم. دو پرسش ناموفق پشت سر هم آن را ناسالم می‌کند، با آخرین خطا روی صفحه، و یک بار panel.addon_unhealthy ایجاد می‌کند. 200 بعدی آن را برمی‌گرداند و panel.addon_recovered ایجاد می‌کند. از افزونه‌ای که مسیر سلامت ندارد هرگز پرسیده نمی‌شود. برای باخبر شدن، این دو رویداد را به تلگرام یا ایمیل بفرستید (ببینید تلگرام).
تعلیق
تعلیق افزونه را بدون حذف متوقف می‌کند: توکنش همان لحظه از کار می‌افتد و وب‌هوکش دیگر دریافت نمی‌کند. رویدادهایی که در زمان تعلیق ایجاد می‌شوند برایش نگه داشته نمی‌شوند. سلامت افزونه‌ی معلق پرسیده نمی‌شود. ازسرگیری هر دو را برمی‌گرداند.
به‌روزرسانی‌ها و تأیید
پنل توضیح افزونه‌ی امضاشده را هر ساعت، و هر وقت بررسی به‌روزرسانی را بزنید، دوباره می‌خواند:
- نسخه‌ی تازه‌ای که چیزی بیش از آنچه افزونه از قبل دارد نمی‌خواهد خودبه‌خود اعمال می‌شود.
- نسخه‌ی تازه‌ای که دسترسی بیشتر، رویداد بیشتر یا نرخ درخواست بالاتری می‌خواهد منتظر می‌ماند. افزونه دقیقاً همان چیزی را که دارد نگه می‌دارد، ردیف به‌روزرسانی … منتظر است را نشان می‌دهد، و
panel.addon_update_waitingیک بار ایجاد می‌شود. بررسی به‌روزرسانی فقط چیزهایی را که اضافه می‌کند، هر کدام با دلیلش، فهرست می‌کند تا تأیید کنید. - به‌روزرسانی‌ای که توکن یا وب‌هوکی می‌خواهد که افزونه هرگز نداشته، در جا قابل تأیید نیست: افزونه را حذف کنید و دوباره ثبتش کنید.
نصب خود نسخه‌ی تازه جایی انجام می‌شود که افزونه اجرا می‌شود: آپدیت روی سرورش برای افزونه‌ای که پنل نصب کرده، یا اجرای دوباره‌ی دستور نصبش روی سرورش. نصب افزونه دستورها را دارد.
گواهی از پنل
افزونه‌ای که پاسخ HTTPS آن panel است، آدرس عمومی‌اش را با گواهی‌ای از مخزن خود پنل سرو می‌کند، پس نه به گواهی جداگانه نیاز دارد و نه به پورت ۴۴۳. پنل آن را صادر و تمدید می‌کند؛ افزونه خودش آن را می‌گیرد. گواهی روی ردیف آن را انتخاب یا عوض می‌کند. برای افزونه‌ای روی سرور دیگر فقط گواهی‌های صادرشده با dns-01، گواهی‌های خودامضا و گواهی‌های بارگذاری‌شده پیشنهاد می‌شوند، و هرگز گواهی HTTPS خود پنل. برای مخزن، ببینید گواهی‌ها.
افزونه‌ای که گواهی خودامضای خودش را سرو می‌کند، اثر انگشت SHA-256 آن را در صفحه‌ی رضایت نشان می‌دهد؛ پیش از تأیید، آن را با اثر انگشتی که صفحه‌ی راه‌اندازی خود افزونه نشان می‌دهد مقایسه کنید. وقتی افزونه آن را تمدید کند، سلامتش شکست می‌خورد چون پنل دیگر به آن اعتماد ندارد: گواهی را باز کنید، آنچه الان سرو می‌کند را مقایسه کنید و اعتماد به این گواهی را بزنید.
حذف
حذف اول با panel.addon_removed به افزونه خبر می‌دهد، سپس توکن و وب‌هوکش را حذف می‌کند. آنچه افزونه در دیتابیس خودش نگه داشته می‌ماند، پس ثبت دوباره آن را پیدا می‌کند.
حذف از سرورش افزونه‌ای را که پنل نصب کرده حذف نصب می‌کند: برای حذف پوشه‌ی داده‌هایش هم داده‌هایش هم پاک شود را تیک بزنید، که برگشت‌پذیر نیست. افزونه تا وقتی اینجا حذف را هم نزنید ثبت‌شده می‌ماند.
در صفحه‌های دیگر
توکن و وب‌هوک افزونه در توکن‌های API و وب‌هوک‌ها و رویدادها هم دیده می‌شوند، با برچسب افزونه: name. آنجا قابل ویرایش یا حذف نیستند، فقط اینجا.
مرتبط
- نصب افزونه: نصب یک افزونه قدم‌به‌قدم.
- دایرکتوری افزونه‌ها: فهرست افزونه‌ها و سطح‌هایش.
- پلتفرم افزونه: ثبت و بررسی‌هایش چطور کار می‌کنند.
- فهرست رویدادها: رویدادهای
panel.addon_*.