Integração

Use a Shifter com n8n

Conecte os proxies residenciais e ISP da Shifter aos workflows do n8n de duas formas - no nível de ambiente para todos os nós HTTP de uma vez, ou diretamente no nó HTTP Request quando você precisa de controle por workflow.

Início Rápido

Instalar

docker run -p 5678:5678 -e HTTP_PROXY=... n8nio/n8n

Uso Básico

# Easiest path: set HTTP_PROXY / HTTPS_PROXY when launching n8n
docker run -d --name n8n -p 5678:5678 \
  -e HTTP_PROXY="customer-USERNAME-country-us-sid-123ABC:PASSWORD@p.shifter.io:443" \
  -e HTTPS_PROXY="customer-USERNAME-country-us-sid-123ABC:PASSWORD@p.shifter.io:443" \
  -e NO_PROXY="localhost,127.0.0.1" \
  n8nio/n8n

# Every HTTP Request node will now route through Shifter automatically.

Recursos

Configure uma vez via variáveis de ambiente HTTP_PROXY / HTTPS_PROXY e todo node HTTP Request usa o Shifter automaticamente
Substituição de proxy por nó no nó HTTP Request para fluxos de trabalho que precisam de países / sessões diferentes por etapa
Nós de função podem gerar um sid novo no início do workflow para sessões sticky estáveis durante toda a execução
Geo-direcionamento em 195+ países: passe seletores country / city / ASN via expressões
Funciona no n8n Cloud, Docker auto-hospedado, chart Helm do Kubernetes e no aplicativo desktop
Compatível com todo o ecossistema de nodes do n8n — qualquer coisa que faça chamadas via rotas HTTP passa pelo Shifter

Exemplos

Proxy Por Nó via HTTP Request (UI)

Quando você precisa de controle por fluxo de trabalho (países diferentes por nó, sessões persistentes por spider), configure o proxy diretamente no nó HTTP Request, sem necessidade de variáveis de ambiente.

# In the HTTP Request node:
#   1. Switch to "Generic Authentication"
#   2. Authentication: "Generic Credential Type"
#   3. Credential type: "HTTP Header Auth"
#   4. Then in the node body, add:
#
#      Send Headers: ON
#      Header Parameters:
#         Proxy-Authorization: Basic <base64(USER:PASS)>
#
#   5. Set Request Options > Proxy:
#      http://p.shifter.io:443

# Or, simpler — set "Send Body / Send Headers / Use Proxy" toggles
# and configure Proxy directly:
{
  "parameters": {
    "url": "https://example.com",
    "options": {
      "proxy": "customer-USERNAME-country-uk-sid-456DEF:PASSWORD@p.shifter.io:443",
      "timeout": 30000,
      "redirect": { "followRedirects": true }
    }
  },
  "name": "Scrape UK products",
  "type": "n8n-nodes-base.httpRequest"
}

Sessão Persistente Por Fluxo de Trabalho com Function Node

Gere um sid único no início de um workflow e passe-o para cada nó HTTP subsequente. Todas as buscas naquela execução compartilham um único IP residencial, perfeito para scrapes de múltiplas etapas.

// Function node — outputs a Shifter URL with a fresh sid + ttl
const sid = Math.random().toString(36).slice(2, 10);
const country = $json.country || "us";

return [
  {
    json: {
      shifterProxy:
        `customer-USERNAME-country-${country}-sid-${sid}-ttl-300:` +
        `PASSWORD@p.shifter.io:443`,
      country,
      sid,
    },
  },
];

// Then in each downstream HTTP Request node, set:
//   Proxy: ={{ $json.shifterProxy }}
//
// Every node in the run reuses the same residential IP.

Ramificações Geo-específicas (Switch + Múltiplos Países)

Use um nó Switch para rotear itens diferentes por ramificações diferentes, com o nó HTTP Request de cada ramificação configurado para um país diferente. Ideal para monitoramento de preços localizado ou verificações de SERP.

// Workflow shape:
//
//   Schedule Trigger
//        |
//   Set: list of regions
//        |
//   Split In Batches (per region)
//        |
//   Switch (item.region == "us" / "uk" / "jp" / ...)
//        |--- HTTP Request (proxy: country-us  sid-us-001)
//        |--- HTTP Request (proxy: country-uk  sid-uk-001)
//        |--- HTTP Request (proxy: country-jp  sid-jp-001)
//        |--- HTTP Request (proxy: country-de  sid-de-001)
//        |
//   Merge -> HTML Extract -> Postgres Insert

// Or, parameterize the proxy on a single HTTP Request node:
{
  "url": "https://example.com/{{$json.path}}",
  "options": {
    "proxy": "=customer-USERNAME-country-{{$json.region}}-sid-{{$json.region}}-{{$workflow.id}}:PASSWORD@p.shifter.io:443"
  }
}

Auto-hospedado com Docker Compose

Configuração pronta para produção. Injete as variáveis de ambiente do Shifter no container do n8n, persista os workflows no Postgres e deixe que cada nó HTTP Request use o Shifter sem configuração individual por nó.

# docker-compose.yml
version: "3.8"

services:
  n8n:
    image: n8nio/n8n:latest
    restart: unless-stopped
    ports:
      - "5678:5678"
    environment:
      # Shifter proxy for every outbound HTTP Request node
      HTTP_PROXY:  "customer-USERNAME-country-us-sid-prod:PASSWORD@p.shifter.io:443"
      HTTPS_PROXY: "customer-USERNAME-country-us-sid-prod:PASSWORD@p.shifter.io:443"
      NO_PROXY:    "localhost,127.0.0.1,postgres"

      DB_TYPE:                  postgresdb
      DB_POSTGRESDB_HOST:       postgres
      DB_POSTGRESDB_DATABASE:   n8n
      DB_POSTGRESDB_USER:       n8n
      DB_POSTGRESDB_PASSWORD:   n8n_password
      N8N_BASIC_AUTH_ACTIVE:    "true"
      N8N_BASIC_AUTH_USER:      admin
      N8N_BASIC_AUTH_PASSWORD:  changeme
    volumes:
      - n8n_data:/home/node/.n8n
    depends_on:
      - postgres

  postgres:
    image: postgres:15
    restart: unless-stopped
    environment:
      POSTGRES_DB: n8n
      POSTGRES_USER: n8n
      POSTGRES_PASSWORD: n8n_password
    volumes:
      - postgres_data:/var/lib/postgresql/data

volumes:
  n8n_data:
  postgres_data:
Perguntas Frequentes

Perguntas frequentes

Perguntas comuns sobre usar o Shifter com n8n.

O caminho mais simples é definir as variáveis de ambiente HTTP_PROXY e HTTPS_PROXY no processo (ou contêiner) do n8n. Todo nó HTTP Request, e a maioria dos outros nós que fazem chamadas externas, capta essas variáveis de ambiente automaticamente. Para controle por workflow, defina o proxy diretamente nas Options do nó HTTP Request.

Sim. Cada nó HTTP Request tem um campo Options > Proxy. Cole sua URL do Shifter ali e esse nó será roteado pelo Shifter independentemente de quaisquer variáveis de ambiente globais. Combine com a sintaxe de expressão (`={{$json.proxy}}`) para parametrizar por item.

Sim. O n8n Cloud não permite definir variáveis de ambiente HTTP_PROXY, mas a configuração de proxy por nó no nó HTTP Request funciona exatamente da mesma forma que na versão self-hosted. Defina o campo de proxy em cada nó que precisar do Shifter.

Adicione um nó Function no início do fluxo de trabalho que gera um sid único (ex.: `Math.random().toString(36).slice(2, 10)`) e produz uma URL do Shifter com esse sid embutido. Referencie essa URL via expressão em todos os nós HTTP Request subsequentes: todos compartilharão o mesmo IP residencial.

Sim. Use um nó Switch para ramificar com base em um campo de região, ou use expressões como `={{$json.country}}` dentro da URL do proxy no nó HTTP Request. Cada item pode ser roteado por um país / cidade / ASN diferente da Shifter.

Nenhum node personalizado é necessário. A Shifter é um proxy HTTP / SOCKS5 padrão, o node HTTP Request nativo do n8n e as variáveis de ambiente de proxy lidam com isso de forma pronta. Isso mantém seus fluxos de trabalho portáveis entre n8n Cloud, self-hosted e implantações incorporadas.

Começar

Comece a Usar o Shifter com n8n

Conecte os mais de 205 milhões de proxies residenciais e ISP da Shifter aos seus workflows do n8n. Configuração via variável de ambiente ou por nó, sessões sticky e geotargeting por item - funciona no Cloud e em instalações self-hosted.

Experimente o Shifter GratuitamenteConfigure em minutos. Cancele quando quiser.