gitwtfhub

wtf is arvancloud-bypass?

nabikaz/arvancloud-bypass — explained in plain English

Analysis updated 2026-05-18

23JavaScriptAudience · developerComplexity · 2/5LicenseSetup · easy

TL;DR

A lightweight Node.js library that solves ArvanCloud CDN's bot-check puzzle without needing a browser.

Mindmap

mindmap
  root((repo))
    What it does
      Detects challenge pages
      Solves JS puzzle
      Returns bypass cookies
    Tech stack
      JavaScript
      Node.js vm module
    Use cases
      Web scraping
      Automation scripts
      No browser needed
    Audience
      Developers
      Automation builders
    Setup
      Clone repo
      No dependencies
    API
      isArvanChallengePage
      solveArvanChallenge

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Fetch pages behind ArvanCloud's bot-detection without launching a browser.

REASON 2

Add automatic challenge-solving and cookie handling to a scraper.

REASON 3

Build a lightweight automation tool that talks to ArvanCloud-protected sites.

What's in the stack?

JavaScriptNode.js

How it stacks up

nabikaz/arvancloud-bypassavbiswas/llm_visualizerccpt5/comfyui-berninistudio
Stars232323
LanguageJavaScriptJavaScriptJavaScript
Setup difficultyeasymoderatemoderate
Complexity2/53/53/5
Audiencedeveloperdevelopervibe coder

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

No external dependencies, just clone and import the module.

MIT license: use freely for any purpose, including commercial use, as long as you keep the copyright notice.

Wtf does this do

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.

Yoink these prompts

Prompt 1
Show me how to use isArvanChallengePage and solveArvanChallenge with fetch.
Prompt 2
Help me integrate this library into my existing Node.js scraper.
Prompt 3
Explain how the sandboxed vm.createContext solving step works.
Prompt 4
Write an example script that retries a request after solving the challenge.

Frequently asked questions

wtf is arvancloud-bypass?

A lightweight Node.js library that solves ArvanCloud CDN's bot-check puzzle without needing a browser.

What language is arvancloud-bypass written in?

Mainly JavaScript. The stack also includes JavaScript, Node.js.

What license does arvancloud-bypass use?

MIT license: use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is arvancloud-bypass to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is arvancloud-bypass for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.