Refactor Playwright to singleton browser with tab-based crawling
- Add PlaywrightBrowserService: singleton Chromium browser with auto-recovery - Refactor WebCrawlerService/YouTubeTranscriptService to use shared browser tabs - Fix YouTube transcript: extract from DOM panel + fmt=json3 fallback - Keep browser window alive (about:blank instead of page.close) - Add docs: X Window setup, operation manual, crawling guide Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
223
docs/crawling-guide.md
Normal file
223
docs/crawling-guide.md
Normal file
@@ -0,0 +1,223 @@
|
||||
# 웹 크롤링 & YouTube 자막 추출 가이드
|
||||
|
||||
## 아키텍처 개요
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────┐
|
||||
│ Spring Boot Application │
|
||||
│ │
|
||||
│ ┌──────────────────────────────────────────────┐ │
|
||||
│ │ PlaywrightBrowserService │ │
|
||||
│ │ (싱글톤 Chromium 브라우저, 앱 기동 시 1회) │ │
|
||||
│ │ - @PostConstruct: 브라우저 launch │ │
|
||||
│ │ - @PreDestroy: 브라우저 close │ │
|
||||
│ │ - 탭(Page) 단위로 작업 수행 │ │
|
||||
│ │ - 브라우저 죽으면 자동 재시작 │ │
|
||||
│ └──────────┬───────────────┬────────────────────┘ │
|
||||
│ │ │ │
|
||||
│ ┌──────────▼──────┐ ┌────▼──────────────────┐ │
|
||||
│ │ WebCrawlerService│ │YouTubeTranscriptService│ │
|
||||
│ │ (일반 웹페이지) │ │ (YouTube 자막) │ │
|
||||
│ └─────────────────┘ └───────────────────────┘ │
|
||||
└─────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
## 1. PlaywrightBrowserService (싱글톤 브라우저)
|
||||
|
||||
### 핵심 설계
|
||||
|
||||
- **싱글톤 패턴**: 앱 기동 시 Chromium을 한 번 띄우고 종료 시까지 유지
|
||||
- **탭 기반 작업**: 각 크롤링 요청마다 새 탭(`Page`)을 열고, 완료 후 `about:blank`로 이동 (브라우저 창 유지)
|
||||
- **자동 복구**: `ensureBrowserAlive()`로 브라우저 crash 시 자동 재시작
|
||||
- **쿠키 로딩**: `cookies.txt`에서 YouTube/Google 쿠키를 읽어 봇 차단 우회
|
||||
|
||||
### 왜 싱글톤인가?
|
||||
|
||||
| 항목 | 매번 브라우저 생성 | 싱글톤 브라우저 |
|
||||
|------|-------------------|----------------|
|
||||
| 기동 시간 | 요청마다 2~3초 | 최초 1회만 |
|
||||
| 메모리 | 매번 할당/해제 | 안정적 유지 |
|
||||
| 쿠키/세션 | 매번 재로딩 | 유지됨 |
|
||||
| VNC 디버깅 | 창이 뜨고 사라짐 | 항상 떠있어 관찰 가능 |
|
||||
|
||||
### 주요 메서드
|
||||
|
||||
```java
|
||||
// 새 탭 열기 (호출자가 사용 후 about:blank 또는 close)
|
||||
Page openPage(String url, int timeoutMs)
|
||||
Page openPage(String url) // 기본 30초
|
||||
|
||||
// 브라우저 페이지 내에서 JS fetch 실행 (쿠키/세션 유지)
|
||||
String fetchInPage(Page page, String url)
|
||||
```
|
||||
|
||||
### 탭 정리 방식
|
||||
|
||||
```java
|
||||
// page.close() 대신 about:blank로 이동 → 브라우저 창이 유지됨
|
||||
try {
|
||||
page.navigate("about:blank");
|
||||
} catch (Exception ignored) {
|
||||
page.close(); // about:blank 실패 시에만 탭 닫기
|
||||
}
|
||||
```
|
||||
|
||||
### 쿠키 파일 형식 (`cookies.txt`)
|
||||
|
||||
Netscape 쿠키 형식 (탭 구분):
|
||||
|
||||
```
|
||||
.youtube.com / FALSE TRUE 1780000000 COOKIE_NAME COOKIE_VALUE
|
||||
```
|
||||
|
||||
필드 순서: `domain`, `path`, `hostOnly(무시)`, `secure`, `expiry(무시)`, `name`, `value`
|
||||
|
||||
YouTube/Google 도메인 쿠키만 로드됨.
|
||||
|
||||
## 2. WebCrawlerService (일반 웹페이지 크롤링)
|
||||
|
||||
### 3단계 Fallback 전략
|
||||
|
||||
```
|
||||
1차: Jsoup (경량 HTML 파서)
|
||||
↓ 실패 또는 유효하지 않은 콘텐츠
|
||||
2차: Jina Reader API (외부 서비스)
|
||||
↓ 실패 또는 유효하지 않은 콘텐츠
|
||||
3차: Playwright (싱글톤 브라우저 탭)
|
||||
```
|
||||
|
||||
### 1차: Jsoup
|
||||
|
||||
- Java 기반 HTML 파서, 가장 빠르고 가벼움
|
||||
- JavaScript 렌더링 불가 → SPA 사이트에서는 빈 콘텐츠 반환
|
||||
- `nav, footer, header, script, style` 등 불필요 요소 제거 후 본문 추출
|
||||
|
||||
### 2차: Jina Reader
|
||||
|
||||
- `https://r.jina.ai/{URL}` 형태로 외부 서비스 호출
|
||||
- JavaScript 렌더링 지원, Markdown/텍스트 형식 반환
|
||||
- API 키 설정 시 인증 헤더 추가 가능
|
||||
|
||||
### 3차: Playwright
|
||||
|
||||
- 싱글톤 브라우저에서 새 탭으로 페이지 로드
|
||||
- JavaScript 렌더링 완료 후 `NETWORKIDLE` 대기
|
||||
- `page.evaluate()`로 DOM에서 직접 본문 텍스트 추출:
|
||||
|
||||
```javascript
|
||||
() => {
|
||||
// 불필요 요소 제거
|
||||
['nav','footer','header','script','style','.ad','#cookie-banner','.sidebar','.comments']
|
||||
.forEach(sel => document.querySelectorAll(sel).forEach(el => el.remove()));
|
||||
// 본문 영역 우선, 없으면 body 전체
|
||||
const article = document.querySelector('article, main, .post-content, .article-body, .entry-content');
|
||||
return (article || document.body).innerText;
|
||||
}
|
||||
```
|
||||
|
||||
### 유효성 검증
|
||||
|
||||
모든 단계에서 `isValidContent()` 검증:
|
||||
- 최소 100자 이상
|
||||
- 에러 페이지 패턴 감지 (403, captcha, "checking your browser" 등)
|
||||
|
||||
## 3. YouTubeTranscriptService (YouTube 자막 추출)
|
||||
|
||||
### 2단계 Fallback 전략
|
||||
|
||||
```
|
||||
1차: youtube-transcript-api 라이브러리
|
||||
↓ 실패 (봇 차단 등)
|
||||
2차: Playwright (싱글톤 브라우저)
|
||||
├─ 방법 A: 자막 패널 DOM 추출
|
||||
└─ 방법 B: Caption URL + fmt=json3
|
||||
```
|
||||
|
||||
### 1차: youtube-transcript-api
|
||||
|
||||
- `io.github.thoroldvix` 라이브러리 사용
|
||||
- 수동 자막(manual) 우선, 없으면 자동 생성(generated) 시도
|
||||
- 언어 우선순위: `ko` → `en`
|
||||
- **한계**: YouTube가 서버 IP를 봇으로 판정하면 실패
|
||||
|
||||
### 2차: Playwright Fallback
|
||||
|
||||
#### 방법 A: 자막 패널 DOM 추출 (우선)
|
||||
|
||||
YouTube 페이지에서 '스크립트 표시' 버튼을 클릭하여 자막 패널을 열고 DOM에서 텍스트를 직접 추출한다.
|
||||
|
||||
**흐름**:
|
||||
1. YouTube 동영상 페이지 로드 (NETWORKIDLE 대기)
|
||||
2. 2초 대기 후 '스크립트 표시' / 'Show transcript' 버튼 탐색 및 클릭
|
||||
3. 버튼 못 찾으면 설명란 '더보기' 펼치기 → 다시 탐색
|
||||
4. 3초 대기 (자막 패널 로드)
|
||||
5. `ytd-transcript-segment-renderer .segment-text` 등 CSS 셀렉터로 자막 텍스트 추출
|
||||
|
||||
**장점**: 브라우저의 쿠키/세션이 완전히 유지되어 봇 차단 우회 가능
|
||||
|
||||
#### 방법 B: Caption URL + fmt=json3 (보조)
|
||||
|
||||
방법 A가 실패하면 HTML에서 `captionTracks`를 파싱하여 caption URL을 추출하고, `&fmt=json3` 파라미터를 추가하여 JSON 형식으로 자막을 요청한다.
|
||||
|
||||
**왜 fmt=json3인가?**
|
||||
- 기본 XML 형식(`fmt` 없음)은 서명된 URL이 서버 IP에 바인딩되어 빈 응답을 반환하는 경우가 있음
|
||||
- `fmt=json3`은 `{"events":[{"segs":[{"utf8":"text"}]}]}` 형식으로 반환
|
||||
|
||||
**Caption URL 추출 과정**:
|
||||
1. `page.content()`로 HTML 획득
|
||||
2. `"captionTracks":\s*\[(.*?)]` 정규식으로 JSON 추출
|
||||
3. 언어 우선순위에 따라 URL 선택 (ko → en → 첫 번째)
|
||||
4. `\u0026` → `&` 디코딩
|
||||
5. `&fmt=json3` 추가
|
||||
6. `page.evaluate(fetch())` — 브라우저 내 JS fetch로 요청 (쿠키 유지)
|
||||
|
||||
### 언어 선택 로직
|
||||
|
||||
```
|
||||
captionTracks JSON에서:
|
||||
1. languageCode가 "ko"로 시작하는 트랙 → 최우선
|
||||
2. languageCode가 "en"으로 시작하는 트랙 → 차선
|
||||
3. 첫 번째 트랙 → 최후
|
||||
```
|
||||
|
||||
## 4. DISPLAY 환경변수와 Head 모드
|
||||
|
||||
Playwright가 head 모드(`setHeadless(false)`)로 실행되려면 X Window 디스플레이가 필요하다.
|
||||
|
||||
| 환경 | DISPLAY 값 | 설명 |
|
||||
|------|-----------|------|
|
||||
| VNC 디버깅 | `:1` | VNC 접속 시 브라우저 보임 |
|
||||
| 운영 (백그라운드) | `:99` | Xvfb 가상 프레임버퍼 |
|
||||
|
||||
설정 위치: `start-backend.sh`의 `export DISPLAY=:1` (또는 `:99`)
|
||||
|
||||
## 5. 트러블슈팅
|
||||
|
||||
### YouTube 자막이 안 가져와질 때
|
||||
|
||||
1. **로그 확인**: `pm2 logs sundol-backend --lines 50`
|
||||
2. **"봇 판정"**: youtube-transcript-api 실패 → Playwright fallback 정상 동작하는지 확인
|
||||
3. **쿠키 만료**: `cookies.txt`의 쿠키가 오래되면 YouTube가 차단. 브라우저에서 새 쿠키 export 필요
|
||||
4. **자막 패널 버튼 변경**: YouTube UI 업데이트로 버튼 텍스트/셀렉터가 바뀌면 `extractTranscriptFromPanel()` 수정 필요
|
||||
|
||||
### Playwright 브라우저가 죽었을 때
|
||||
|
||||
- `ensureBrowserAlive()`가 자동 재시작
|
||||
- 로그에서 `Playwright 브라우저가 죽어있습니다. 재시작합니다.` 확인
|
||||
- 수동 재시작: `pm2 restart sundol-backend`
|
||||
|
||||
### 크롤링이 빈 결과를 반환할 때
|
||||
|
||||
1. Jsoup: JavaScript 렌더링이 필요한 SPA 사이트인지 확인
|
||||
2. Jina Reader: API 키 유효한지, rate limit 걸렸는지 확인
|
||||
3. Playwright: 해당 사이트가 Cloudflare 등 봇 차단을 하는지 확인
|
||||
|
||||
## 6. 관련 파일
|
||||
|
||||
| 파일 | 역할 |
|
||||
|------|------|
|
||||
| `PlaywrightBrowserService.java` | 싱글톤 브라우저 관리 |
|
||||
| `WebCrawlerService.java` | 일반 웹 크롤링 (3단계 fallback) |
|
||||
| `YouTubeTranscriptService.java` | YouTube 자막 추출 (2단계 fallback) |
|
||||
| `cookies.txt` | YouTube/Google 쿠키 (봇 차단 우회) |
|
||||
| `start-backend.sh` | DISPLAY 환경변수 설정 |
|
||||
182
docs/operation-manual.md
Normal file
182
docs/operation-manual.md
Normal file
@@ -0,0 +1,182 @@
|
||||
# Sundol 운영 매뉴얼
|
||||
|
||||
## 프로세스 구성
|
||||
|
||||
pm2로 3개 프로세스를 관리한다.
|
||||
|
||||
| id | name | 설명 |
|
||||
|----|------|------|
|
||||
| 0 | pdf-ocr | PDF OCR 서비스 |
|
||||
| 1 | sundol-backend | Spring Boot 백엔드 |
|
||||
| 2 | sundol-frontend | Next.js 프론트엔드 |
|
||||
|
||||
## pm2 기본 명령어
|
||||
|
||||
```bash
|
||||
# 프로세스 목록 확인
|
||||
pm2 list
|
||||
|
||||
# 로그 확인
|
||||
pm2 logs sundol-backend
|
||||
pm2 logs sundol-frontend
|
||||
pm2 logs pdf-ocr
|
||||
|
||||
# 특정 프로세스 재시작
|
||||
pm2 restart sundol-backend
|
||||
pm2 restart sundol-frontend
|
||||
pm2 restart pdf-ocr
|
||||
|
||||
# 전체 재시작
|
||||
pm2 restart all
|
||||
|
||||
# 프로세스 중지
|
||||
pm2 stop sundol-backend
|
||||
|
||||
# 프로세스 삭제
|
||||
pm2 delete sundol-backend
|
||||
```
|
||||
|
||||
## 백엔드 시작 스크립트
|
||||
|
||||
파일: `start-backend.sh`
|
||||
|
||||
```bash
|
||||
#!/bin/bash
|
||||
set -a
|
||||
source /home/opc/sundol/.env
|
||||
set +a
|
||||
|
||||
JAVA_HOME=${JAVA_HOME:-/usr/lib/jvm/java-21}
|
||||
export JAVA_HOME
|
||||
|
||||
# Playwright 브라우저 경로
|
||||
export PLAYWRIGHT_BROWSERS_PATH=/home/opc/.cache/ms-playwright
|
||||
export PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD=1
|
||||
|
||||
# Playwright head 모드용 디스플레이
|
||||
# :99 = Xvfb 가상 디스플레이 (브라우저 안 보임)
|
||||
# :1 = VNC 디스플레이 (VNC에서 브라우저 보임)
|
||||
export DISPLAY=:99
|
||||
|
||||
# Xvfb 가상 디스플레이 시작 (DISPLAY=:99일 때만 필요)
|
||||
if ! pgrep -x Xvfb > /dev/null; then
|
||||
Xvfb :99 -screen 0 1280x720x24 -nolisten tcp &
|
||||
sleep 1
|
||||
fi
|
||||
|
||||
BACKEND_DIR=/home/opc/sundol/sundol-backend
|
||||
exec $JAVA_HOME/bin/java -cp "$BACKEND_DIR/target/classes:$BACKEND_DIR/target/dependency/*" com.sundol.SundolApplication
|
||||
```
|
||||
|
||||
### DISPLAY 설정 가이드
|
||||
|
||||
| DISPLAY 값 | 용도 |
|
||||
|-------------|------|
|
||||
| `:99` | Xvfb 가상 디스플레이. 브라우저가 백그라운드에서 동작 (기본값) |
|
||||
| `:1` | VNC 디스플레이. VNC 접속 시 Playwright 브라우저가 화면에 보임 (디버깅용) |
|
||||
|
||||
VNC에서 Playwright 브라우저를 직접 보려면:
|
||||
1. `start-backend.sh`에서 `export DISPLAY=:1`로 변경
|
||||
2. `pm2 restart sundol-backend`
|
||||
|
||||
## 백엔드 빌드
|
||||
|
||||
```bash
|
||||
cd /home/opc/sundol/sundol-backend
|
||||
export JAVA_HOME=/usr/lib/jvm/java-21
|
||||
set -a && source /home/opc/sundol/.env && set +a
|
||||
mvn package -q -DskipTests
|
||||
```
|
||||
|
||||
> 컴파일만: `mvn compile` (위 환경변수 동일)
|
||||
|
||||
## 프론트엔드 빌드/배포
|
||||
|
||||
```bash
|
||||
cd /home/opc/sundol/sundol-frontend
|
||||
bash build.sh
|
||||
```
|
||||
|
||||
> `.env`에 `NEXT_PUBLIC_GOOGLE_CLIENT_ID`, `NEXT_PUBLIC_API_URL` 필수.
|
||||
|
||||
## 배포 절차
|
||||
|
||||
1. 코드 변경 및 빌드
|
||||
2. `pm2 restart sundol-backend` (또는 sundol-frontend)
|
||||
3. `pm2 logs sundol-backend` 로 정상 기동 확인
|
||||
4. `git push origin main`
|
||||
|
||||
## DB 접속 (Oracle Autonomous DB)
|
||||
|
||||
```bash
|
||||
set -a && source /home/opc/sundol/.env && set +a
|
||||
/home/opc/sqlcl/bin/sql ${ORACLE_USERNAME}/${ORACLE_PASSWORD}@${ORACLE_TNS_NAME}?TNS_ADMIN=${ORACLE_WALLET_PATH}
|
||||
```
|
||||
|
||||
## Playwright 관련
|
||||
|
||||
- 브라우저 경로: `/home/opc/.cache/ms-playwright`
|
||||
- WebCrawlerService: Playwright head 모드 (`setHeadless(false)`)
|
||||
- YouTubeTranscriptService: Playwright head 모드 (`setHeadless(false)`)
|
||||
- head 모드 사용 시 DISPLAY 환경변수 필수
|
||||
|
||||
## Playwright 의존 라이브러리
|
||||
|
||||
Playwright Chromium 실행에 필요한 시스템 라이브러리:
|
||||
|
||||
```bash
|
||||
sudo dnf install -y libicu woff2 harfbuzz-icu libjpeg-turbo libwebp enchant2 hyphen libffi
|
||||
```
|
||||
|
||||
> `libx264`는 WebKit 전용이므로 Chromium만 사용할 경우 불필요.
|
||||
> 로그에 `validateDependenciesLinux` 에러가 나오면 위 패키지 설치 확인.
|
||||
|
||||
### Xvfb vs VNC 디스플레이
|
||||
|
||||
| 모드 | DISPLAY | 설명 |
|
||||
|------|---------|------|
|
||||
| Xvfb (운영) | `:99` | 가상 프레임버퍼. 화면 없이 백그라운드 동작 |
|
||||
| VNC (디버깅) | `:1` | VNC 접속 시 브라우저가 화면에 보임 |
|
||||
|
||||
Xvfb 모드로 되돌리려면 `start-backend.sh`에서:
|
||||
```bash
|
||||
export DISPLAY=:99
|
||||
if ! pgrep -x Xvfb > /dev/null; then
|
||||
Xvfb :99 -screen 0 1280x720x24 -nolisten tcp &
|
||||
sleep 1
|
||||
fi
|
||||
```
|
||||
|
||||
## 트러블슈팅
|
||||
|
||||
### 백엔드가 안 뜰 때
|
||||
|
||||
```bash
|
||||
pm2 logs sundol-backend --lines 50
|
||||
```
|
||||
|
||||
### Playwright 브라우저가 안 열릴 때
|
||||
|
||||
```bash
|
||||
# DISPLAY 확인
|
||||
echo $DISPLAY
|
||||
|
||||
# Xvfb 실행 여부 확인
|
||||
pgrep -x Xvfb
|
||||
|
||||
# VNC 실행 여부 확인
|
||||
vncserver -list
|
||||
|
||||
# Playwright 브라우저 설치 확인
|
||||
ls /home/opc/.cache/ms-playwright/
|
||||
```
|
||||
|
||||
### pm2 프로세스가 계속 재시작될 때
|
||||
|
||||
```bash
|
||||
# 재시작 횟수 확인 (↺ 컬럼)
|
||||
pm2 list
|
||||
|
||||
# 에러 로그 확인
|
||||
pm2 logs sundol-backend --err --lines 100
|
||||
```
|
||||
174
docs/setup-xwindow.md
Normal file
174
docs/setup-xwindow.md
Normal file
@@ -0,0 +1,174 @@
|
||||
# X Window + XFCE + VNC 설치 매뉴얼
|
||||
|
||||
OCI(Oracle Cloud Infrastructure) Oracle Linux 9 환경 기준.
|
||||
|
||||
## 1. 사전 확인
|
||||
|
||||
```bash
|
||||
# Xorg 설치 여부 확인
|
||||
which Xorg
|
||||
rpm -q xorg-x11-server-Xorg
|
||||
|
||||
# DISPLAY 환경변수 확인 (비어있으면 X 서버 미실행 상태)
|
||||
echo $DISPLAY
|
||||
```
|
||||
|
||||
## 2. EPEL 저장소 설치
|
||||
|
||||
```bash
|
||||
sudo dnf install -y epel-release
|
||||
```
|
||||
|
||||
## 3. XFCE 데스크톱 환경 설치
|
||||
|
||||
```bash
|
||||
sudo dnf groupinstall -y "Xfce"
|
||||
```
|
||||
|
||||
> GNOME 대비 경량이라 서버 환경에 적합.
|
||||
|
||||
## 4. 기본 타겟을 GUI 모드로 변경
|
||||
|
||||
```bash
|
||||
sudo systemctl set-default graphical.target
|
||||
```
|
||||
|
||||
> 되돌리려면: `sudo systemctl set-default multi-user.target`
|
||||
|
||||
## 5. TigerVNC 서버 설치
|
||||
|
||||
SSH 원격 접속 환경에서는 VNC를 통해 GUI에 접근한다.
|
||||
|
||||
```bash
|
||||
sudo dnf install -y tigervnc-server
|
||||
```
|
||||
|
||||
## 6. VNC 비밀번호 설정
|
||||
|
||||
```bash
|
||||
vncpasswd
|
||||
```
|
||||
|
||||
> VNC 비밀번호는 최대 8자까지만 유효.
|
||||
|
||||
## 7. VNC 시작 스크립트 설정
|
||||
|
||||
```bash
|
||||
mkdir -p ~/.vnc
|
||||
|
||||
cat > ~/.vnc/xstartup << 'EOF'
|
||||
#!/bin/bash
|
||||
exec startxfce4
|
||||
EOF
|
||||
|
||||
chmod +x ~/.vnc/xstartup
|
||||
```
|
||||
|
||||
## 8. VNC 서버 시작
|
||||
|
||||
```bash
|
||||
vncserver :1 -geometry 1920x1080 -depth 24
|
||||
```
|
||||
|
||||
- `:1` = 포트 5901
|
||||
- `:2` = 포트 5902 (추가 세션 필요 시)
|
||||
|
||||
### VNC 서버 중지
|
||||
|
||||
```bash
|
||||
vncserver -kill :1
|
||||
```
|
||||
|
||||
## 9. 방화벽 포트 개방
|
||||
|
||||
```bash
|
||||
sudo firewall-cmd --permanent --add-port=5901/tcp
|
||||
sudo firewall-cmd --reload
|
||||
```
|
||||
|
||||
### OCI 보안 목록 설정
|
||||
|
||||
OCI 콘솔에서 해당 서브넷의 Security List에 인바운드 규칙 추가:
|
||||
- **Source**: 접속할 IP (또는 0.0.0.0/0)
|
||||
- **Protocol**: TCP
|
||||
- **Destination Port**: 5901
|
||||
|
||||
## 10. 클라이언트에서 VNC 접속
|
||||
|
||||
### Mac
|
||||
|
||||
기본 내장 Screen Sharing 사용:
|
||||
|
||||
```bash
|
||||
# Finder에서 Cmd+K → 아래 주소 입력
|
||||
vnc://공인IP:5901
|
||||
|
||||
# 또는 터미널에서
|
||||
open vnc://공인IP:5901
|
||||
```
|
||||
|
||||
### Windows
|
||||
|
||||
- RealVNC Viewer, TigerVNC Viewer 등 VNC 클라이언트 설치
|
||||
- 주소: `공인IP:5901`
|
||||
|
||||
## 11. Chrome 브라우저 설치
|
||||
|
||||
```bash
|
||||
# Google Chrome 저장소 추가
|
||||
cat << 'EOF' | sudo tee /etc/yum.repos.d/google-chrome.repo
|
||||
[google-chrome]
|
||||
name=google-chrome
|
||||
baseurl=https://dl.google.com/linux/chrome/rpm/stable/x86_64
|
||||
enabled=1
|
||||
gpgcheck=1
|
||||
gpgkey=https://dl.google.com/linux/linux_signing_key.pub
|
||||
EOF
|
||||
|
||||
# 설치
|
||||
sudo dnf install -y google-chrome-stable
|
||||
```
|
||||
|
||||
## 12. 한글 폰트 설치
|
||||
|
||||
브라우저 등에서 한글이 깨지는 경우 CJK 폰트를 설치한다.
|
||||
|
||||
```bash
|
||||
sudo dnf install -y google-noto-sans-cjk-ttc-fonts google-noto-serif-cjk-ttc-fonts
|
||||
|
||||
# 폰트 캐시 갱신
|
||||
fc-cache -fv
|
||||
```
|
||||
|
||||
> 설치 후 Chrome 등 브라우저를 재시작해야 반영됨.
|
||||
|
||||
## 트러블슈팅
|
||||
|
||||
### VNC 접속이 안 될 때
|
||||
|
||||
```bash
|
||||
# VNC 서버 실행 확인
|
||||
vncserver -list
|
||||
|
||||
# 로그 확인
|
||||
cat ~/.vnc/*.log
|
||||
|
||||
# 방화벽 확인
|
||||
sudo firewall-cmd --list-ports
|
||||
```
|
||||
|
||||
### 화면이 회색/빈 화면일 때
|
||||
|
||||
`~/.vnc/xstartup` 파일 내용이 올바른지 확인:
|
||||
|
||||
```bash
|
||||
cat ~/.vnc/xstartup
|
||||
# exec startxfce4 가 있어야 함
|
||||
```
|
||||
|
||||
VNC 서버 재시작:
|
||||
|
||||
```bash
|
||||
vncserver -kill :1
|
||||
vncserver :1 -geometry 1920x1080 -depth 24
|
||||
```
|
||||
Reference in New Issue
Block a user