نصب نود بله در n8n

n8n علاوه بر نودهای اصلی، از Community Node‌ها هم پشتیبانی می‌کند؛ نودهایی که جامعه کاربران n8n ساخته و در قالب پکیج npm منتشر کرده‌اند و از داخل خود n8n نصب می‌شوند. نود بله (Bale) یکی از همین Community Node‌هاست و امکان ارسال و دریافت پیام از طریق پیام‌رسان بله را به جریان‌داده اضافه می‌کند.

در صورت Air-Gapped اجرا شدن n8n، دسترسی مستقیمی به رجیستری عمومی npm (registry.npmjs.org) وجود ندارد. به همین دلیل، پیش از نصب هر Community Node از جمله نود بله، متغیر محیطی معرفی‌شده در ادامه باید به تنظیمات سرویس اضافه شود تا n8n پکیج را از رجیستری در دسترس دریافت کند.

Community Nodeها بخشی از هسته n8n نیستند و کد آن‌ها داخل فرایند n8n اجرا می‌شود. پیش از استفاده در محیط Production، منبع پکیج، مجوزها وابستگی‌ها، سابقه انتشار و شیوه نگه‌داری آن بررسی می‌شوند.

---

رجیستری داخلی

این تنظیم از طریق کنسول هم‌روش و در صفحه سرویس n8n انجام می‌شود:

1. کنسول هم‌روش و صفحه سرویس n8n باز می‌شود.
2. به تنظیمات سرویس و بخش متغیرهای محیطی (Environment Variables) مراجعه می‌شود.
3. متغیر زیر اضافه می‌شود:

N8N_COMMUNITY_PACKAGES_REGISTRY=https://repo.hmirror.ir/npm

4. با کلیک روی دکمه «اعمال تغییرات»، تنظیمات ذخیره می‌شود.

این متغیر، رجیستری npm مورد استفاده n8n برای نصب Community Node‌ها را از رجیستری پیش‌فرض (registry.npmjs.org) به repo.hmirror.ir تغییر می‌دهد که از داخل سرویس n8n هم‌روش در دسترس است. بدون این تنظیم، نصب هر Community Node با خطای عدم دسترسی به رجیستری مواجه می‌شود.

---

نصب نود بله (Bale)

پس از تنظیم رجیستری، نصب نود از داخل خود n8n انجام می‌شود:

1. پنل n8n باز می‌شود.
2. به بخش Settings > Community Nodes مراجعه می‌شود.
3. روی دکمه Install a community node کلیک می‌شود.
4. نام پکیج n8n-nodes-bale-messenger-alpha وارد و نصب آن تایید می‌شود.

پس از نصب موفق، نود بله در فهرست نودهای قابل استفاده در جریان‌داده‌ها در دسترس قرار می‌گیرد.

---

عیب‌یابی (Troubleshooting)

خطای Cannot find module 'axios' هنگام بارگذاری نود

اگر پس از نصب، هنگام بارگذاری نود بله خطای زیر رخ دهد:

Error loading package "n8n-nodes-bale-messenger-alpha": The specified package could not be loaded
Cause: Cannot find module 'axios'
Require stack:
...

این خطا یعنی وابستگی axios که نود بله برای اجرا به آن نیاز دارد، به‌صورت خودکار نصب نشده است. برای رفع آن:

1. از طریق تب ترمینال سرویس n8n در کنسول هم‌روش، به ترمینال کانتینر n8n دسترسی گرفته می‌شود.
2. به مسیر نصب نود مراجعه می‌شود:

cd /home/node/.n8n/.n8n/nodes

3. پکیج axios به‌صورت دستی نصب می‌شود:

npm install axios@1 --save

4. با دستور زیر از نصب صحیح axios اطمینان حاصل می‌شود؛ اگر مسیر فایل axios بازگردانده شود، مشکل رفع شده است:

node -e "console.log(require.resolve('axios'))"

این روش مخصوص axios نیست. اگر هنگام نصب سایر Community Node‌ها هم خطای مشابه «Cannot find module» رخ دهد، به‌جای axios، نام همان ماژول گمشده در همین مسیر نصب می‌شود.