FlareSolverr - GitLite

KO | EN

gitlite — search

#javascript #react #ai #typescript #llm #android #deep-learning #linux #nodejs #windows #cli #kubernetes #awesome-list #open-source

FlareSolverr

(★ 15,251)

Cloudflare 보호를 우회하기 위한 프록시 서버

파일 탐색기

최종 버전 다운로드 (.zip)

- - bug_report.yml
  - config.yml
- - autotag.yml
  - release-docker.yml
  - release.yml
- cloudflare_captcha_hcaptcha_v1.html
- cloudflare_captcha_norobot_v1.html
- cloudflare_init_v1.html
- cloudflare_spinner_v1.html
- flaresolverr_logo.ico
- flaresolverr_logo.png
- flaresolverr_logo.svg
- - __init__.py
  - error_plugin.py
  - logger_plugin.py
  - prometheus_plugin.py
- - __init__.py
  - cdp.py
  - devtool.py
  - dprocess.py
  - options.py
  - patcher.py
  - reactor.py
  - webelement.py
- build_package.py
- dtos.py
- flaresolverr.py
- flaresolverr_service.py
- metrics.py
- sessions.py
- tests.py
- tests_sites.py
- utils.py
.dockerignore
.gitignore
CHANGELOG.md
docker-compose.yml
Dockerfile
flaresolverr.service
LICENSE
package.json
README.md
requirements.txt
test-requirements.txt

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# FlareSolverr
[![Latest release](https://img.shields.io/github/v/release/FlareSolverr/FlareSolverr)](https://github.com/FlareSolverr/FlareSolverr/releases)
[![Docker Pulls](https://img.shields.io/docker/pulls/flaresolverr/flaresolverr)](https://hub.docker.com/r/flaresolverr/flaresolverr)
[![Docker Stars](https://img.shields.io/docker/stars/flaresolverr/flaresolverr)](https://hub.docker.com/r/flaresolverr/flaresolverr)
[![GitHub issues](https://img.shields.io/github/issues/FlareSolverr/FlareSolverr)](https://github.com/FlareSolverr/FlareSolverr/issues)
[![GitHub pull requests](https://img.shields.io/github/issues-pr/FlareSolverr/FlareSolverr)](https://github.com/FlareSolverr/FlareSolverr/pulls)
[![GitHub Repo stars](https://img.shields.io/github/stars/FlareSolverr/FlareSolverr)](https://github.com/FlareSolverr/FlareSolverr)
[![ko-fi](https://ko-fi.com/img/githubbutton\_sm.svg)](https://ko-fi.com/ngosang)
FlareSolverr는 Cloudflare 및 DDoS-GUARD 보호 우회를 위한 프록시 서버입니다.
## 작동 방식
FlareSolverr는 프록시 서버를 시작하며, 적은 리소스를 사용하여 유휴 상태에서 사용자 요청을 대기합니다.
요청이 도착하면 [Selenium](https://www.selenium.dev)과 [undetected-chromedriver](https://github.com/ultrafunkamsterdam/undetected-chromedriver)를 사용하여 웹 브라우저(Chrome)를 생성합니다. 사용자 매개변수와 함께 URL을 열고 Cloudflare 챌린지가 해결될 때(또는 타임아웃될 때)까지 대기합니다. HTML 코드와 쿠키가 사용자에게 전송되며, 이 쿠키를 사용하여 다른 HTTP 클라이언트로 Cloudflare를 우회할 수 있습니다.
\*\*참고\*\*: 웹 브라우저는 많은 메모리를 소비합니다. RAM이 부족한 시스템에서 FlareSolverr를 실행하는 경우 한 번에 너무 많은 요청을 보내지 마세요. 요청마다 새로운 브라우저가 실행됩니다.
영구 세션을 사용하는 것도 가능합니다. 그러나 세션을 사용하는 경우 사용이 끝나는 즉시 닫아야 합니다.
## 설치
### Docker
프로젝트가 이미지에 이미 포함되어 있는 외부 브라우저에 의존하므로 Docker 컨테이너를 사용하여 설치하는 것이 좋습니다.
Docker 이미지는 다음 곳에서 제공됩니다:
- GitHub Registry => https://github.com/orgs/FlareSolverr/packages/container/package/flaresolverr
- DockerHub => https://hub.docker.com/r/flaresolverr/flaresolverr
지원되는 아키텍처는 다음과 같습니다:
| Architecture | Tag |
| ------------ | ------------ |
| x86 | linux/386 |
| x86-64 | linux/amd64 |
| ARM32 | linux/arm/v7 |
| ARM64 | linux/arm64 |
`docker-compose.yml` 설정 파일이 제공됩니다. 이 저장소를 복제한 후 `docker-compose up -d` \_(Compose V1)\_ 또는 `docker compose up -d` \_(Compose V2)\_를 실행하여 컨테이너를 시작하세요.
`docker cli`를 선호하는 경우 다음 명령어를 실행하세요:
\*\*Bash\*\*
```bash
docker run -d \
--name=flaresolverr \
-p 127.0.0.1:8191:8191 \
-e LOG\_LEVEL=info \
--restart unless-stopped \
ghcr.io/flaresolverr/flaresolverr:latest
```
\*\*Command Prompt or Powershell\*\*
```cmd
docker run -d --name=flaresolverr -p 127.0.0.1:8191:8191 -e LOG\_LEVEL=info --restart unless-stopped ghcr.io/flaresolverr/flaresolverr:latest
```
호스트 운영체제가 Debian인 경우 `libseccomp2` 버전이 2.5.x인지 확인하세요. `sudo apt-cache policy libseccomp2`로 버전을 확인할 수 있으며, `sudo apt install libseccomp2=2.5.1-1~bpo10+1` 또는 `sudo apt install libseccomp2=2.5.1-1+deb11u1`로 패키지를 업데이트할 수 있습니다.
업데이트 후 Docker 데몬과 컨테이너를 다시 시작하는 것을 잊지 마세요.
FlareSolverr는 악용될 수 있으므로 인터넷에 직접 노출하지 마세요.
### 사전 컴파일된 바이너리
> \*\*경고\*\*
> 사전 컴파일된 바이너리는 x64 아키텍처에서만 사용할 수 있습니다. 다른 아키텍처의 경우 Docker 이미지를 참조하세요.
Windows 사용자에게 권장되는 방식입니다.
- 릴리스 페이지에서 [FlareSolverr 실행 파일](https://github.com/FlareSolverr/FlareSolverr/releases)을 다운로드하세요. Windows x64 및 Linux x64용으로 제공됩니다.
- FlareSolverr 바이너리를 실행하세요. 환경 변수 섹션에서 구성을 변경하는 방법을 확인할 수 있습니다.
### 소스 코드에서 빌드
> \*\*경고\*\*
> 설치

소스 코드로 빌드하는 것은 x64 아키텍처에서만 작동합니다. 다른 아키텍처의 경우 Docker 이미지를 참고하세요.
- [Python 3.11](https://www.python.org/downloads/)을 설치합니다.
- [Chrome](https://www.google.com/intl/en\_us/chrome/)(모든 OS) 또는 [Chromium](https://www.chromium.org/getting-involved/download-chromium/)(Linux 전용, Windows에서는 작동하지 않음) 웹 브라우저를 설치합니다.
- (Linux 전용) [Xvfb](https://en.wikipedia.org/wiki/Xvfb) 패키지를 설치합니다.
- (macOS 전용) [XQuartz](https://www.xquartz.org/) 패키지를 설치합니다.
- 이 저장소를 복제(Clone)하고 해당 경로에서 셸(Shell)을 엽니다.
- FlareSolverr 종속성을 설치하려면 `pip install -r requirements.txt` 명령을 실행합니다.
- FlareSolverr를 시작하려면 `python src/flaresolverr.py` 명령을 실행합니다.
### 소스 코드로부터 빌드 (FreeBSD/TrueNAS CORE)
-필수 종속성을 설치하려면 `pkg install chromium python313 py311-pip xorg-vfbserver` 명령을 실행합니다.
- 이 저장소를 복제(Clone)하고 해당 경로에서 셸(Shell)을 엽니다.
- FlareSolverr 종속성을 설치하려면 `python3.11 -m pip install -r requirements.txt` 명령을 실행합니다.
- FlareSolverr를 시작하려면 `python3.11 src/flaresolverr.py` 명령을 실행합니다.
### Systemd 서비스
참고용으로 예제 Systemd 유닛 파일인 `flaresolverr.service`를 제공합니다. 경로, 사용자 및 환경 변수 등 필요에 맞게 파일을 수정해야 합니다.
## 사용법
Bash 요청 예제:
```bash
curl -L -X POST 'http://localhost:8191/v1' \
-H 'Content-Type: application/json' \
--data-raw '{
"cmd": "request.get",
"url": "http://www.google.com/",
"maxTimeout": 60000
}'
```
Python 요청 예제:
```py
import requests
url = "http://localhost:8191/v1"
headers = {"Content-Type": "application/json"}
data = {
"cmd": "request.get",
"url": "http://www.google.com/",
"maxTimeout": 60000
}
response = requests.post(url, headers=headers, json=data)
print(response.text)
```
PowerShell 요청 예제:
```ps1
$body = @{
cmd = "request.get"
url = "http://www.google.com/"
maxTimeout = 60000
} | ConvertTo-Json
irm -UseBasicParsing 'http://localhost:8191/v1' -Headers @{"Content-Type"="application/json"} -Method Post -Body $body
```
### 명령어
#### + `sessions.create`
`sessions.destroy`로 파괴할 때까지 쿠키를 유지하는 새로운 브라우저 인스턴스를 실행합니다.
이렇게 하면 챌린지를 반복해서 해결할 필요가 없으며, 브라우저가 사용할 쿠키를 계속해서 보낼 필요도 없으므로 매우 유용합니다.
또한 모든 요청마다 새로운 브라우저 인스턴스를 실행할 필요가 없으므로 요청 속도가 빨라집니다.
| 매개변수 | 설명 |
| --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| session | 선택 사항. 인스턴스에 할당할 세션 ID입니다. 설정하지 않으면 임의의 UUID가 할당됩니다. |
| proxy | 선택 사항, 기본값은 비활성화 상태입니다. 예시: `"proxy": {"url": "http://127.0.0.1:8888"}`. URL에 프록시 스키마(`http://`, `socks4://` 또는 `socks5://`)를 포함해야 합니다. 인증(사용자 이름/비밀번호)이 지원됩니다. 예시: `"proxy": {"url": "http://127.0.0.1:8888", "username": "testuser", "password": "testpass"}` |
#### + `sessions.list`
활성 상태인 모든 세션의 목록을 반환합니다. 현재 실행 중인 세션 수가 궁금할 때 디버깅용으로 주로 사용됩니다.
너무 많은 세션은 컴퓨터 속도를 저하시킬 수 있으므로, 사용을 마친 후에는 항상 각 세션을 올바르게 닫아야 합니다.
응답 예시:
```json
{
"sessions": ["session\_id\_1", "session\_id\_2", "session\_id\_3..."]
}
```
#### + `sessions.destroy`
브라우저 인스턴스를 올바르게 종료하고 이와 연관된 모든 파일을 제거하여 새로운 세션을 위한 리소스를 확보합니다. 세션을 더 이상 사용할 필요가 없으면 반드시 닫아야 합니다.
| 매개변수 | 설명 |
| --------- | --------------------------------------------- |
| session | 파괴하려는 세션 ID입니다. |
#### + `re

`request.get`
| 매개변수 | 설명 |
| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| url | 필수 |
| session | 선택 사항. 기존 브라우저 인스턴스에서 요청을 보냅니다. 전달되지 않으면 요청이 완료된 직후 소멸되는 임시 인스턴스를 생성합니다. |
| session\_ttl\_minutes | 선택 사항. FlareSolverr는 제공된 TTL(분 단위)을 기반으로 만료된 세션을 자동으로 순환합니다. |
| maxTimeout | 선택 사항, 기본값 60000. 챌린지를 해결하기 위한 최대 제한 시간(밀리초)입니다. |
| cookies | 선택 사항. 헤드리스 브라우저에서 사용됩니다. 예: `"cookies": [{"name": "cookie1", "value": "value1"}, {"name": "cookie2", "value": "value2"}]`. |
| returnOnlyCookies | 선택 사항, 기본값 false. 쿠키만 반환합니다. 응답 데이터, 헤더 및 응답의 기타 부분은 제거됩니다. |
| returnScreenshot | 선택 사항, 기본값 false. 모든 챌린지와 대기 시간이 완료된 후 최종 렌더링된 페이지의 스크린샷을 캡처합니다. 스크린샷은 응답의 `screenshot` 필드에 Base64로 인코딩된 PNG 문자열로 반환됩니다. |
| proxy | 선택 사항, 기본값 비활성화. 예: `"proxy": {"url": "http://127.0.0.1:8888"}`. URL에 프록시 스키마(`http://`, `socks4://` 또는 `socks5://`)를 포함해야 합니다. 인증(사용자 이름/비밀번호)은 지원되지 않습니다. (`session` 매개변수가 설정된 경우 프록시는 무시되며, 세션별 프록시는 `sessions.create`에서 설정할 수 있습니다.) |
| waitInSeconds | 선택 사항, 기본값 없음. 챌린지를 해결한 후 결과가 반환되기 전에 대기할 시간(초)입니다. 동적 콘텐츠를 로드하는 데 유용합니다. |
| disableMedia | 선택 사항, 기본값 false. true인 경우 FlareSolverr는 탐색 속도를 높이기 위해 미디어 리소스(이미지, CSS, 폰트)가 로드되지 않도록 방지합니다. |
| tabs\_till\_verify | 선택 사항, 기본값 없음. turnstile 캡차를 확인하기 위해 `Tab` 버튼을 눌러야 하는 횟수입니다. 캡차를 확인한 후 결과는 solution 내의 `turnstile\_token`에 저장됩니다. |
> \*\*경고\*\*
> 스크립트에서 Cloudflare clearance 쿠키를 사용하려면 FlareSolverr User-Agent도 함께 사용해야 합니다. 일치하지 않으면 챌린지 페이지가 나타납니다.
위의 `curl` 실행 결과 응답 예시:
```json
{
"solution": {
"url": "https://www.google.com/?gws\_rd=ssl",
"status": 200,
"headers": {
"status": "200",
"date": "Thu, 16 Jul 2020 04:15:49 GMT",
"expires": "-1",
"cache-control": "private, max-age=0",
"content-type": "text/html; charset=UTF-8",
"strict-transport-security": "max-age=31536000",
"p3p": "CP=\"This is not a P3P policy! See g.co/p3phelp for more info.\"",
"content-encoding": "br",
"server": "gws",
"content-length": "61587",
"x-xss-protection": "0",
"x-frame-options": "SAMEORIGIN",
"set-cookie": "1P\_JAR=2020-07-16-04; expires=Sat..."
},
"response": "
...",
"cookies": [
{
"name": "NID",
"value": "204=QE3Ocq15XalczqjuDy52HeseG3zAZuJzID3R57...",
"domain": ".google.com",
"path": "/",
"expires": 1610684149.307722,
"size": 178,
"httpOnly": true,
"secure": true,
"session": false,
"sameSite": "None"
},
{
"name": "1P\_JAR",
"value": "2020-07-16-04",
"domain": ".google.com",
"path": "/",
"expires": 1597464949.307626,
"size": 19,
"httpOnly": false,
"secure": true,
"session": false,
"sameSite": "None"
}
],
"userAgent": "Windows NT 10.0; Win64; x64) AppleWebKit/5...",
"turnstile\_token": "03AGdBq24k3lK7JH2v8uN1T5F..."
},
"status": "ok",
"message": "",
"startTimestamp": 1594872947467,
"endTimestamp": 1594872949617,
"version": "1.0.0"
}
```
### + `request.post`
이 기능은 `request.get`과 유사하게 작동하며, postData 매개변수가 추가됩니다. 참고로 `tabs\_till\_verify`는 현재 다음 조건에서만 지원됩니다.

r GET 요청에는 추가 인수가 하나 필요합니다.
| 매개변수 | 설명 |
| --------- | ------------------------------------------------------------------------ |
| postData | `application/x-www-form-urlencoded` 형식의 문자열이어야 합니다. 예시: `a=b&c=d` |
## 환경 변수
| 이름 | 기본값 | 설명 |
| ------------------ | ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| LOG\_LEVEL | info | 로깅 상세 정도. 더 자세한 정보를 보려면 `LOG\_LEVEL=debug`를 사용하세요. |
| LOG\_FILE | none | 로그를 파일로 저장할 경로. 예시: `/config/flaresolverr.log`. |
| LOG\_HTML | false | 디버깅 전용. `true`로 설정하면 프록시를 통과하는 모든 HTML이 `debug` 수준으로 콘솔에 기록됩니다. |
| PROXY\_URL | none | 프록시 URL. 사용되는 경우 `request` 또는 `sessions` 프록시에 의해 덮어씌워집니다. 예시: `http://127.0.0.1:8080`. |
| PROXY\_USERNAME | none | 프록시 사용자 이름. 사용되는 경우 `request` 또는 `sessions` 프록시에 의해 덮어씌워집니다. 예시: `testuser`. |
| PROXY\_PASSWORD | none | 프록시 비밀번호. 사용되는 경우 `request` 또는 `sessions` 프록시에 의해 덮어씌워집니다. 예시: `testpass`. |
| CAPTCHA\_SOLVER | none | 캡차 해결 방식. 캡차가 감지되었을 때 사용됩니다. Captcha Solvers 섹션을 참고하세요. |
| TZ | UTC | 로그 및 웹 브라우저에서 사용할 시간대. 예시: `TZ=Europe/London`. |
| LANG | none | 웹 브라우저에서 사용할 언어. 예시: `LANG=en\_GB`. |
| HEADLESS | true | 디버깅 전용. 웹 브라우저를 헤드리스 모드로 실행할지 화면에 표시할지 여부. |
| DISABLE\_MEDIA | false | 네트워크 대역폭을 절약하기 위해 웹 브라우저에서 이미지, CSS 및 기타 미디어 로딩을 비활성화합니다. |
| TEST\_URL | https://www.google.com | FlareSolverr는 웹 브라우저가 정상 작동하는지 확인하기 위해 시작 시 요청을 보냅니다. 거주 중인 국가에서 해당 URL이 차단된 경우 변경할 수 있습니다. |
| PORT | 8191 | 수신 대기 포트. Docker에서 실행 중인 경우 변경할 필요가 없습니다. |
| HOST | 0.0.0.0 | 수신 대기 인터페이스. Docker에서 실행 중인 경우 변경할 필요가 없습니다. |
| PROMETHEUS\_ENABLED | false | Prometheus 익스포터 활성화. 아래의 Prometheus 섹션을 참고하세요. |
| PROMETHEUS\_PORT | 8192 | Prometheus 익스포터 수신 대기 포트. 아래의 Prometheus 섹션을 참고하세요. |
환경 변수는 운영체제에 따라 다르게 설정됩니다. 몇 가지 예시:
- Docker: 이 문서의 Docker 섹션을 참고하세요. 환경 변수는 `docker-compose.yml` 파일이나 Docker CLI 명령에서 설정할 수 있습니다.
- Linux: `export LOG\_LEVEL=debug`를 실행한 후 동일한 셸에서 `flaresolverr`를 실행하세요.
- Windows: `cmd.exe`를 열고 `set LOG\_LEVEL=debug`를 실행한 후 동일한 셸에서 `flaresolverr.exe`를 실행하세요.
## Prometheus 익스포터
FlareSolverr용 Prometheus 익스포터는 기본적으로 비활성화되어 있습니다. 환경 변수 `PROMETHEUS\_ENABLED`를 통해 활성화할 수 있습니다. Docker를 사용하는 경우 `PROMETHEUS\_PORT`를 개방(expose)해야 합니다.
지표 예시:
```shell
# HELP flaresolverr\_request\_total Total requests with result
# TYPE flaresolverr\_request\_total counter
flaresolverr\_request\_total{domain="nowsecure.nl",result="solved"} 1.0
# HELP flaresolverr\_request\_created Total requests with result
# TYPE flaresolverr\_request\_created gauge
flaresolverr\_request\_created{domain="nowsecure.nl",result="solved"} 1.690141657157109e+09
# HELP flaresolverr\_request\_duration Request duration in seconds
# TYPE flaresolverr\_request\_duration histogram
flaresolverr\_request\_duration\_bucket{domain="nowsecure.nl",le="0.0"} 0.0
flaresolverr\_request\_duration\_bucket{domain="nowsecure.nl",le="10.0"} 1.0
flaresolverr\_request\_duration\_bucket{domain="nowsecure.nl",le="25.0"} 1.0
flaresolverr\_request\_duration\_bucket{domain="nowsecure.nl",le="50.0"} 1.0
flaresolverr\_request\_duration\_bucket{domain="nowsecure.nl",le="+Inf"} 1.0
flaresolverr\_request\_duration\_count{domain="nowsecure.nl"} 1.0
flaresolverr\_request\_duration\_sum{domain="nowsecure.nl"}

5.858
# HELP flaresolverr\_request\_duration\_created Request duration in seconds
# TYPE flaresolverr\_request\_duration\_created gauge
flaresolverr\_request\_duration\_created{domain="nowsecure.nl"} 1.6901416571570296e+09
```
## Captcha Solvers
> \*\*Warning\*\*
> 현재로서는 어떤 캡차 해결사(captcha solver)도 작동하지 않습니다. 열려 있는 이슈(open issues)에서 상태를 확인할 수 있습니다. 어떤 도움이라도 환영합니다.
때로는 Cloudflare가 수학적 연산 및 브라우저 테스트뿐만 아니라 사용자에게 캡차(captcha) 해결을 요구하기도 합니다.
이 경우 FlareSolverr는 `Captcha detected but no automatic solver is configured.` 오류를 반환합니다.
`/captcha` 디렉터리 내의 어댑터 중 하나의 파일 이름으로 환경 변수 `CAPTCHA\_SOLVER`를 설정하여 CAPTCHA를 자동으로 해결하도록 FlareSolverr를 사용자 지정할 수 있습니다.
## Related projects
- C# implementation => https://github.com/FlareSolverr/FlareSolverrSharp