docs: Xvfb를 사용한 서버 환경 해결책 추가

- 가상 디스플레이(Xvfb)를 사용하여 서버에서 GUI 브라우저 실행
- HEADLESS_BROWSER=false와 함께 사용하여 reCAPTCHA 우회
This commit is contained in:
Claude-51124 2025-09-18 23:02:39 +09:00
parent 912098b66d
commit 93871d5add

View File

@ -69,6 +69,26 @@ environment:
- 실제 브라우저 UI를 표시하여 reCAPTCHA 우회
- 단점: 서버 환경에서는 사용 불가
### 1-1. 서버 환경 해결책 - Xvfb (가상 디스플레이)
```dockerfile
# Dockerfile에 추가
RUN apt-get update && apt-get install -y \
xvfb \
&& rm -rf /var/lib/apt/lists/*
```
```yaml
# docker-compose.yml 수정
command: xvfb-run python -m uvicorn app.main:app --host 0.0.0.0 --port 8511
environment:
- HEADLESS_BROWSER=false # 실제 브라우저 사용
```
- **Xvfb(X Virtual Framebuffer)**: 가상 디스플레이 서버
- 서버 환경에서 GUI 애플리케이션을 메모리상 가상 화면에서 실행
- 실제 Chrome 브라우저가 가상 디스플레이에서 실행되어 reCAPTCHA 우회
- 장점: 서버 환경에서도 GUI 브라우저 실행 가능
### 2. 중기 해결책 - 수동 Stealth 스크립트 적용
```python
# publisher_service.py에 추가