What is arvancloud-bypass?

ArvanCloud Bypass is a JavaScript library (written in Node.js) that helps automated scripts and bots get past the bot-detection challenges used by ArvanCloud, a content delivery network (CDN). A CDN is a system that speeds up websites and also shields them from unwanted bots by showing a JavaScript puzzle that only real browsers typically solve. This library solves that puzzle without needing an actual browser. The library exposes two simple functions: one to detect if a page is showing an ArvanCloud challenge, and one to solve that challenge. When your code fetches a protected webpage and gets a challenge page back, you call the solver, which extracts the embedded JavaScript challenge from the HTML, runs it in an isolated sandbox environment using Node.js's built-in virtual machine module, intercepts the cookies the challenge script generates, and returns those cookies so your next request can pass through as if it came from a real browser. You would use this tool when building a web scraper, data collector, or automation script that needs to access websites protected by ArvanCloud without launching a full browser. It has no external dependencies, making it lightweight and easy to drop into any existing Node.js HTTP workflow. The README includes working code examples showing the full request-detect-solve-retry flow. The project is written in JavaScript and requires Node.js.