Panduan konfigurasi proxy di n8n: pengaturan node, variabel lingkungan, dan reverse proxy

Menjalankan workflow n8n dari cloud server sering kali memicu rate limit. Platform target memblokir permintaan yang berasal dari IP datacenter yang dikenal. Konfigurasi proxy n8n yang tepat memulihkan stabilitas operasional. Tujuan utamanya adalah memastikan integrasi proxy otomasi yang mulus langsung ke dalam arsitektur Anda.

TL;DR: Checklist setup proxy n8n

Node HTTP Request mendukung routing terisolasi tanpa memengaruhi environment container global.
Autentikasi proxy n8n untuk workflow otomatis memerlukan Generic Credential Type menggunakan header Proxy-Authorization.
Package internal proxy-from-env secara ketat memprioritaskan environment variable huruf kecil.
Database lokal memerlukan definisi variable NO_PROXY untuk mencegah network loopback.
Reverse proxy Apache memerlukan routing header WebSocket agar interface editor berfungsi.
Variable N8N_PROXY_HOPS=1 mengatasi error deteksi IP client di belakang load balancer.

Apa itu n8n dan mengapa memerlukan proxy

n8n adalah platform otomasi workflow tingkat lanjut. Engineer menggunakan visual editor berbasis node untuk menghubungkan database, CRM, dan aplikasi pihak ketiga tanpa menulis boilerplate code yang berat. Sistem ini mengorkestrasi data di ratusan API eksternal. Namun, permintaan server langsung dengan cepat menghabiskan limit platform target. Konfigurasi proxy outgoing n8n yang ketat menyelesaikan tiga tugas operasional.

Pertama, mendistribusikan beban permintaan untuk meningkatkan rate limit API dengan aman.
Kedua, melokalisasi jejak jaringan untuk mengakses data regional.
Ketiga, mengisolasi environment saat mengelola beberapa profil.

👉 Ekosistem CyberYozh App mencakup kebutuhan infrastruktur ini, dengan mudah menawarkan kartu virtual dan nomor ISP asli untuk setup profil lengkap.

Jenis-jenis proxy untuk workflow otomasi n8n

Pilihan jaringan Anda menentukan keandalan workflow. Konfigurasi proxy n8n yang sukses sangat bergantung pada pemilihan IP pool yang tepat.

Proxy Mobile LTE/5G. Ini merutekan traffic melalui perangkat seluler asli. Mereka memberikan Trust Rate tertinggi untuk operasi platform sosial.
Proxy ISP statis residential. Alamat tetap dari penyedia internet rumah asli. Mereka mempertahankan sesi panjang untuk scraping data berkelanjutan.
Proxy residential rotating. Jaringan global dengan jutaan alamat. Fitur Sticky session mempertahankan satu IP hingga 24 jam untuk tugas yang dapat diskalakan.
Proxy datacenter. Server dedicated yang dioptimalkan untuk proses analitik berkecepatan tinggi.

👉 CyberYozh App menyediakan semua jenis jaringan ini dengan kontrol API dan geo-targeting gratis.

Cara mengonfigurasi proxy untuk node http request n8n

Parameter global sering berkonflik dengan TLS handshake. Routing terisolasi mengatasi masalah ini. Engineer mengonfigurasi parameter proxy node HTTP Request n8n secara langsung di dalam antarmuka node. Ini memungkinkan Anda mengubah konfigurasi secara dinamis. Anda menghindari pembatasan environment global sepenuhnya.

Buka antarmuka node. Perluas bagian Options. Aktifkan toggle Proxy dan masukkan URL host Anda sebagai http://IP:PORT. Autentikasi bawaan standar sering menghilangkan kredensial. Pilih Generic Credential Type dan buat record Header Auth baru. Atur Name menjadi Proxy-Authorization. Tools seperti cURL mengenkode kredensial secara tidak terlihat, tetapi n8n memerlukan header eksplisit. Untuk field Value, gunakan ekspresi bawaan n8n untuk mengenkode kredensial CyberYozh Anda secara otomatis:

javascript

={{'Basic ' + $btoa('your_username:your_password')}}

Proses multi-langkah memerlukan retensi konteks dan manajemen sesi yang stabil. Residential rotating proxy memerlukan pemeliharaan satu alamat IP di seluruh beberapa request. Dashboard CyberYozh dilengkapi dengan generator proxy bawaan untuk menangani ini secara otomatis. Pilih pengaturan Custom duration (Sticky session) dan tentukan jangka waktu Anda (hingga 24 jam). Sistem menghasilkan kredensial yang terikat langsung ke sesi stabil tersebut di server backend. Anda cukup mengenkode login dan password spesifik ini ke dalam header Proxy-Authorization di dalam node HTTP Request.

Validasi arsitektur: Menguji koneksi proxy di workflow n8n

Sebelum mendorong konfigurasi proxy n8n Anda ke production, buat workflow pengujian sederhana. Arahkan node HTTP Request ke API identifikasi IP eksternal (seperti api.ipify.org) menggunakan request GET. Periksa output JSON. Layanan target harus melihat IP proxy yang disewa, bukan alamat IP instance n8n Anda.

👉 Pemeriksa Fraud Score CyberYozh mengevaluasi kualitas IP Anda terhadap database seperti ThreatMetrix dan PerimeterX sebelum Anda meluncurkan. Ini membantu mencegah API target menolak request Anda.

Infrastruktur global: variabel environment proxy n8n

Konfigurasi proxy n8n di seluruh container bergantung pada pendefinisian parameter dalam file .env Anda. CyberYozh menggunakan autentikasi username dan password standar. Anda memasukkan kredensial ini secara langsung di dalam string URL. Core n8n membaca parameter ini menggunakan package Node.js bawaan proxy-from-env. Library ini memberlakukan hierarki yang ketat: variabel huruf kecil selalu lebih diprioritaskan daripada huruf besar. Jika Anda mendefinisikan HTTPS_PROXY, tetapi OS host memiliki variabel https_proxy kosong secara default, n8n mengabaikan aturan routing Anda sepenuhnya. Selalu definisikan kedua gaya format untuk menjamin routing yang berhasil:

HTTP_PROXY=http://username:password@IP:PORT

HTTPS_PROXY=http://username:password@IP:PORT

http_proxy=http://username:password@IP:PORT

https_proxy=http://username:password@IP:PORT

ALL_PROXY=http://username:password@IP:PORT

Anda harus mengonfigurasi NO_PROXY. Sertakan localhost, 127.0.0.1, dan subnet Docker internal Anda untuk mempertahankan koneksi dengan database PostgreSQL atau Redis lokal. Jika tidak, traffic internal ini akan mengenai gateway eksternal dan timeout. Mengatur NO_PROXY=* langsung menonaktifkan semua proxy di seluruh container. Periksa dokumentasi resmi n8n untuk daftar lengkap variabel environment guna menyempurnakan infrastruktur container Anda secara keseluruhan.

Traffic masuk: konfigurasi reverse proxy Apache n8n

Server Apache atau Nginx menangani terminasi SSL. Mereka mendekripsi traffic masuk dan meroutingnya ke dalam container ke port lokal 5678. Topologi ini menciptakan dua masalah struktural.

Pertama, routing webhook n8n melalui reverse proxy Apache merusak link UI karena aplikasi menganggap alamat dasarnya adalah localhost. Perbaiki ini dengan menyuntikkan variabel N8N_EDITOR_BASE_URL. Atur ke domain publik Anda yang tepat (seperti https://n8n.cyberyozh.com). Format variabel lama seperti WEBHOOK_URL sudah deprecated dan akan memicu peringatan sistem.

Kedua, log internal hanya melihat IP server Apache. Daftar kontrol akses bawaan berhenti bekerja. Tambahkan variabel N8N_PROXY_HOPS=1. Ini memaksa core Express.js untuk mempercayai header eksternal.

Antarmuka editor bergantung pada WebSocket. Server Anda harus mencegat dan meneruskan request ini. Tanpa itu, antarmuka editor akan membeku secara siklis dan memutuskan koneksi. Tambahkan direktif berikut di dalam blok VirtualHost Apache Anda untuk memastikan upgrade protokol yang transparan dan forwarding IP klien yang sebenarnya:

ProxyPreserveHost On

RequestHeader set X-Forwarded-Proto "https"

RewriteEngine On

RewriteCond %{HTTP:Upgrade} =websocket [NC]

RewriteRule /(.*)           ws://localhost:5678/$1 [P,L]

ProxyPass / http://localhost:5678/

ProxyPassReverse / http://localhost:5678/

Matriks troubleshooting

Gejala / Error	Penyebab yang Mungkin	Solusi Engineering
HTTP Request mengembalikan 407 Proxy Authentication Required	Format kredensial salah.	Beralih ke Generic Credential Type. Gunakan Header Auth dengan header Proxy-Authorization.
Error ECONNRESET saat mengakses resource HTTPS	Keterbatasan HTTP CONNECT library Axios.	Gunakan routing proxy granular di dalam pengaturan HTTP Request node.
Link UI Webhook menampilkan http://localhost:5678	Aplikasi terisolasi di balik reverse proxy.	Inject N8N_EDITOR_BASE_URL=https://[domain] ke dalam environment Docker. Jangan gunakan variabel legacy yang sudah deprecated.
Editor menampilkan error Connection lost yang siklis	Apache memutus koneksi WebSocket.	Tambahkan direktif header Upgrade dan Connection ke konfigurasi Apache.
Variabel proxy global diabaikan	Konflik prioritas proxy-from-env.	Deklarasikan format lowercase dan uppercase di docker-compose.yml.
Database lokal mengembalikan timeout	Traffic internal mengenai gateway eksternal.	Definisikan NO_PROXY dengan localhost dan subnet Docker.

Orkestrasi data sepenuhnya bergantung pada kualitas transport stack. Konfigurasi proxy n8n yang direncanakan dengan baik mencegah kegagalan handshake. Pengaturan HTTP Request node yang granular dan deklarasi variabel environment yang eksplisit mengeliminasi konflik prioritas. Menggunakan infrastruktur CyberYozh menjamin konsistensi sesi. Anda mendapatkan eksekusi pipeline yang dapat diprediksi dalam skala apa pun.

FAQ tentang konfigurasi proxy n8n

Bagaimana cara memperbaiki error "ValidationError: The X-Forwarded-For header is set"?

Ini terjadi di balik reverse proxy. Core Express.js menolak header eksternal secara default. Tambahkan N8N_TRUST_PROXY=true dan N8N_PROXY_HOPS=1 ke konfigurasi Docker Anda. Restart container.

Mengapa HTTP Request node mengabaikan variabel environment HTTPS_PROXY?

Library Axios kesulitan dengan tunneling HTTPS melalui gateway HTTP standar. Konfigurasikan routing langsung di dalam parameter HTTP Request node. Ini mengisolasi koneksi dengan benar.

Bagaimana cara mengatasi "400 Bad Request: plain HTTP request was sent to HTTPS port"?

Node mencoba mengirim traffic HTTP ke port 443. Periksa protokol di string URL target Anda. Verifikasi tidak ada ketidakcocokan protokol di pengaturan proxy itu sendiri.

Mengapa community node melewati package proxy-from-env?

Banyak node pihak ketiga menggunakan library request kustom. Mereka tidak membaca variabel environment global. Anda harus memasukkan pengaturan routing secara manual di dalam parameter setiap custom node.

Bagaimana cara mempertahankan satu IP di seluruh workflow multi-node?

Gunakan credential generator bawaan untuk rotating residential proxy di dashboard CyberYozh Anda. Pilih pengaturan Custom duration untuk menginisialisasi Sticky session. Sistem menyediakan kredensial spesifik yang mengunci koneksi Anda ke satu alamat IP fisik untuk jangka waktu yang ditentukan.

Header Apache mana yang mencegah editor n8n dari freezing?

Interface menggunakan WebSocket untuk streaming log eksekusi. Konfigurasikan routing transparan untuk header Upgrade dan Connection. Editor akan menampilkan error disconnect siklis tanpa header tersebut.

Bisakah saya merutekan traffic database di luar gateway proxy global?

Ya. Anda menggunakan variabel sistem NO_PROXY. Masukkan localhost, 127.0.0.1, dan subnet mask Docker internal Anda. Request database akan melewati gateway eksternal.

Bagaimana cara memperbaiki error "connect ECONNREFUSED ::1:11434"?

Ini terjadi ketika sistem operasi Anda memiliki IPv6 yang diaktifkan, tetapi layanan lokal (seperti Ollama) hanya mendengarkan di IPv4. Ubah alamat host di pengaturan koneksi node Anda dari alias localhost ke alamat IPv4 eksplisit: 127.0.0.1.