در پایان این راهنما یک گردش کار زنده خواهید داشت که هر روز سر ساعت مشخصی خودش اجرا میشود، دادهای را میخواند و نتیجه را جایی میفرستد — بدون اینکه کسی دکمهای بزند. ساختن اولین گردش کار حدود بیست دقیقه طول میکشد و به هیچ خط برنامهنویسی احتیاج ندارد.
این نوشته ادامهی نصب n8n روی سرور ایران است. اگر هنوز نصبش نکردهاید، اول آن را انجام دهید.
چهار واژه که باید بدانید
کل این ابزار روی چهار مفهوم ساده ایستاده است. اگر این چهار تا را بفهمید، بقیهاش فقط کلیک است.
| واژه | یعنی چه | مثال |
|---|---|---|
| گردش کار (Workflow) | کل یک کار خودکار، از اول تا آخر | «هر صبح گزارش فروش دیروز را بفرست» |
| گره (Node) | یک قدم داخل آن کار | «از پایگاه داده بخوان»، «ایمیل بفرست» |
| محرک (Trigger) | اولین گره؛ تعیین میکند کار کی شروع شود | ساعت هفت صبح، یا رسیدن یک درخواست |
| اجرا (Execution) | یک بار دویدن کامل گردش کار | اجرای امروز صبح، با نتیجهاش |
هر گردش کار دقیقاً یک محرک دارد و بعد از آن هر تعداد گره. گرهها با خط به هم وصل میشوند و داده از چپ به راست در آنها جریان پیدا میکند.
گام ۱: گردش کار تازه بسازید
کجا: صفحهی اصلی n8n، بخش گردش کارها.
چه کنید: دکمهی ساختن گردش کار تازه را بزنید.
چه میبینید: بوم خالی باز میشود با یک مربع نقطهچین وسطش که از شما اولین قدم را میخواهد.
اگر نه: اگر دکمه هیچ کاری نکرد، صفحه را دوباره بار کنید و بلافاصله بزنید. این یک ایراد شناختهشدهی رابط است: روی صفحهای که مدتی باز مانده، دکمه بیصدا کار نمیکند و در کنسول مرورگر خطایی دربارهی بارگذاری نشدن بوم ثبت میشود.
گام ۲: محرک را انتخاب کنید
کجا: همان مربع وسط بوم.
چه کنید: رویش بزنید و از فهرستی که باز میشود محرک زمانی را انتخاب کنید. برای شروع، زمانبندی سادهترین است چون برای آزمودنش به هیچ سرویس بیرونی احتیاج ندارید.
چه میبینید: گرهای روی بوم مینشیند و پنجرهای باز میشود که میپرسد هر چند وقت یک بار اجرا شود.
اگر نه: اگر فهرست خالی آمد، صفحه را دوباره بار کنید.
برای آزمودن، فاصلهی زمانی را کوتاه نگذارید. وسوسه میشوید هر دقیقه بگذارید تا زود نتیجه ببینید؛ ولی بعد یادتان میرود و گردش کار ناقص هر دقیقه روی سرور میدود. آزمون دستی گام ۵ همین کار را بدون زمانبندی میکند.
گام ۳: گره کار را اضافه کنید
کجا: علامت مثبت کنار گره محرک.
چه کنید: رویش بزنید و سرویسی را که میخواهید انتخاب کنید. برای اولین بار یک گره ساده بردارید که چیزی را از جایی میخواند — مثلاً یک درخواست وب ساده یا یک برگه.
چه میبینید: گره دوم با یک خط به محرک وصل میشود.
اگر نه: اگر گره وصل نشد، خط را دستی از گوشهی گره اول به گره دوم بکشید.
زیر هر گره که به یک سرویس بیرونی وصل میشود، از شما شناسهی ورود میخواهد. آن شناسه در خود n8n رمز میشود و با همان کلیدی که هنگام نصب ساختید نگه داشته میشود.
گام ۴: تصمیم را اضافه کنید
کجا: باز هم علامت مثبت، این بار بعد از گره دوم.
چه کنید: گره شرط را اضافه کنید و شرطتان را بنویسید. مثلاً «اگر شمار ردیفهای تازه بیشتر از صفر بود».
چه میبینید: گره شرط دو خروجی دارد، یکی برای درست و یکی برای نادرست.
اگر نه: اگر هر دو خروجی خالی ماندند، یعنی گره قبلی هنوز دادهای ندیده است. اول گام ۵ را بزنید و بعد برگردید.
این گره همان چیزی است که گردش کار را از یک زنجیرهی کور به یک کار هوشمند تبدیل میکند. بدون آن، هر روز گزارشی میگیرید حتی وقتی هیچ اتفاقی نیفتاده است.
گام ۵: دستی اجرایش کنید
کجا: دکمهی اجرای آزمایشی، پایین بوم.
چه کنید: بزنیدش. گردش کار همان لحظه یک بار میدود، بدون اینکه منتظر ساعت زمانبندی بماند.
چه میبینید: هر گره که تمام شد یک علامت سبز میگیرد و شمار ردیفهایی که از آن رد شدهاند کنارش میآید. روی هر گره بزنید تا دادهی واقعیاش را ببینید.
اگر نه: گره قرمز یعنی خطا. رویش بزنید؛ پیام خطا داخل خودش نوشته شده است.
همین صفحهی دادهی هر گره مهمترین ابزار عیبیابی شماست. پیش از اینکه دنبال علت بگردید، ببینید گره قبلی واقعاً چه چیزی تحویل داده است. بیشتر خطاها از این میآیند که گره دوم انتظار داشته چیزی بگیرد که گره اول نفرستاده.
گام ۶: منتشرش کنید
کجا: دکمهی `Publish` گوشهی بالای صفحه.
چه کنید: بزنیدش.
چه میبینید: پیامی میآید که گردش کار از این به بعد خودش اجرا میشود.
اگر نه: اگر نشد، معمولاً یعنی یکی از گرهها تنظیم ناقص دارد. همان گره علامت میگیرد.
تا وقتی این دکمه زده نشده، زمانبندی اجرا نمیشود. اجرای دستی گام ۵ کار میکند و آدم خیال میکند همه چیز روبهراه است، ولی گردش کار منتشرنشده سر ساعت نمیدود. خود n8n هم همین را در هشدار نارنجی تنظیمات محرک نوشته است.
⚠ در نسخههای قدیمیتر این دکمه «فعالسازی» نام داشت. اگر راهنمای دیگری دیدید که از آن واژه استفاده کرده، منظورش همین دکمه است.
مثال دوم: وقتی کار از بیرون شروع میشود
محرک زمانی برای کارهای دورهای خوب است. ولی خیلی وقتها میخواهید کار وقتی شروع شود که اتفاقی بیفتد — سفارشی ثبت شود، فرمی پر شود، پیامی برسد.
برای این حالت محرک را روی دریافت درخواست وب بگذارید. n8n یک نشانی یکتا به شما میدهد که هر کسی آن را صدا بزند، گردش کار یک بار میدود. نشانی به این شکل است:
https://<نشانی n8n شما>/webhook/<نام مسیر>
همان نشانی را در تنظیمات فروشگاه یا فرم یا هر سامانهی دیگری میگذارید. ⚠ این نشانی عمومی است، پس نامش را حدسنزدنی بگذارید و هر دادهای که میرسد را پیش از استفاده بسنجید.
از کجا بفهمید درست شد
- اجرای دستی سبز شد و روی هر گره دادهی واقعی دیدید، نه خالی.
- گردش کار منتشر شده است و صفحهی گردش کارها آن را فعال نشان میدهد.
- صبح روز بعد، صفحهی اجراها ردیف دارد. این تنها سنجشی است که ثابت میکند زمانبندی هم کار میکند، و بقیهی سنجشها جایش را نمیگیرند.
آن صفحهی اجراها را روز اول دو بار نگاه کنید. گردش کاری که خطا میدهد بیصدا خطا میدهد و خودش به کسی خبر نمیدهد.
عیبیابی
| نشانه | علت | چاره |
|---|---|---|
| اجرای دستی کار میکند ولی خودکار نه | گردش کار منتشر نشده است | دکمهی Publish گوشهی بالا را بزنید |
| گره قرمز با پیام دسترسی | شناسهی ورود سرویس غلط یا منقضی است | در بخش شناسهها دوباره واردش کنید و همانجا بسنجیدش |
| گره سبز است ولی هیچ ردیفی رد نشده | گره قبلی دادهای نفرستاده | روی گره قبلی بزنید و خروجی واقعیاش را ببینید |
| نتیجهی اجرا روی صفحه زنده نمیشود | مسیر وبسوکت از وبسرور رد نشده | پیکربندی پروکسی را بسنجید؛ در راهنمای نصب آمده است |
| گردش کار روی سرور کند است | سقف پردازنده پایین است یا سرور یک هسته دارد | سقف را بالا ببرید یا هسته اضافه کنید |
| درخواست وب جواب نمیگیرد | گردش کار منتشر نشده، یا نام مسیر فرق دارد | نشانی را از خود گره محرک کپی کنید، دستی ننویسید |
محدودیتها
- سرویسهای بسته همچنان بستهاند. اگر سرور شما به سرویسی نمیرسد، گردش کار هم نمیرسد.
- هر اجرا روی دیسک میماند. تاریخچهی اجراها بزرگ میشود؛ در راهنمای نصب تنظیمی هست که اجراهای کهنه را خودش پاک میکند.
- یک هسته یعنی یکی در لحظه. گردش کارهای همزمان پشت هم صف میکشند.
- دستیار هوش مصنوعی اختیاری است و کلید جدا و پولی میخواهد. همهی کارهای این نوشته بدون آن انجام میشوند.
و یک عادت که از روز اول ارزش دارد: هر گردش کار را با نامی بسازید که بگوید چه میکند و هر چند وقت یک بار. شش ماه بعد که بیست گردش کار دارید، نام «گردش کار ۳» هیچ چیزی به شما نمیگوید.
پرسشهای پرتکرار
گردش کار در n8n یعنی چه؟
تفاوت محرک و گره چیست؟
ساختن اولین گردش کار چقدر طول میکشد؟
چرا گردش کار من سر ساعت اجرا نمیشود؟
دکمهی ساختن گردش کار کار نمیکند، چه کنم؟
چطور بفهمم گردش کار واقعاً کار میکند؟
گره سبز است ولی هیچ ردیفی رد نشده، یعنی چه؟
برای شروع کار با n8n به دستیار هوش مصنوعی احتیاج هست؟
نظرها
نظرها در حالِ بار شدن است…