⚡ המדריך המקיף ל-n8n

# בדיקת גרסת Node.js
node --version   # צריך להיות v18+

# התקנה גלובלית של n8n
npm install n8n -g

# הרצה ראשונה
n8n start

# n8n זמין ב: http://localhost:5678

# הרצה מהירה עם Docker
docker run -it --rm \
  --name n8n \
  -p 5678:5678 \
  -v n8n_data:/home/node/.n8n \
  docker.n8n.io/n8nio/n8n

# עם SQLite (ברירת מחדל) — מצוין לפיתוח
# הנתונים נשמרים ב-Volume: n8n_data

# הרצה ישירה ללא התקנה גלובלית
npx n8n

# פותחים בדפדפן: http://localhost:5678
# ביצירת המשתמש הראשון — זה יהיה ה-Owner

# עדכון מערכת
sudo apt update && sudo apt upgrade -y

# התקנת Docker
curl -fsSL https://get.docker.com | sudo sh

# התקנת Docker Compose
sudo apt install docker-compose-plugin -y

# בדיקה
docker --version
docker compose version

# יצירת תיקייה לפרויקט
mkdir -p /opt/n8n && cd /opt/n8n

# /opt/n8n/docker-compose.yml
version: "3.8"

services:
  n8n:
    image: docker.n8n.io/n8nio/n8n
    restart: always
    ports:
      - "5678:5678"
    environment:
      # Database
      - DB_TYPE=postgresdb
      - DB_POSTGRESDB_HOST=postgres
      - DB_POSTGRESDB_PORT=5432
      - DB_POSTGRESDB_DATABASE=n8n
      - DB_POSTGRESDB_USER=n8n
      - DB_POSTGRESDB_PASSWORD=your_secure_password_here
      # General
      - N8N_HOST=n8n.yourdomain.com
      - N8N_PORT=5678
      - N8N_PROTOCOL=https
      - WEBHOOK_URL=https://n8n.yourdomain.com/
      # Security
      - N8N_ENCRYPTION_KEY=a-random-32-char-encryption-key!
      # Timezone
      - GENERIC_TIMEZONE=Asia/Jerusalem
      - TZ=Asia/Jerusalem
      # Execution settings
      - EXECUTIONS_DATA_PRUNE=true
      - EXECUTIONS_DATA_MAX_AGE=168  # 7 days
    volumes:
      - n8n_data:/home/node/.n8n
    depends_on:
      postgres:
        condition: service_healthy

  postgres:
    image: postgres:16-alpine
    restart: always
    environment:
      - POSTGRES_USER=n8n
      - POSTGRES_PASSWORD=your_secure_password_here
      - POSTGRES_DB=n8n
    volumes:
      - postgres_data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U n8n"]
      interval: 5s
      timeout: 5s
      retries: 10

volumes:
  n8n_data:
  postgres_data:

# הפעלה ברקע
docker compose up -d

# צפייה בלוגים
docker compose logs -f n8n

# בדיקת סטטוס
docker compose ps

# התקנת Nginx ו-Certbot
sudo apt install nginx certbot python3-certbot-nginx -y

# יצירת קובץ קונפיגורציה
sudo nano /etc/nginx/sites-available/n8n.yourdomain.com

# /etc/nginx/sites-available/n8n.yourdomain.com
server {
    server_name n8n.yourdomain.com;

    location / {
        proxy_pass http://127.0.0.1:5678;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;

        # WebSocket support (חשוב!)
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";

        # Timeout for long workflows
        proxy_read_timeout 300s;
        proxy_connect_timeout 75s;
    }

    client_max_body_size 50M;

    listen 80;
}

# הפעלת האתר
sudo ln -s /etc/nginx/sites-available/n8n.yourdomain.com \
  /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx

# הוצאת תעודת SSL
sudo certbot --nginx -d n8n.yourdomain.com

# ✅ עכשיו n8n זמין ב: https://n8n.yourdomain.com

# עדכון ל-latest
cd /opt/n8n
docker compose pull
docker compose down
docker compose up -d

# בדיקת גרסה
docker compose exec n8n n8n --version

Method: GET
URL: https://api.example.com/products/12345
Response Format: JSON

# כתובת Webhook לדוגמה (n8n יוצר אוטומטית):
https://n8n.yourdomain.com/webhook/abc-123-def-456

# שליחת נתונים ל-Webhook:
curl -X POST https://n8n.yourdomain.com/webhook/abc-123-def-456 \
  -H "Content-Type: application/json" \
  -d '{"name": "John", "action": "signup"}'

# הנתונים זמינים ב-Workflow דרך: {{ $json.name }}

# דוגמאות Cron expressions ב-n8n:

כל 5 דקות:              */5 * * * *
כל שעה ב-:00:           0 * * * *
כל יום ב-09:00:         0 9 * * *
כל יום ראשון ב-08:00:   0 8 * * 0
יום 1 בכל חודש ב-06:00: 0 6 1 * *

# אפשר גם להשתמש בממשק הגרפי במקום Cron:
# Every → 1 → Hour → at minute 0

// גישה לנתונים מ-Node קודם
const items = $input.all();

// עיבוד כל פריט
const results = items.map(item => {
  return {
    json: {
      fullName: `${item.json.firstName} ${item.json.lastName}`,
      email: item.json.email.toLowerCase(),
      isVIP: item.json.totalOrders > 100,
      registeredAt: new Date(item.json.created).toLocaleDateString('he-IL')
    }
  };
});

return results;

# Python mode (n8n 1.30+)
items = _input.all()

results = []
for item in items:
    data = item.json
    results.append({
        "full_name": f"{data['first_name']} {data['last_name']}",
        "score": data['points'] * 1.5,
        "tier": "gold" if data['points'] > 500 else "silver"
    })

return results

// ביטויים שימושיים בשדות של Nodes:

{{ $json.fieldName }}            // שדה מה-Node הקודם
{{ $json.user.email }}           // שדה מקונן
{{ $json.items[0].name }}        // אלמנט מתוך מערך
{{ $('HTTP Request').item.json.data }}  // שדה מ-Node ספציפי
{{ $now.toISO() }}               // תאריך ושעה נוכחיים
{{ $vars.apiUrl }}               // משתנה סביבתי
{{ $execution.id }}              // ID של ההרצה הנוכחית

// פונקציות:
{{ $json.name.toUpperCase() }}   // המרה לאותיות גדולות
{{ $json.items.length }}         // אורך מערך
{{ $json.price.toFixed(2) }}     // עיגול מספר
{{ DateTime.now().minus({days: 7}).toISO() }}  // לפני שבוע

// Error handling ב-Code Node:
try {
  const response = await this.helpers.httpRequest({
    method: 'GET',
    url: 'https://api.example.com/data',
  });
  return [{ json: response }];
} catch (error) {
  // שליחת שגיאה מותאמת
  return [{
    json: {
      success: false,
      error: error.message,
      timestamp: new Date().toISOString()
    }
  }];
}

// System Prompt לדוגמה ב-AI Agent:
"אתה עוזר AI של חברת TechCorp.
ענה על שאלות לקוחות בעברית.
השתמש בכלי Vector Store לחיפוש במסמכי החברה.
אם אין לך תשובה — הפנה לתמיכה: [email protected]
היה קצר ומקצועי."

// ה-Agent ישתמש אוטומטית בכלים לפי הצורך!

// Code Node: בדיקת בריאות אתר
const url = 'https://yoursite.com';
const start = Date.now();

try {
  const response = await this.helpers.httpRequest({
    method: 'GET',
    url: url,
    timeout: 10000,
  });

  return [{
    json: {
      status: 'up',
      responseTime: Date.now() - start,
      statusCode: 200,
      url: url,
      checkedAt: new Date().toISOString()
    }
  }];
} catch (error) {
  return [{
    json: {
      status: 'down',
      error: error.message,
      url: url,
      checkedAt: new Date().toISOString()
    }
  }];
}

# יצירת API Key:
# Settings → API → Create API Key

# רשימת כל ה-Workflows:
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://n8n.yourdomain.com/api/v1/workflows

# הפעלת Workflow ידנית:
curl -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"data": {"key": "value"}}' \
  https://n8n.yourdomain.com/api/v1/workflows/123/run

# שליפת Executions:
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://n8n.yourdomain.com/api/v1/executions

# ייצוא Workflow (JSON):
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://n8n.yourdomain.com/api/v1/workflows/123 \
  -o workflow_backup.json

# גיבוי Workflows (ייצוא כל ה-Workflows):
curl -H "Authorization: Bearer API_KEY" \
  https://n8n.yourdomain.com/api/v1/workflows \
  -o workflows_backup_$(date +%Y%m%d).json

# גיבוי בסיס הנתונים (PostgreSQL):
docker compose exec postgres pg_dump -U n8n n8n > n8n_db_backup.sql

# גיבוי Volume:
docker run --rm -v n8n_data:/data -v $(pwd):/backup \
  alpine tar czf /backup/n8n_files_backup.tar.gz /data

# שחזור:
cat n8n_db_backup.sql | docker compose exec -T postgres psql -U n8n n8n

# .env file for docker-compose

# Core
N8N_ENCRYPTION_KEY=change-me-to-random-32-chars!!
N8N_HOST=n8n.yourdomain.com
N8N_PROTOCOL=https
WEBHOOK_URL=https://n8n.yourdomain.com/

# Database
DB_TYPE=postgresdb
DB_POSTGRESDB_HOST=postgres
DB_POSTGRESDB_DATABASE=n8n
DB_POSTGRESDB_USER=n8n
DB_POSTGRESDB_PASSWORD=super_secure_password

# Performance
EXECUTIONS_DATA_PRUNE=true
EXECUTIONS_DATA_MAX_AGE=168
EXECUTIONS_TIMEOUT=300
EXECUTIONS_DATA_SAVE_ON_ERROR=all
EXECUTIONS_DATA_SAVE_ON_SUCCESS=none  # חוסך מקום

# Timezone
GENERIC_TIMEZONE=Asia/Jerusalem
TZ=Asia/Jerusalem

# Logs
N8N_LOG_LEVEL=warn
N8N_LOG_OUTPUT=console

# Email (SMTP for notifications)
N8N_EMAIL_MODE=smtp
N8N_SMTP_HOST=smtp.gmail.com
N8N_SMTP_PORT=465
N8N_SMTP_SSL=true
N8N_SMTP_USER=[email protected]
N8N_SMTP_PASS=app-password
N8N_SMTP_SENDER=[email protected]