n8n: Пълно Ръководство за Workflow Автоматизация 2026 за български бизнес

Това ръководство е писано за български МСП и разработчици, които искат self-hosted автоматизация без vendor lock-in. Нека бъдем честни:

Повечето инструменти за автоматизация ви заключват. Месечни такси, които растат с употребата. Данни, заседнали в чужд cloud. Нулев контрол над случващото се под капака.

n8n обръща сценария.

Това е платформа за workflow автоматизация, която можете да self-host-нете (безплатно) или да пуснете в cloud. Получавате 400+ интеграции, пълен достъп до код когато ви трябва, и пълна собственост над данните си.

В това ръководство ще научите всичко за n8n: от “какво е това” до production workflows, които обработват хиляди executions дневно.

Без излишни приказки. Без теоретични лекции. Само това, което работи.

Какво е n8n? Платформата за 2 минути

n8n (произнася се “н-осем-н”) свързва приложенията ви и автоматизира workflows. Като Zapier—но вие притежавате всичко.

Кой използва n8n сега?

• Ops екипи — премахват ръчното copy-paste между инструменти
• Growth & маркетинг — синхронизират leads, тригерват кампании, обогатяват данни
• Developers — строят вътрешни инструменти без да вдигат цял backend
• Data екипи — lightweight ETL без сложността на Airflow

Защо екипите сменят Zapier/Make

Три причини се повтарят постоянно:

1. Цената става реална при мащаб

Zapier таксува на “task.” Пускаш 10,000 tasks/месец? Това са $400+. На n8n self-hosted същият обем струва ~$20 за сървър.

2. “Трябва ми истински код тук”

Code стъпките на Zapier са sandboxed. n8n дава пълен JavaScript/Python достъп. Трябва да извикаш вътрешен API? Да parse-неш странен XML? Да loop-неш през 500 items? Няма проблем.

3. Данните не могат да напускат сървърите ни

Здравеопазване, финанси, право—някои индустрии не могат да изпращат данни през third-party clouds. n8n self-hosted работи 100% на вашата инфраструктура.

Компромисът: n8n има learning curve. UI-то е мощно, но плътно. Отделете си 2-3 часа да свикнете. След това ще се чудите как сте живели без него.

Реални Use Cases (Откраднете Тези Идеи)

Ето какво екипите реално строят с n8n. Не теория—работещи автоматизации, които можете да репликирате.

Pro tip: Започнете с ЕДИН workflow. Пуснете го в production. След това разширявайте. Повечето провалени n8n проекти се опитват да автоматизират всичко наведнъж.

n8n за Български Бизнеси: Реални Workflow-и с Локални Инструменти

Горните примери са универсални. Но реалната стойност за един български бизнес идва, когато n8n свърже инструментите, които вече използвате всеки ден — касовия софтуер, куриера, онлайн магазина. Това са интеграции, които ние реално изграждаме за клиенти в България.

Защо локалните интеграции са ключови: Speedy, Econt, Microinvest, myPOS/ePay и WooCommerce са гръбнакът на повечето български малки бизнеси. Глобалните no-code инструменти рядко ги поддържат добре. С n8n (чрез готови nodes или HTTP заявки към техните API-та) свързвате точно вашия стек — без да сменяте софтуера, който екипът ви вече познава.

Основни Концепции (Знайте Това Преди да Строите)

Преди да построите първия си workflow, усвоете тези четири концепции. Прескочите ли тази секция, ще загубите часове в дебъгване на проблеми, които нямат нищо общо с логиката ви.

Workflows, Nodes, Triggers, Executions

Workflow = вашата автоматизация. Платно, където свързвате nodes, които правят неща.

Node = една стъпка във вашата автоматизация. Всеки node изпълнява едно действие: изпрати email, query-ни база данни, трансформирай данни, извикай API.

Trigger = node-ът, който стартира вашия workflow. Два типа:

• Webhook triggers чакат входящ HTTP request (form submission, Stripe event, custom call)
• App triggers poll-ват или слушат приложение (нов Gmail, ново Slack съобщение, нов ред в Airtable)

Execution = едно изпълнение на вашия workflow от начало до край. n8n логва всяка execution, за да можете да дебъгвате, replay-вате, или одитирате по-късно.

Ментален модел: Мислете за това като рецепта. Workflow-то е рецептата. Nodes са стъпките. Trigger-ът е това, което ви кара да започнете да готвите (глад, вечеря за гости, и т.н.). Всеки път, когато готвите = една execution.

Data Flow: Items, JSON, и Mapping

Тук n8n става мощен—и тук повечето начинаещи се забиват.

Всичко в n8n е JSON. Когато node се изпълни, той връща данни като JSON обекти. Следващият node получава тези данни и може да ги използва.

Items = индивидуални парчета данни, протичащи през вашия workflow. Ако query-нете база данни и получите 50 реда, имате 50 items. Всеки item преминава през следващите nodes.

Mapping = взимане на данни от предишни nodes в текущия. Вместо да hardcode-вате стойности, ги референцирате: {{ $json.email }} взима полето email от входящите данни.

// Пример: входящи данни от webhook
{
  "name": "Иван",
  "email": "ivan@example.com",
  "company": "Acme ООД"
}

// Референция в следващия node
{{ $json.name }}  → "Иван"
{{ $json.email }} → "ivan@example.com"

Ключовият insight: Данните текат отляво надясно. Всеки node трансформира или route-ва items. Ако нещо е грешно, проверете какви данни реално пристигат на всяка стъпка (n8n показва това в execution log-а).

Credentials: Свържете Приложения Без да Разкривате Secrets

Credentials съхраняват вашите API keys, OAuth tokens, и пароли. Създавате ги веднъж, след това ги преизползвате във workflows.

Защо е важно:

• Secrets са криптирани at rest
• Не copy-paste-вате API keys във всеки workflow
• Промяна на credential обновява всички workflows, които го използват
• Членове на екипа могат да използват credentials без да виждат реалните стойности

Често срещани типове credentials:

• API Key — прост key/secret чифт
• OAuth2 — пренасочва към приложението за оторизация (Google, Slack, HubSpot)
• Basic Auth — username/password
• Header Auth — custom headers за APIs, които не пасват на други patterns

Бележка за сигурност: На self-hosted n8n, credentials са криптирани с вашия N8N_ENCRYPTION_KEY. Загубите ли този key = загубвате достъп до всички съхранени credentials. Направете backup.

Environments: Dev vs Prod, Versions, Export/Import

n8n няма вградено разделяне на среди. Но ви трябва. Ето как екипите се справят:

Опция 1: Отделни инстанции
Пуснете две n8n инсталации—една за development, една за production. Build-вайте и тествайте в dev, след това export-нете workflow JSON и import-нете в prod.

Опция 2: Workflow tags + naming conventions
Prefix-вайте имената на workflows: [DEV] Lead enrichment vs [PROD] Lead enrichment. Не е идеално, но работи за малки екипи.

Опция 3: Git-based version control (препоръчително)
Export-вайте workflows като JSON, съхранявайте в Git. Следете промените, review-вайте преди deploy, rollback-вайте ако е нужно. Така сериозните екипи управляват n8n at scale.

Export/Import workflow:

1. В n8n изберете workflow → Download → записва като .json
2. Commit-нете в Git с описателен message
3. На prod инстанцията: Import → upload-нете JSON
4. Активирайте workflow-то

Внимавайте за: Credentials не се export-ват. След import на workflow, ще трябва да свържете отново credentials на новата инстанция.

Cloud vs Self-Hosted: Кое е Правилно за Вас?

Имате два пътя. И двата работят. Правилният избор зависи от вашите ограничения, не от това кое е “по-добро.”

Изберете n8n Cloud ако…

• Искате да започнете днес. Регистрирайте се, стройте, deploy-вайте. Без server setup, без Docker, без поддръжка.
• Екипът ви не е технически. Cloud се грижи за updates, backups, SSL, scaling. Вие се фокусирате върху workflows.
• Имате нужда от collaboration features. Множество потребители, споделени credentials, workflow permissions—вградени.
• Бюджетът е предвидим. Плащате на execution. Знаете разходите предварително.

Cloud има смисъл за: маркетинг екипи, малки ops екипи, агенции, всеки, който цени скоростта над контрола.

Изберете Self-Hosted ако…

• Данните не могат да напускат инфраструктурата ви. Здравеопазване, финанси, право—compliance често изисква on-prem.
• Нуждаете се от достъп до вътрешна мрежа. Свързвайте се с бази данни, APIs, или услуги, които не са exposed в интернет.
• Обемът е висок и бюджетът има значение. При 50,000+ executions/месец, self-hosting струва част от цената на Cloud.
• Искате пълен контрол. Custom домейни, собствена backup стратегия, специфични n8n версии, без vendor зависимост.

Self-hosted има смисъл за: dev екипи, компании с infra capabilities, регулирани индустрии, high-volume use cases.

GDPR & ЗЗЛД: защо self-hosting на сървър в ЕС е силен аргумент. Когато self-host-вате n8n на сървър, разположен в ЕС (напр. Hetzner или DigitalOcean с дата център във Франкфурт/Амстердам), личните данни на клиентите ви — имейли, телефони, поръчки — никога не напускат вашата инфраструктура и остават в рамките на Съюза. Това опростява съответствието с Регламент (ЕС) 2016/679 (GDPR) и българския Закон за защита на личните данни (ЗЗЛД): няма прехвърляне на данни към трета страна, имате пълен контрол над достъпа и можете да докажете къде физически се съхраняват данните. Важно: ползата идва от ЕС локацията — изберете сървър в ЕС, не произволен регион.

Checklist за Решение

Задайте си тези пет въпроса:

Все още не сте сигурни? Започнете с Cloud. Винаги можете да мигрирате към self-hosted по-късно—workflows се експортват като JSON, така че нищо не е заключено.

Реалност за цените (2026): Cloud вече няма безплатен план — само 14-дневен trial без карта. Starter е €20/месец (годишно) или €24/месец (месечно) за 2,500 executions; Pro е €50 / €60 за 10,000. Self-hosted остава безплатен — плащате само сървъра (~€5-20/месец в Hetzner, DigitalOcean, или €3-7/месец в managed providers като InstaPods или PikaPods) с неограничени executions и неограничени активни workflows. Виж секцията “Цени” за пълен разбор.

Бърза Инсталация (Препоръчани Пътища)

Пропуснете 47-стъпковите tutorials. Ето как да пуснете n8n за минути.

Локално Тестване (Docker или npm)

Docker (препоръчително) — една команда, готово:

docker run -it --rm --name n8n -p 5678:5678 n8nio/n8n

Отворете http://localhost:5678. Вътре сте.

Данните няма да се запазят след като спрете контейнера. Това е ОК за тестване. За persistence добавете volume:

docker run -it --rm --name n8n -p 5678:5678 \
  -v n8n_data:/home/node/.n8n \
  n8nio/n8n

npm (ако нямате Docker):

npx n8n

Изисква Node.js 18+. Същото: http://localhost:5678.

Production Сървър с Docker Compose

За реални deployments използвайте Docker Compose. Този setup включва PostgreSQL (препоръчва се над SQLite за production) и persistent storage.

Създайте docker-compose.yml:

version: '3.8'

services:
  n8n:
    image: n8nio/n8n
    restart: always
    ports:
      - "5678:5678"
    environment:
      - N8N_HOST=n8n.yourdomain.com
      - N8N_PORT=5678
      - N8N_PROTOCOL=https
      - WEBHOOK_URL=https://n8n.yourdomain.com/
      - DB_TYPE=postgresdb
      - DB_POSTGRESDB_HOST=postgres
      - DB_POSTGRESDB_DATABASE=n8n
      - DB_POSTGRESDB_USER=n8n
      - DB_POSTGRESDB_PASSWORD=${POSTGRES_PASSWORD}
      - N8N_ENCRYPTION_KEY=${N8N_ENCRYPTION_KEY}
    volumes:
      - n8n_data:/home/node/.n8n
    depends_on:
      - postgres

  postgres:
    image: postgres:15
    restart: always
    environment:
      - POSTGRES_USER=n8n
      - POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
      - POSTGRES_DB=n8n
    volumes:
      - postgres_data:/var/lib/postgresql/data

volumes:
  n8n_data:
  postgres_data:

Създайте .env файл (не го commit-вайте):

POSTGRES_PASSWORD=your-secure-password-here
N8N_ENCRYPTION_KEY=your-32-char-encryption-key

Генерирайте правилен encryption key:

openssl rand -hex 16

Стартирайте всичко:

docker compose up -d

Основни Environment Variables

Това са променливите, които наистина имат значение. Пропуснете останалите докато не ви потрябват.

За reverse proxy (Nginx/Traefik): Уверете се, че forward-вате Host header-а и активирате WebSocket proxying. n8n има нужда от двете, за да работи редакторът правилно.

Production checklist:
✅ PostgreSQL вместо SQLite
✅ Encryption key backup-нат сигурно
✅ HTTPS през reverse proxy
✅ Basic auth или SSO активирани
✅ Редовни backups на database + n8n_data volume

Първият Ви Workflow от A до Z

Време е да построим нещо реално. Ще създадем webhook, който получава данни от форма, валидира ги и изпраща Slack нотификация. Класически pattern, безкрайни вариации.

Пример: Webhook → Обработка → Действие

Стъпка 1: Създайте нов workflow

Кликнете “Add workflow” в n8n. Дайте му полезно име: Contact Form → Slack.

Стъпка 2: Добавете Webhook trigger

1. Кликнете бутона +
2. Потърсете “Webhook”
3. Изберете Webhook node
4. Задайте HTTP Method на POST
5. Копирайте “Test URL” (ще ви трябва)

Вашият webhook вече слуша. Изглежда така:
https://your-n8n.com/webhook-test/abc123

Стъпка 3: Тествайте с примерни данни

Изпратете тестова заявка (използвайте curl, Postman, или browser console):

curl -X POST https://your-n8n.com/webhook-test/abc123 \
  -H "Content-Type: application/json" \
  -d '{"name": "Иван", "email": "ivan@example.com", "message": "Здравейте!"}'

Кликнете “Execute workflow” в n8n. Трябва да видите входящите данни в output-а на Webhook node.

Стъпка 4: Добавете валидация (IF node)

1. Добавете IF node след Webhook
2. Условие: {{ $json.email }} → “is not empty”
3. Това създава два клона: true (валиден) и false (невалиден)

Стъпка 5: Изпратете до Slack

1. На “true” клона добавете Slack node
2. Свържете Slack credentials (OAuth2)
3. Изберете канал, съставете съобщение:

Ново запитване от контактна форма!
Име: {{ $json.name }}
Email: {{ $json.email }}
Съобщение: {{ $json.message }}

Стъпка 6: Активирайте

Превключете workflow на “Active.” Test URL-ът става production URL. Готово.

Dev Цикълът в n8n: Тествай, Replay, Активирай

Ето как ще прекарвате повечето време в n8n:

1. Стройте с тестови данни
Използвайте “Execute workflow” за да пуснете с примерни данни. Всеки node показва input/output—кликнете за да инспектирате.

2. Pin-нете данни за итерация
Десен клик на node → “Pin data.” Сега този node винаги връща същите данни докато строите downstream логиката. Огромен time saver.

3. Replay-вайте executions
Отидете на “Executions” таба. Кликнете всяко минало изпълнение за да видите точно какво се е случило. Кликнете “Retry” за да го пуснете отново със същия input.

4. Дебъгвайте с execution log
Нещо се счупи? Execution log-ът показва всеки node, неговия input, output и всякакви грешки. Без гадаене.

5. Активирайте когато е готово
Само активни workflows отговарят на triggers. Дръжте го неактивно докато строите, активирайте когато е тествано.

Pro tip: Използвайте “Execute workflow” с избран webhook node—n8n ще чака входяща заявка, позволявайки ви да тествате с реални данни от вашата форма/приложение.

Best Practices: Naming, Папки, Коментари

Бъдещото ви аз ще ви благодари. Така и колегите ви.

Naming conventions:

• Workflows: [Екип] Действие - Източник → Дестинация
  Примери: [Sales] New Lead - Typeform → HubSpot, [Ops] Daily Report - DB → Slack

• Nodes: Описвайте какво правят, не какво са
  ❌ IF, HTTP Request, Code
  ✅ Провери дали email е валиден, Вземи user от API, Форматирай съобщение

Използвайте папки:

Групирайте workflows по екип, проект или функция. n8n поддържа папки—използвайте ги преди да имате 50 workflows в плосък списък.

Добавяйте sticky notes:

Жълтият sticky note node е документация. Използвайте го за да обясните:

• Защо този workflow съществува
• Какво го тригерва
• Gotchas или edge cases
• Към кого да се обърнат ако се счупи

Коментирайте code nodes:

Ако пишете JavaScript в Code node, коментирайте го. Ще забравите какво прави след 3 месеца.

// Извлечи уникални email домейни от списък с контакти
// Използва се за: lead сегментация по компания
const domains = items.map(item => {
  const email = item.json.email;
  return email.split('@')[1];
});
return [...new Set(domains)].map(d => ({ json: { domain: d } }));

Овладейте Expressions (Супер Силата на n8n)

Expressions са това, което превръща n8n от “свържи две приложения” в “построй каквото и да е.” Щом разберете това, ще автоматизирате неща, които не сте мислили за възможни.

Синтаксис, Редактор, Променливи

Отваряне на expression editor:
Кликнете всяко input поле → кликнете бутона fx (или натиснете /). Сега сте в expression mode.

Основен синтаксис:
Всичко вътре в {{ }} се оценява като JavaScript.

{{ $json.email }}                    // Вземи email от текущия item
{{ $json.name.toUpperCase() }}       // Трансформирай в главни букви
{{ $json.price * 1.2 }}              // Математически операции
{{ $json.items.length }}             // Дължина на масив

Ключови променливи, които ще използвате постоянно:

Достъп до nested данни:

{{ $json.user.address.city }}        // Dot notation
{{ $json["field-with-dashes"] }}     // Bracket notation за специални символи
{{ $json.items[0].name }}            // Array достъп

Tournament Mode, Дати (Luxon), и JSON Queries (JMESPath)

Tournament mode обяснен:

Когато node връща множество items, expressions се изпълняват веднъж per item. Но какво ако ви трябват данни от item #3 докато обработвате item #1?

Тук идват $input.all() и $input.item:

{{ $input.all()[2].json.email }}     // Вземи email от 3-ти item
{{ $input.first().json.name }}       // Име на първия item
{{ $input.last().json.id }}          // ID на последния item
{{ $input.item.json.email }}         // Текущ item (същото като $json)

Дати с Luxon:

n8n използва Luxon за дати. Спрете да се борите с JavaScript Date обекти.

{{ $now.toISO() }}                          // 2024-01-15T14:30:00.000Z
{{ $now.toFormat('yyyy-MM-dd') }}           // 2024-01-15
{{ $now.minus({ days: 7 }).toISO() }}       // Преди 7 дни
{{ $now.startOf('month').toISO() }}         // Първи ден на текущия месец
{{ DateTime.fromISO($json.date).toFormat('dd/MM/yyyy') }}  // Parse & format

Често срещани patterns:

• $now.minus({ hours: 24 }) — последните 24 часа
• $today.startOf('week') — начало на тази седмица
• $now.diff($json.createdAt, 'days').days — дни от създаването

JMESPath за сложни queries:

Когато трябва да филтрирате или трансформирате масиви без Code nodes:

{{ $jmespath($json.users, "[?age > `30`].name") }}  // Имена на потребители над 30
{{ $jmespath($json.items, "[*].price | sum(@)") }} // Сума на всички цени
{{ $jmespath($json.data, "[?status == 'active']") }} // Филтрирай активни items

Практически Patterns: Fallback, Safe Access, Форматиране, Филтриране

Тези patterns решават 90% от реалните проблеми с expressions.

Fallback стойности (справяне с липсващи данни):

{{ $json.nickname || $json.name || "Анонимен" }}
{{ $json.phone ?? "Няма телефон" }}

Safe access (предотвратяване на crashes при undefined):

{{ $json.user?.address?.city || "Неизвестен" }}  // Optional chaining
{{ $json.items?.[0]?.name }}                     // Safe array access

String форматиране:

{{ $json.name.trim() }}                          // Премахни whitespace
{{ $json.email.toLowerCase() }}                  // Малки букви
{{ $json.description.slice(0, 100) + "..." }}    // Отрежи
{{ $json.tags.join(", ") }}                      // Array към string

Number форматиране:

{{ $json.price.toFixed(2) }}                     // 2 десетични знака
{{ Math.round($json.score) }}                    // Закръгли
{{ ($json.amount / 100).toLocaleString('bg-BG', {style: 'currency', currency: 'BGN'}) }}

Условна логика:

{{ $json.status === "active" ? "✅ Активен" : "❌ Неактивен" }}
{{ $json.score >= 80 ? "Издържал" : "Неиздържал" }}

Бързо филтриране в expressions:

{{ $json.items.filter(i => i.price > 100) }}     // Филтрирай скъпи items
{{ $json.users.find(u => u.role === "admin") }}  // Намери първия admin
{{ $json.tags.includes("urgent") }}              // Провери дали tag съществува

Кога да използвате Code node вместо това: Ако expression-ът ви е по-дълъг от един ред, или имате нужда от loops със side effects, преминете към Code node. Expressions са за трансформации, не за бизнес логика.

Надеждност: Грешки, Retries, Alerting

Workflow-то работи перфектно. Пускате го. На третия ден—тишина. Проверявате: API-то връща 500 от 72 часа. Никой не е разбрал.

Това не е edge case. Това е default ако не настроите error handling.

Error Workflow: Централизирайте Провалите

n8n позволява един Error Workflow, който хваща грешки от всички останали workflows. Настройте го веднъж, забравете за индивидуален error handling.

Setup (5 минути):

1. Нов workflow → [System] Error Handler
2. Добавете Error Trigger node (не Webhook)
3. Свържете към Slack/Email/DB

Error Trigger-ът получава всичко нужно:

{
  "workflow": { "name": "Lead Sync to HubSpot" },
  "execution": {
    "url": "https://n8n.domain.com/execution/231",
    "error": { "message": "Status 500", "node": "HTTP Request" }
  }
}

4. Settings на всяко важно workflow → Error Workflow → изберете Handler-а

Slack template:

🚨 {{ $json.workflow.name }} — FAIL
Node: {{ $json.execution.error.node }}
{{ $json.execution.error.message }}
→ {{ $json.execution.url }}

Всяка грешка, едно място. Край на изненадите.

Stop And Error: Форсирайте Провал

API връща 200, но данните са празни. n8n смята workflow-то за “успешно.” Вие знаете, че не е.

Stop And Error node казва на n8n: “Това е грешка. Маркирай като failed. Тригерни Error Workflow.”

IF node: $json.results.length === 0
    ↓ True
Stop And Error: "API върна 0 резултата — вероятно rate limit"

Кога:

• API 200 + празен response
• Бизнес правило нарушено (дубликат, липсващо поле)
• Rate limit достигнат — не искате частични данни

Стратегии: Retry, Backoff, Idempotency

Retry on Fail

Всеки node → Settings → Retry on Fail.

Exponential Backoff

За APIs с rate limits—фиксиран wait не помага. Увеличавайте експоненциално:

const attempt = $json.attemptCount || 1;
const waitMs = Math.min(1000 * Math.pow(2, attempt), 30000);
// 1s → 2s → 4s → 8s → max 30s

Idempotency

Retry = потенциален дубликат. Защитете се:

// Генерирайте уникален key
const idempotencyKey = `${$json.email}-${$json.orderId}`;
// Проверете дали съществува преди INSERT
// Или използвайте UPSERT

Dead-Letter Queue

Item fail-ва 3+ пъти? Спрете да retry-вате. Запишете го за ръчен преглед:

IF: attemptCount > 3
  → True: Добави в "Failed Items" sheet
  → False: Продължи нормално

Преглеждайте седмично. Dead-letter items разкриват системни проблеми.

Proactive Monitoring

Не чакайте failure. Alert-вайте за:

• Workflow не се е изпълнявал 24h (heartbeat check)
• Success rate < 90% за последните 100 executions
• Execution time 2x над нормалното

Реалност: Production проблемите рядко са crashes. Те са тихи: празни responses, спрели webhooks, rate limits, които изяждат 30% от данните. Мониторингът ги хваща. Надеждата—не.

Сигурност & Governance

n8n workflows често работят с чувствителни данни: API keys, клиентски имейли, платежна информация. Неправилно конфигурирана инстанция е отворена врата.

Тази секция не е опционална. Тя е разликата между “инструмент за автоматизация” и “инцидент със сигурността.”

Основите: Заключете Системата

HTTPS навсякъде. Без изключения. Използвайте reverse proxy (Nginx, Traefik, Caddy) с Let’s Encrypt.

# Nginx минимална конфигурация
server {
    listen 443 ssl;
    server_name n8n.yourdomain.com;
    
    ssl_certificate /etc/letsencrypt/live/n8n.yourdomain.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/n8n.yourdomain.com/privkey.pem;
    
    location / {
        proxy_pass http://localhost:5678;
        proxy_set_header Host $host;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

Опции за автентикация:

Basic Auth env променливи:

N8N_BASIC_AUTH_ACTIVE=true
N8N_BASIC_AUTH_USER=admin
N8N_BASIC_AUTH_PASSWORD=силна-парола-тук

2FA: Налично в n8n Cloud и Enterprise. За self-hosted Community, SSO с 2FA-enabled IdP е пътят.

Намалете attack surface:

• Не излагайте n8n директно в интернет. Използвайте VPN или IP whitelist.
• Деактивирайте public API ако не ви трябва: N8N_PUBLIC_API_DISABLED=true
• Стартирайте n8n като non-root потребител (Docker прави това по подразбиране)
• Ограничете outbound мрежата ако е възможно (firewall правила)

Patching: Скучната Част, Която Ви Спасява

n8n е имал критични уязвимости. Всяка платформа за автоматизация има. Въпросът е: колко бързо patch-вате?

Реален пример: В началото на 2024, критична RCE уязвимост (CVE-2024-xxxx) позволяваше на автентикирани потребители да изпълняват произволен код. Поправена за часове, но инстанциите, които не бяха обновени, бяха изложени.

Вашата patching рутина:

1. Абонирайте се за releases: Watch-нете n8n GitHub repo или следвайте @n8n_io
2. Тествайте преди prod: Обновете staging първо, проверете дали workflows работят
3. Автоматизирайте updates: Използвайте Watchtower за Docker или scheduled CI/CD

# Watchtower auto-updates (внимателно в prod)
docker run -d \
  --name watchtower \
  -v /var/run/docker.sock:/var/run/docker.sock \
  containrrr/watchtower n8n --interval 86400

Правило: Security patches в рамките на 48ч. Feature updates в рамките на 2 седмици.

Credentials & Secrets: Внимателно

n8n криптира credentials at rest с N8N_ENCRYPTION_KEY. Това е задължително.

Ако загубите този key, губите всички съхранени credentials. Няма recovery. Backup-нете го отделно от базата данни.

Best practices:

# Генерирайте силен key
openssl rand -hex 32

# Съхранявайте го извън репото
# Използвайте environment variables, не config файлове
N8N_ENCRYPTION_KEY=your-64-char-hex-key

Credential rotation:

Повечето екипи забравят това. APIs биват компрометирани. Служители напускат. Rotation на credentials:

• На тримесечие: High-risk credentials (payment APIs, admin tokens)
• Годишно: Lower-risk credentials (analytics, newsletters)
• Веднага: Когато служител с достъп напусне

RBAC (Role-Based Access Control):

Налично в n8n Cloud Team/Enterprise и self-hosted Enterprise.

За Community self-hosted: една инстанция = едно ниво на достъп. Отделни инстанции за различни нива ако е нужно.

Audit trail: Enterprise плановете логват кой какво е правил. За Community, активирайте execution logging и мониторирайте access logs от reverse proxy. Не е перфектно, но е по-добре от нищо.

Production: Performance, Observability, Scaling

Вашата n8n инстанция работи перфектно със 100 executions/ден. После достигате 10,000. Изведнъж workflows timeout-ват, UI-то пълзи, и дебъгвате в 2 сутринта.

Мащабирайте преди да ви трябва. Ето как.

Performance: Къде Се Чупи Първо

Базата данни обикновено е bottleneck. SQLite работи за тестове. PostgreSQL е задължителен за production.

# Преминете към Postgres (docker-compose.yml)
DB_TYPE=postgresdb
DB_POSTGRESDB_HOST=postgres
DB_POSTGRESDB_DATABASE=n8n

Execution data се натрупва. По подразбиране n8n пази цялата execution history. При мащаб това убива performance.

# Изчиствайте стари executions
EXECUTIONS_DATA_PRUNE=true
EXECUTIONS_DATA_MAX_AGE=168  # часове (7 дни)
EXECUTIONS_DATA_SAVE_ON_ERROR=all
EXECUTIONS_DATA_SAVE_ON_SUCCESS=none  # агресивно, но бързо

Паметта има значение. Default Node.js memory limit е ~1.5GB. Тежки workflows искат повече:

NODE_OPTIONS=--max-old-space-size=4096  # 4GB

Бързи wins:

Observability: Знайте Преди Да Се Счупи

Execution logs са вашият source of truth. n8n съхранява всяко изпълнение с input/output данни. Използвайте го.

• Success rate пада? API се е променил, credentials изтекли, или rate limit достигнат.
• Execution time расте? Upstream услуга деградира или обемът данни расте.
• Конкретен node fail-ва? Обикновено credentials или промяна в API формат.

External monitoring setup:

1. Health endpoint: GET /healthz връща 200 ако n8n работи
2. Uptime monitoring: Насочете Uptime Robot, Pingdom, или Better Stack към него
3. Alerting: Свържете Error Workflow към PagerDuty/Opsgenie за критични workflows

Метрики за следене:

# Активирайте Prometheus metrics (self-hosted)
N8N_METRICS=true
N8N_METRICS_PREFIX=n8n_
# Scrape от /metrics endpoint

Ключови метрики:

• n8n_workflow_executions_total — брой executions по статус
• n8n_workflow_execution_duration — колко време отнемат workflows
• n8n_api_requests_total — API натоварване

Scaling: Когато Една Инстанция Не Стига

Queue mode е първата стъпка. Вместо да изпълнява workflows веднага, n8n push-ва jobs към queue. Отделни workers ги обработват.

# Main инстанция (получава webhooks, queue-ва jobs)
EXECUTIONS_MODE=queue
QUEUE_BULL_REDIS_HOST=redis

# Worker инстанция(и) (обработва jobs)
EXECUTIONS_MODE=queue
QUEUE_BULL_REDIS_HOST=redis
N8N_DISABLE_UI=true  # workers нямат нужда от UI

Кога да използвате queue mode:

• Webhook response time има значение (queue mode отговаря мигновено)
• Нуждаете се от horizontal scaling (добавете workers, не по-големи сървъри)
• Workflows са CPU/memory интензивни

Scaling стратегия по обем:

Backups (не пропускайте):

# PostgreSQL дневен backup
pg_dump -U n8n n8n > backup_$(date +%Y%m%d).sql

# n8n data volume (credentials и т.н.)
docker run --rm -v n8n_data:/data -v $(pwd):/backup \
  alpine tar czf /backup/n8n_data_$(date +%Y%m%d).tar.gz /data

Автоматизирайте това. Тествайте restores на тримесечие. Backup-ът, който никога не сте тествали, е backup-ът, който няма да работи.

Реалност: Повечето екипи нямат нужда от queue mode до 5,000+ executions/ден. Започнете просто. Добавете сложност когато метриките го изискват, не преди.

Лиценз: n8n Наистина ли е “Open Source”?

Кратък отговор: Не. Но е достатъчно близо за повечето случаи.

n8n използва Sustainable Use License (преди наричан “fair-code”). Source кодът е публичен в GitHub. Можете да го четете, модифицирате, self-host-вате. Но има ограничения.

Какво МОЖЕТЕ да Правите

✅ Self-host за собствения си бизнес — Пуснете n8n вътрешно, автоматизирайте процесите си, без такси, без лимити.

✅ Модифицирайте кода — Fork-нете, customize-вайте nodes, стройте вътрешни features. Вашите модификации остават ваши.

✅ Използвайте комерсиално — Вашата компания може да използва n8n за печелене на пари. Автоматизация на продажби, операции, маркетинг? Всичко е ОК.

✅ Допринасяйте обратно — Submit-вайте PRs, докладвайте бъгове, подобрявайте платформата. Community contributions са добре дошли.

Какво НЕ МОЖЕТЕ да Правите

❌ Препродавате n8n — Не можете да пакетирате n8n и да го продавате като ваш собствен продукт.

❌ Предлагате n8n като услуга — Хостването на n8n за други компании (като собствен “n8n Cloud”) изисква комерсиален лиценз от n8n GmbH.

❌ Премахвате license headers — Attribution-ът трябва да остане в кода.

Защо Това Има Значение

Ако сте компания, използваща n8n вътрешно: всичко е наред. Self-host-вайте, customize-вайте, мащабирайте. Без лицензионни такси.

Ако сте агенция, строяща автоматизации за клиенти: също е ОК. Използвате n8n за доставка на услуги, не препродавате софтуера.

Ако мислите да строите продукт върху n8n (SaaS, managed hosting): говорете с n8n първо. Ще ви трябва комерсиално споразумение.

”Fair-Code” Философията

n8n избра този модел за да остане устойчив. Чисто open source проектите често се борят с финансиране—компании използват софтуера безплатно, докато малък екип го поддържа за нищо.

Sustainable Use License = source available + комерсиални ограничения за директна конкуренция с n8n.

Независимо дали сте съгласни с този модел или не, разберете го преди да строите. Лицензът е ясен, и n8n го е прилагал.

Обобщение: За 95% от потребителите—вътрешна автоматизация, агенции, стартъпи—лицензът не променя нищо. Self-host-вайте свободно. Просто не се опитвайте да станете следващия n8n Cloud без разговор първо.

Цени: Как да Оцените Разхода (Без Изненади)

n8n ценообразуването обърква хората. Cloud таксува на execution. Self-hosted е “безплатен”, но струва сървърно време. Нека разбием — с актуалните цени към май 2026.

Промяна 2026: Cloud вече няма безплатен план (заменен с 14-дневен trial без карта). От април 2026 всички планове имат неограничени активни workflows — старите лимити (5, 50, и т.н.) са премахнати. Цените по-долу отразяват тези промени.

Бърза ROI Сметка (Преди да Гледате Цените)

Преди да се впуснете в плановете, направете тази сметка на салфетка. Тя показва защо разходът за n8n почти винаги е незначителен спрямо спестеното време. Механиката е проста:

Спестени часове/седмица × часова ставка × 4.33 седмици = месечна икономия

Това е илюстративна формула, не обещание за резултат — реалните ви часове и ставка ще са различни. Заменете числата със своите: ако един служител губи 1 час дневно на ръчно копиране на поръчки между магазина и счетоводството, това е ~5 ч/седмица, които n8n може да поеме. Дори при консервативни допускания, разходът за инструмента се изплаща многократно още първия месец.

n8n Cloud Цени (2026)

Всички планове се таксуват годишно (с ~17% отстъпка) или месечно. Под “execution” се разбира едно изпълнение на workflow (виж по-долу — има пиплки).

Effективна цена на execution (годишно):

Business не е “повече executions за по-малко” — това е tier за enterprise features (SSO, Git, споделени проекти, по-дълги logs). За чист обем, остане на Pro или мине на self-hosted.

Startup Програмата: 50% отстъпка за малки компании

Ако сте < 20 служители и сте набрали < €5M финансиране, n8n предлага 50% отстъпка на Business (само за self-hosted Enterprise издание, не Cloud). Ефективна цена: ~€333/месец годишно. Подновява се годишно, ако още сте eligible. Релевантно за PME които искат SSO без enterprise бюджет.

Apply: n8n.io/pricing/startup-plan

Как Точно Се Броят Executions (И Защо Може да Ви Изненадат)

Простото правило: 1 trigger → 1 execution, независимо колко items обработва workflow-ът. Но има капани:

• Polling triggers — ако сте конфигурирали “Check Gmail every 10 minutes”, това е 6/час × 24 × 30 = ~4,320 executions/месец, дори ако няма нови имейли. Starter ще е tight само от едно polling. Решение: webhooks където е възможно.
• Sub-workflows — броят се отделно от parent workflow-а. Ако main вика 3 sub-workflows на изпълнение, реалният брой е 4× очаквания.
• Manual тестове броят — всеки клик на “Execute Workflow” по време на разработка добавя execution. На Starter, активна разработка може да изяде 500-1000 execs/месец.
• Error workflows — централизираният error workflow също се брои всеки път когато се задейства.
• Wait nodes — Wait в средата на workflow НЕ нулира execution-а; цялото изпълнение остава едно execution, дори ако чака с часове.

Настройте billing alerts в Cloud dashboard на 75% и 100%. Overages са скъпи (€0.0020–€0.0035 на execution в зависимост от плана).

AI Credits (за AI Workflow Builder)

Всеки Cloud план включва AI credits за визуалния AI builder (генериране на workflows от текстов описание):

• Starter: 50 credits
• Pro: 150 credits
• Business: 500 credits
• Enterprise: 1,000+ credits

Тези credits са за building на workflows — не за API calls към OpenAI/Anthropic при execution. Тези остават отделни (LangChain/HTTP nodes към доставчик по ваш избор, плащате доставчика директно).

Self-Hosted: Реалните Опции (2026)

Лицензионни такси: €0. Плащате инфраструктура. Има три категории.

Managed n8n (one-click деплой, минимална поддръжка)

Self-managed VPS (вие управлявате)

Добавете PostgreSQL (задължителен за production): +€5–15/месец managed (Hetzner DBaaS, DigitalOcean Managed Postgres), или го пуснете в същия контейнер за non-critical workloads.

Реално сравнение при 50,000 executions/месец:

Self-hosted печели на цена с фактор 10–20×. Managed providers (InstaPods, PikaPods) премахват ~80% от self-host работата на цена близка до VPS.

За Агенции: Скритият Капан с Разходите по Клиент

Ако сте агенция, която управлява n8n за 10 клиента на отделни Cloud Pro акаунти: 10 × €600/година = €6,000/година. Същите 10 клиента на споделен self-hosted Business план (с 6 проекта Inclus): €333/месец startup × 12 = €3,996/година. Или 10 managed InstaPods акаунта: 10 × $84/година = ~€780/година.

Per-client Cloud Pro е удобно, но скъпо при мащаб. За агенции с 5+ клиента, разглеждайте self-hosting или поне Business план с многоклиентско разделение.

Кога да Ъпгрейднете (Решаващи Точки)

Trial → Starter: След 14 дни trial. Ако имате 1-3 активни workflows с нисък обем, Starter е минимумът.

Starter → Pro: Overages изяждат бюджета ви. При ~5,000 executions/месец, Pro става по-евтин даже годишно.

Pro → Business: Не за обем — за features: SSO/SAML/LDAP, Git version control, споделени проекти за екипи > 3 човека, 30-дневни execution logs за audit. Ако не ви трябват тези — останете на Pro или мигрирайте към self-hosted.

Pro/Business → Enterprise: Custom SLA, dedicated support, audit изисквания от вашия legal екип, или > 100k executions/месец.

Cloud → Self-hosted:

• Харчите €100+/месец на Cloud
• Имате DevOps капацитет (поне 2 ч/месец)
• Data residency има значение (GDPR, sensitive data)
• Искате 10–20× по-ниска cost-per-execution

Скрити Разходи за Следене

Cloud:

• Overages се промъкват. Настройте billing alerts на 75% / 100%.
• Годишно плащане спестява ~17%, но ви заключва за 12 месеца.
• AI credits се изчерпват по-бързо от очакваното при активна разработка.

Self-hosted:

• Време за server maintenance (updates, backups, debugging)
• Monitoring инструменти (Grafana, Prometheus, alerts)
• Вашето време когато се счупи в 2 сутринта (или naga на агенция за поддръжка)
• PostgreSQL backups + retention storage

Моето мнение (май 2026): Започнете с Cloud Starter годишно (€240/година — risk-free start). Накарайте workflows да работят. Когато сте на €100+/месец и имате някой, който може да управлява инфраструктура, помислете за managed self-host (InstaPods, PikaPods) — почти всички предимства на self-hosted, без 2 AM maintenance. Чист VPS self-host става интересен само ако вече имате DevOps и сте над €200/месец Cloud.

Алтернативи на n8n (и Кога Печелят)

n8n не винаги е отговорът. Ето честен поглед кога конкурентите имат повече смисъл.

Бързо Сравнение

Сценарий за разход при реалистичен български обем (5 000 изпълнения/месец):

При този обем n8n self-hosted е практически безплатен спрямо алтернативите, а n8n Cloud Pro още има голям резерв преди да опре в лимита. Цифрите са ориентировъчни — Make и Zapier се таксуват на операция/task, не на изпълнение, така че реалната сметка зависи от това колко стъпки има всеки ваш сценарий.

Кога Zapier Печели

Изберете Zapier ако:

• Екипът ви не е технически и няма да стане
• Трябва ви нещо работещо за 15 минути
• Обемът остава под 1,000 tasks/месец
• Бюджетът не е ограничение

UI-то на Zapier е ненадминато по простота. 5,000+ интеграции. Нулева learning curve. Плащате за това удобство.

Кога Make Печели

Изберете Make ако:

• Искате визуално строене, но повече мощ от Zapier
• Бюджетът има значение (Make е 4-5x по-евтин per operation)
• Нуждаете се от branching, итерации, error handling
• Екипът може да се справи с малко повече сложност

Make удря sweet spot: по-способен от Zapier, по-приятелски от n8n, разумни цени.

Кога Pipedream Печели

Изберете Pipedream ако:

• Вие сте developer, който мисли в код
• Искате Node.js/Python с минимална абстракция
• Щедрият free tier има значение (10,000 credits/месец)
• Не ви трябва self-hosting

Pipedream е най-близкият конкурент на n8n за технически потребители. По-добър DX за чисти coders. Но няма self-hosting опция.

Кога Airflow/Prefect Печелят

Изберете Airflow или Prefect ако:

• Строите data pipelines, не app интеграции
• Workflows са DAGs със сложни зависимости
• Екипът ви вече знае Python
• Нуждаете се от сериозен scheduling и orchestration

Това не са n8n конкуренти—те са различни инструменти. Airflow за data engineering. n8n за operational automation.

Рамката за Решение

Попитайте се:

1. Кой ще строи и поддържа това?

   • Нетехнически → Zapier или Make
   • Технически, но не DevOps → n8n Cloud или Pipedream
   • Пълен DevOps капацитет → n8n self-hosted или Airflow

2. Какъв е обемът ви?

   • < 1,000/месец → Всичко работи, изберете най-лесното
   • 1,000–50,000/месец → Make или n8n Cloud
   • 50,000+/месец → n8n self-hosted

3. Къде трябва да живеят данните?

   • Навсякъде → Cloud опциите са ОК
   • Само вашата инфраструктура → n8n или Airflow

Честно мнение: Повечето екипи трябва да започнат с Make или Zapier. Преминете към n8n когато ударите лимити—цена, сложност, или контрол. Преди да изберете инструмент изобщо, вижте кои операционни процеси си струва да автоматизирате първо — точно те определят дали имате нужда от мощта на n8n. Да започнете с n8n “защото е безплатен” често означава workflows, които никога не се завършват.

Заключение + Следващи Стъпки

Прочетохте 5,000+ думи за n8n. Сега какво?

Вашият План за Действие (Тази Седмица)

Ден 1: Пуснете го

• Cloud: Регистрирайте се безплатно → стройте в браузъра
• Self-hosted: docker run -p 5678:5678 n8nio/n8n → localhost:5678

Ден 2-3: Постройте първия реален workflow

• Изберете ЕДНА повтаряща се задача, която правите седмично
• Постройте workflow (webhook → логика → действие)
• Тествайте с реални данни, не примерни

Ден 4-5: Направете го production-ready

• Настройте Error Workflow (централизирано alerting)
• Активирайте Retry on Fail за API nodes
• Добавете credentials правилно (не hardcoded)

Седмица 2: Мащабирайте това, което работи

• Документирайте workflow-то (sticky notes)
• Добавете monitoring (execution success rate)
• Постройте workflow #2

Ключови Изводи

1. n8n = мощ + собственост. Разменяте простота за контрол. Струва си при мащаб.

2. Започнете с Cloud. Преминете към self-hosted когато ударите €100/месец или ви трябва контрол на данните.

3. Error handling не е опционален. Един Error Workflow хваща всичко. Настройте го ден първи.

4. Лицензът е ОК за 95% от потребителите. Вътрешна автоматизация, агенции, стартъпи—всичко е наред.

5. Алтернативите съществуват с причина. Нетехнически екип? Започнете с Make или Zapier. Върнете се когато ги надраснете.

Официални Ресурси

• n8n Documentation — Източникът на истина
• Workflow Templates — 900+ готови workflows
• Community Forum — Активна, полезна общност
• n8n GitHub — Source code, issues, releases

n8n Ресурси на Български

Официалната документация е на английски, но има и обучения на български език, ако предпочитате да започнете на родния си език:

• SoftUni — Smart Business Automations with n8n — практически курс за автоматизация на бизнес процеси с n8n, насочен към хора без предишен опит с no-code инструменти.
• NobleProg — обучения по n8n в България — водени от инструктор курсове (на живо или онлайн), включително за маркетингова автоматизация, интеграция на данни и DevOps.
• DevOps България — българска общност с практически статии за самостоятелен хостинг на n8n с Docker и AI.

Бележка: Локалната n8n екосистема на български още е малка и расте. За дълбоки технически въпроси официалният Community Forum (на английски) остава най-бързият път до отговор.

Нуждаете се от Помощ?

Строите сложни автоматизации? Мигрирате от друга платформа? Не сте сигурни откъде да започнете?

Ние строим n8n workflows за бизнеси. От прости интеграции до enterprise deployments.

Запазете Безплатен Одит →

Това ръководство се обновява редовно. Последна актуализация: Януари 2026. Намерихте грешка или имате предложения? Кажете ни.