Tidak dapat mendapatkan IP client asli
Gejala
Setelah edge function memproses permintaan, alamat IP yang diambil dari header ali-real-client-ip selalu berupa alamat IP internal, bukan IP klien asli.
Penyebab
Saat menggunakan fetch mode, edge function bertindak sebagai proxy perantara yang meneruskan permintaan ke origin. Origin menerima permintaan dari edge runtime, sehingga menyebabkan header ali-real-client-ip mengembalikan alamat IP internal edge node, bukan IP klien asli.
Solusi
Aktifkan Bypass Mode untuk mencegah edge function memproses permintaan. Hal ini memastikan IP klien asli tetap terjaga. Untuk instruksi terperinci, lihat bagian mode bypass di Konfigurasi Domain.
Tabel berikut menjelaskan perbedaan utama antara fetch mode dan bypass mode.
Mode | IP Asli | Kasus penggunaan |
fetch mode | Mengembalikan alamat IP internal | Skenario di mana edge function perlu memodifikasi konten respons, seperti kompresi atau penulisan ulang. |
bypass mode | Mengembalikan IP client asli | Skenario ringan seperti autentikasi dan logging. |
Untuk menerapkan logika ini dalam kode edge function Anda, ubah entry point dari async fetch(request) menjadi async bypass(request). Objek ResponseBypass, sebuah utilitas bawaan dalam ESA edge runtime, mengontrol apakah sebuah permintaan melewati pemrosesan fungsi:
// Fungsi entri untuk bypass mode
async bypass(request) {
// Jalankan logika pra-pemrosesan, seperti autentikasi.
const isAuthPassed = true; // Ganti dengan logika autentikasi aktual Anda.
if (isAuthPassed) {
// Autentikasi berhasil. Kembalikan true untuk melewati pemrosesan fungsi.
return new ResponseBypass(true);
} else {
// Autentikasi gagal. Kembalikan false dan tentukan kode status kegagalan.
return new ResponseBypass(false, { status: 403 });
}
}
Saat bypass mode diaktifkan, edge function tidak menerima badan permintaan. Jika Anda perlu membaca badan permintaan, misalnya dari permintaan POST, gunakan fetch mode sebagai gantinya.
Bypass mode ditujukan untuk tugas ringan seperti autentikasi dan logging, bukan untuk memodifikasi respons dengan kompresi atau penulisan ulang, dan mode ini tidak mengonsumsi waktu CPU untuk pemrosesan respons.
Verifikasi
Setelah mengaktifkan bypass mode, verifikasi bahwa header ali-real-client-ip mengembalikan IP klien asli menggunakan salah satu metode berikut:
Gunakan perintah curl untuk memeriksa header respons:
curl -I https://your-domain.comPeriksa nilai
ali-real-client-ipdi header respons. Nilainya harus berupa IP publik klien, bukan IP internal.Di developer tools browser, buka panel Network dan periksa nilai
ali-real-client-ipdi header respons.
Dapatkah kunci variabel diubah?
Tidak, kunci tidak dapat diubah setelah dibuat. Jika Anda perlu melakukan perubahan, hapus kunci tersebut dan tambahkan yang baru.
Mengapa saya membaca undefined?
Jika versi saat ini tidak terikat pada variabel, atau kunci hanya dikonfigurasi di lingkungan lain, kode akan mengembalikan undefined tanpa memunculkan pengecualian. Periksa apakah kunci telah dikonfigurasi di lingkungan target, dan pastikan Anda telah mendeploy ulang versi tersebut setelah mengonfigurasi kunci.
Apakah variabel terikat pada versi?
Ya. Variabel fungsi terikat bersama dengan sebuah versi. Jika Anda mengubah variabel di Konsol tanpa merilis versi baru, versi yang sedang berjalan tidak akan mendeteksi perubahan tersebut.
Bagaimana jika variabel terenkripsi gagal didekripsi?
Jika nilai kunci terenkripsi tidak dapat didekripsi, edge function akan mengembalikan error 599. Periksa apakah nilai variabel telah dienkripsi dan ditulis dengan benar.
Bagaimana cara beralih ke bypass mode dengan memodifikasi kode saya?
Ambil contoh Penandatanganan URL Tipe A:
Ubah fungsi entri dari
async fetch()menjadiasync bypass().Fungsi harus mengembalikan nilai yang dikonstruksi dengan
new ResponseBypass(), yang mengambil dua parameter:Parameter pertama adalah boolean (true atau false) yang menunjukkan apakah autentikasi berhasil.
Jika autentikasi gagal (false), Anda dapat meneruskan parameter
statuskedua untuk menentukan kode status yang akan dikembalikan ke klien.
Contoh kode untuk penandatanganan Tipe A asli | Contoh kode untuk penandatanganan Tipe A dengan bypass mode |
Bagaimana cara mengubah pengikatan Nama domain?
Jika domain dan rute Anda saat ini tidak lagi memenuhi kebutuhan, edit atau hapus keduanya.
Masuk ke ESA console, dan di panel navigasi sebelah kiri, pilih Edge Computing and AI > Functions & Pages. Klik instans Functions & Pages target.
Klik tab Domains.
Pada tab Domain Names, Anda dapat menghapus Nama domain yang terikat lalu menambahkannya kembali. Untuk rute yang terikat, Anda dapat mengeditnya, atau menghapusnya dan menambahkannya kembali.
Bagaimana cara mengikat Functions and Pages langsung ke domain root?
Untuk mengikat Functions and Pages langsung ke domain root seperti example.com, gunakan salah satu metode berikut:
Custom Domains: Pilih Add Domain Name dan masukkan
@.example.comsebagai Nama domain.Routes: Pilih Add Route. Untuk situs, gunakan Select Website untuk memilih
example.com. Untuk Route Mode, pilih Simple Mode dan biarkan Route Prefix kosong.
Kode status tidak valid
Pesan error
HttpBody.constructor: invalid status codePenyebab
Kode status 596, 597, 598, dan 599 dicadangkan untuk penggunaan internal oleh edge runtime. Jangan mengembalikan kode status ini dalam fungsi Anda.
Tidak ada alamat proxy yang tersedia
Pesan error
unhandled error(13485,13477)@: Error: io error@: no available fetch proxy address now\nstacktrace:\nN/A\nPenyebab 1
URL yang diteruskan ke cache.put diawali dengan https. Cache API tidak mendukung https. Ubah https menjadi http.
Penyebab 2
Permintaan fetch menargetkan domain yang tidak dikelola oleh ESA, tetapi opsi cdnProxy:true diatur. Untuk memperbaiki hal ini, tambahkan domain ke layanan ESA Anda atau hapus konfigurasi cdnProxy:true.
Koneksi terputus
Pesan error
Error: unhandled error(13486,13505)@: Broken connection, unexpected EOFPenyebab
Origin menutup koneksi saat edge function sedang menerima data darinya.