> ## Documentation Index
> Fetch the complete documentation index at: https://www.octoparse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 로컬에서 작업 실행

> Octoparse 작업을 로컬에서 실행하고 브라우저 선택, JSONL 이벤트 스트리밍, 분리 실행 제어, 기록 확인 및 결과 내보내기를 수행하세요.

`octoparse run`은 내장 Octoparse 엔진으로 로컬 추출을 시작합니다. 데스크톱 애플리케이션은 필요하지 않습니다.

## 포그라운드 실행 시작

```bash theme={null}
octoparse run <taskId>
octoparse run <taskId> --max-rows 100
octoparse run <taskId> --timeout-ms 600000
octoparse run <taskId> --headless
```

원격 작업을 가져오는 대신 로컬 작업 정의를 사용합니다.

```bash theme={null}
octoparse run local-task --task-file task.json
```

로컬 작업 파일 실행을 포함한 기능 명령에는 자격 증명이 필요합니다.

## 브라우저 선택

```bash theme={null}
octoparse run <taskId> --browser independent --headless
octoparse run <taskId> --browser user --browser-id chrome --profile "Default"
```

설정 및 선택 우선순위는 [브라우저 모드 선택](/docs/ko/cli/guides/browser-modes)을 참고하세요.

## 기계 판독 가능 이벤트 스트리밍

```bash theme={null}
octoparse run <taskId> --json
octoparse run <taskId> --jsonl
```

`--jsonl`은 행, 로그, CAPTCHA, 프록시, 다운로드 및 수명 주기 이벤트를 스트리밍합니다. [출력 및 종료 코드](../reference/output-and-exit-codes)를 참고하세요.

## 분리 실행 시작

```bash theme={null}
octoparse run <taskId> --detach --output ./runs
```

기록을 확인하거나 결과를 내보낼 때 동일한 `--output` 디렉터리를 전달하세요.

## 로컬 실행 제어

```bash theme={null}
octoparse local status <taskId> --output ./runs
octoparse local pause <taskId>
octoparse local resume <taskId>
octoparse local stop <taskId>
octoparse local history <taskId> --output ./runs --json
octoparse local cleanup --json
```

로컬 상태는 이 CLI에서 추적하며 데스크톱 앱과 동기화되지 않습니다.

## 로컬 결과 내보내기

통합 데이터 명령을 사용하는 것이 좋습니다.

```bash theme={null}
octoparse data export <taskId> --source local --output ./runs --format xlsx
octoparse data export <taskId> --source local --lot-id <lotId> --format csv
```

호환성을 위해 `octoparse local export`도 계속 사용할 수 있습니다.

<Note>`runs` 명령 그룹은 내부 결과물 확인을 위한 것입니다. 사용자 워크플로에서는 `local` 및 `data`와 함께 작업 ID를 사용하거나 `data export`와 함께 lot ID를 사용해야 합니다.</Note>