All Products
Search
Document Center

Edge Security Acceleration:FAQ Edge function

Last Updated:Oct 17, 2026

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 });
  }
}
Catatan
  • 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.com

    Periksa nilai ali-real-client-ip di header respons. Nilainya harus berupa IP publik klien, bukan IP internal.

  • Di developer tools browser, buka panel Network dan periksa nilai ali-real-client-ip di 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() menjadi async 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 status kedua untuk menentukan kode status yang akan dikembalikan ke klien.

Contoh kode untuk penandatanganan Tipe A asli

import { createHash } from "node:crypto";

async function handleRequest(request) {
  const url = new URL(request.url);
  const path = url.pathname;
  const delta = 3600;

  const authKeyTypeA = url.searchParams.get('auth_key');

  const privateKey = 'your_secret_key'
  const currentTimestamp = Math.floor(Date.now() / 1000);

  if (!authKeyTypeA) {
    // Dalam skenario kegagalan autentikasi, edge node mengembalikan error 403 ke client secara default.
    return new Response('Unauthorized', { 
      status: 401,
    });
  }

  const [timestamp, rand, uid, signature] = authKeyTypeA.split('-');

  if (currentTimestamp > parseInt(timestamp)+ delta) {
    // Dalam skenario kegagalan autentikasi, edge node mengembalikan error 403 ke client secara default.
    return new Response('Link expired', {
      status: 403,
    });
  }

  const signString = [path, timestamp, rand, uid, privateKey].join('-');

  const md5 = createHash('md5').update(signString).digest('hex');

  if (md5 !== signature) {
  
    return new Response('Unauthorized', {
      status: 401
    });
  }

  // Jika resource berada di domain lain, ambil dan kembalikan responsnya.
  // const yourUrl = `https://your-dcdn-domain.com${path}${url.search}`
  // const cdnResponse = await fetch(yourUrl, request)
  // return new Response(cdnResponse.body, cdnResponse)

  // Dalam kebanyakan kasus, mengambil dari origin sudah cukup.
  return fetch(request.url)
}

export default {
  async fetch(request) {
    return handleRequest(request)
  }
}

Contoh kode untuk penandatanganan Tipe A dengan bypass mode

import { createHash } from "node:crypto";

async function handleRequest(request) {
  const url = new URL(request.url);
  const path = url.pathname;
  const delta = 3600;

  const authKeyTypeA = url.searchParams.get("auth_key");

  const privateKey = "your_secret_key";
  const currentTimestamp = Math.floor(Date.now() / 1000);

  if (!authKeyTypeA) {
    // Autentikasi gagal. Jika Anda meneruskan false, edge node mengembalikan error 403 ke client secara default.
    return new ResponseBypass(false, {
      status: 401,
    });
  }

  const [timestamp, rand, uid, signature] = authKeyTypeA.split("-");

  if (currentTimestamp > parseInt(timestamp) + delta) {
    // Autentikasi gagal. Jika Anda meneruskan false, edge node mengembalikan error 403 ke client secara default.
    return new ResponseBypass(false, {
      status: 403,
    });
  }

  const signString = [path, timestamp, rand, uid, privateKey].join("-");

  const md5 = createHash("md5").update(signString).digest("hex");

  if (md5 !== signature) {
    // Autentikasi gagal. Jika Anda meneruskan false, edge node mengembalikan error 403 ke client secara default.
    return new ResponseBypass(false, {
      status: 401,
    });
  }

  // Autentikasi berhasil. Jika Anda meneruskan true, permintaan diteruskan ke origin, dan respons tidak lagi diproses oleh fungsi ini.
  const resSuccess = new ResponseBypass(true);
  return resSuccess;
}

export default {
  async bypass(request) {
    return handleRequest(request);
  },
};

Bagaimana cara mengubah pengikatan Nama domain?

Jika domain dan rute Anda saat ini tidak lagi memenuhi kebutuhan, edit atau hapus keduanya.

  1. Masuk ke ESA console, dan di panel navigasi sebelah kiri, pilih Edge Computing and AI > Functions & Pages. Klik instans Functions & Pages target.

  2. Klik tab Domains.

  3. 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.com sebagai 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 code

Penyebab

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\n

Penyebab 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 EOF

Penyebab

Origin menutup koneksi saat edge function sedang menerima data darinya.