VPS에서 Moli 헤드리스 브라우저 자가 호스팅하기
소규모 VPS에서 Headless Chrome의 높은 메모리 점유율 문제를 해결하는 Moli 설치 방법을 안내합니다. CDP를 활용해 기존 에이전트와 연동하는 방법과 GUI 미지원 등 실제 운영 시 고려해야 할 기술적 제약 사항을 상세히 정리했습니다.
소형 VPS에 적합한 헤드리스 브라우저
Moli는 AI 에이전트를 위한 헤드리스 브라우저이며, 헤드리스 Chrome을 실행하기 어려운 소형 VPS에서도 자가 호스팅이 가능할 정도로 가볍습니다. 이 브라우저 엔진은 Chromium을 래핑한 것이 아니라 Rust로 직접 작성되었으며, 자동화 라이브러리가 이미 지원하는 Chrome DevTools Protocol (CDP)을 사용합니다. 바이너리 하나를 설치하고 moli serve을 실행한 뒤, Playwright나 에이전트 코드를 http://127.0.0.1:9222에 연결하면 됩니다.
설치하기 전에 트레이드오프를 확인하십시오. 이 프로젝트는 GUI 브라우저, GPU 컴포지터, Chrome과의 픽셀 단위 일치, 고성능 Canvas/WebGL/미디어 재생 기능을 제공하지 않는다는 점을 명확히 밝히고 있습니다. 해당 기능이 필요한 페이지는 정상적으로 동작하지 않습니다. Playwright에서 실제 Chrome을 사용하는 방식이 여전히 기본 대안이며, 마지막 섹션에서는 어떤 페이지에 Chrome이 필요한지 판단하는 방법을 다룹니다.
아래의 모든 명령어는 프로젝트의 README와 공개된 기술 문서를 기반으로 하며, 2026년 11월 16일 기준으로 고정된 버전에 맞춰 재확인되었습니다. 차트에 포함된 모든 수치는 본 사이트의 측정값이 아닌 프로젝트 측에서 자사 엔진에 대해 발표한 자료이며, 각 차트 캡션에 명시되어 있습니다. 엔진 선택을 고민 중이라면 VPS용 에이전트 헤드리스 브라우저에 대한 더 넓은 범위의 조사 내용을 참고하십시오.
Headless Chrome은 왜 그렇게 많은 메모리를 사용합니까?
Chrome은 멀티 프로세스 브라우저입니다. 문서를 사이트별로 그룹화하며, 데스크톱 Linux 환경에서는 전체 사이트 격리(Site Isolation) 기능을 통해 교차 사이트 iframe을 포함한 각 사이트를 별도의 렌더러 프로세스에서 실행합니다. Chrome은 동일 사이트 페이지들이 렌더러를 공유하도록 허용할 수 있지만, 여러 사이트를 방문하는 세션은 여전히 여러 개의 렌더러를 실행하며 각 렌더러는 고유한 V8 힙과 그래픽 버퍼를 가집니다. 이러한 설계는 페이지 하나가 충돌해도 전체 창이 닫히지 않아야 하는 데스크톱 환경에는 적합합니다. 하지만 2 GB VPS 환경에서는 단 한 번의 브라우징 단계가 실제 실행 중인 애플리케이션보다 더 많은 메모리를 소모할 수 있습니다.
해당 프로젝트는 4개의 엔진을 사용하여 192개의 혼합된 공개 URL을 크롤링하고 그 결과를 발표했습니다.
이 차트의 데이터
[
{
"engine": "Moli",
"useful_pages": 103,
"median_rss_mib": 73
},
{
"engine": "Chrome Headless",
"useful_pages": 101,
"median_rss_mib": 773
},
{
"engine": "Lightpanda",
"useful_pages": 85,
"median_rss_mib": 40
},
{
"engine": "Obscura",
"useful_pages": 57,
"median_rss_mib": 39
}
]Chrome Headless는 101개의 유용한 페이지를 반환했고 Moli는 103개를 반환했으므로, 해당 샘플에서 두 엔진은 웹의 거의 동일한 비율을 읽어 들였습니다. 메모리 사용량은 두 엔진이 차별화되는 지점입니다. Chrome의 중앙값 RSS(Resident Set Size, 프로세스가 RAM에서 실제로 점유하는 메모리)는 773 MiB인 반면, Moli는 73 MiB입니다. 이러한 결과는 프로세스 아키텍처에서 기인하므로 신뢰할 수 있습니다. 귀하의 페이지에서 나타나는 정확한 비율을 미리 단정해서는 안 됩니다.
사용자를 괴롭히는 것은 중앙값이 아니라 최댓값입니다. 2 GB 서버의 메모리가 부족해지면 커널은 프로세스 하나를 선택하여 강제 종료하며, 해당 기록은 dmesg -T 또는 journalctl -k에 남습니다.
Out of memory: Killed process 4211 (chrome) total-vm:2318936kB, anon-rss:1418324kB, file-rss:0kB, shmem-rss:0kB, UID:1000 pgtables:3540kB oom_score_adj:0에이전트는 해당 로그 줄을 직접 보지 못합니다. 대신 응답을 멈춘 브라우저를 보게 되며, 보통 page.goto: Page crashed과 같은 Playwright 오류나 대상이 닫혔다는 메시지로 나타납니다. 오류 메시지 어디에도 메모리 관련 언급이 없기 때문에, 소형 서버에서 에이전트가 무작위로 실패할 경우 가장 먼저 OOM(Out of Memory) 킬러를 확인해야 합니다. 최댓값에 맞춰 자원을 산정하는 것은 에이전트 VPS를 위한 RAM 및 CPU 선택과 동일한 과정입니다.
Moli 바이너리 설치 및 특정 버전 고정
이 프로젝트는 GitHub releases를 통해 셸 설치 스크립트와 미리 빌드된 tarball을 배포합니다. 2026년 11월 16일 기준으로 최신 릴리스는 2026년 11월 15일에 배포된 1.1.25 버전입니다. 아래 명령어는 1.1.18 버전에 고정되어 있습니다. 이 가이드 뒷부분에서 인용하는 Lexbench 점수는 0.1.1 버전에서 측정되었으며, README는 다른 수치들의 기준이 된 버전을 명시하지 않습니다. 이 모든 수치는 설치할 빌드에 대한 보장이 아니라 엔진의 대략적인 성능 지표로 간주하십시오.
버전을 고정하십시오. 항상 latest을(를) 확인하는 설치 스크립트는 다음 재빌드 시 에이전트를 다른 브라우저 엔진으로 변경할 수 있습니다. 브라우저 동작의 변화는 예기치 않게 발견하기보다 계획적으로 적용해야 하는 변경 사항입니다.
셸 설치 스크립트는 가장 빠른 설치 방법이며, 실행하기 전에 내용을 읽어볼 가치가 있습니다.
curl --proto '=https' --tlsv1.2 -fsSL \
-o /tmp/moli-installer.sh \
https://github.com/lexmount/moli/releases/download/v1.1.18/moli-installer.sh
less /tmp/moli-installer.sh
sh /tmp/moli-installer.sh스크립트를 실행하기 전에 내용을 읽으십시오. 스크립트는 짧습니다. uname -m에서 아카이브를 선택한 다음, 단일 바이너리를 ~/.local/bin에 압축 해제합니다. x86_64 환경에서는 moli-x86_64-unknown-linux-gnu.tar.gz을(를) 사용하고, Arm 서버에서는 aarch64 아카이브를 사용하므로 Arm 및 x86 VPS 플랜 모두 지원됩니다. 다른 위치에 설치하려면 MOLI_INSTALL_DIR을(를) 설정하십시오. 스크립트가 버전을 결정하는 방식을 확인하십시오. 스크립트를 가져온 태그가 아니라 최신 릴리스를 선택합니다. 처음 살펴볼 때는 괜찮지만, 재현 가능한 재빌드를 원한다면 부적절합니다.
따라서 영구적인 환경을 구성하려면 설치 스크립트가 수행하는 작업을 직접 수동으로 수행하고 아카이브를 직접 지정하십시오. 이 방법은 시스템 서비스가 접근할 수 있는 위치에 바이너리를 배치하는 방법이기도 하며, 다운로드한 스크립트를 셸로 바로 파이핑하는 위험을 방지합니다.
cd /tmp
curl --proto '=https' --tlsv1.2 -fsSLO \
https://github.com/lexmount/moli/releases/download/v1.1.18/moli-x86_64-unknown-linux-gnu.tar.gz
mkdir -p moli-pkg
tar -xzf moli-x86_64-unknown-linux-gnu.tar.gz -C moli-pkg --strip-components=1
sudo install -m 0755 moli-pkg/moli /usr/local/bin/moli
moli --versionmoli --version 고정한 버전을 출력하는 것이 전체 확인 과정입니다. 설치 직후 moli: command not found이(가) 발생한다면 설치 디렉터리가 PATH에 포함되지 않은 것입니다. 설치 스크립트는 추가해야 할 디렉터리 경로를 출력합니다.
moli fetch를 이용한 일회성 추출
에이전트가 브라우저에 부여하는 작업 중 다수는 "이 URL을 불러와서 내용을 알려달라"는 것입니다. 이 작업에는 서버가 전혀 필요하지 않습니다. moli fetch는 엔진을 시작하고, 페이지 하나를 불러온 뒤, 아티팩트를 표준 출력으로 기록하고 종료합니다. 따라서 호출 사이에 메모리를 점유하는 요소가 없습니다.
moli fetch --dump markdown --wait-until networkidle https://example.com
moli fetch --dump semantic_tree_text --wait-selector "main" https://example.com
moli fetch --dump json --wait-until networkidle https://example.com > page.json첫 번째 명령은 페이지를 Markdown으로 출력하며, # Example Domain로 시작합니다. Markdown은 마크업을 제거하고 텍스트만 남기므로 모델에 전달하기 가장 효율적인 형식입니다. semantic_tree_text는 역할과 구조를 유지합니다. 이는 링크가 본문만큼 중요한 탐색 중심 페이지에서 유용합니다. --dump json는 HTTP 상태와 요청 추적 정보를 포함합니다. 가져오기 결과가 비어 있고 그 이유를 확인해야 할 때 이 옵션을 사용하십시오.
대기 전략은 콘텐츠를 가져올지, 아니면 빈 껍데기만 가져올지를 결정합니다. --wait-until networkidle은 네트워크가 조용해지면 반환합니다. --wait-until domstable은 DOM 변경이 멈추면 반환합니다. 이는 백그라운드에서 폴링을 수행하여 네트워크가 결코 조용해지지 않는 페이지에서 더 나은 선택입니다. --wait-selector은 지정한 선택자가 나타날 때까지 대기합니다. 이는 가져오려는 페이지의 구조를 알고 있는 유일한 전략이며, 따라서 대상 페이지를 알고 있을 때 가장 신뢰할 수 있는 방법입니다.
스크린샷과 PDF를 생성하려면 실제 레이아웃이 필요하며, 레이아웃은 기본적으로 꺼져 있습니다.
moli fetch --layout --dump screenshot https://example.com > page.png
moli fetch --layout --dump screenshot_full https://example.com > full-page.png
moli fetch --layout --dump pdf https://example.com > page.pdfREADME는 기본 레이아웃 정책을 LayoutPolicy::Mock로 명시합니다. 레이아웃과 페인트는 브라우저 작업 중 비용이 많이 드는 절반을 차지하므로, 기하학적 구조만 모사하고 실제 그리기는 수행하지 않습니다. 위에서 언급한 메모리 수치가 낮은 이유는 이 기본 설정 때문입니다. 또한 PNG 결과물이 비어 있다면, 이는 페이지가 깨진 것이 아니라 --layout 플래그가 누락되었을 가능성이 큽니다.
사용자가 선택한 URL이 아니라 에이전트가 발견한 URL을 처리할 때는 --block-private-networks을 추가하십시오. 페이지에서 읽은 링크를 따라가는 에이전트는 클라우드 인스턴스 자격 증명을 위한 http://169.254.169.254/나 웹에 노출되어서는 안 될 localhost의 데이터베이스 포트를 가져오도록 유도될 수 있습니다. 이 플래그는 직접 연결된 요청에 대해 사설 주소를 차단하며, --block-cidrs은 특정 차단 범위를 추가합니다. 프록시를 통해 확인된 대상은 프록시에서 필터링해야 합니다. 작업이 단일 페이지 읽기가 아닌 크롤링인 경우, 해당 파이프라인의 형태는 자체 호스팅 Firecrawl 대안에서 다루며, 그 이전 단계인 URL 발견은 에이전트를 위한 SearXNG 기반 검색 기술에서 설명합니다.
CDP를 통해 Moli에 에이전트 연결하기
여러 단계에 걸쳐 탐색하고 클릭하는 에이전트의 경우, 대신 서버를 실행하십시오.
moli serve --host 127.0.0.1 --port 9222127.0.0.1와 포트 9222는 기본값이므로, moli serve만 입력해도 루프백에만 바인딩됩니다. 하지만 영구적인 설정이라면 두 값을 모두 명시하십시오. 서비스 파일을 읽는 다음 사람이 기본값을 기억할 필요가 없도록 하기 위함입니다.
클라이언트를 연결하기 전에 서버를 확인하십시오:
curl -s http://127.0.0.1:9222/json/version정상적인 서버는 webSocketDebuggerUrl 필드를 포함한 JSON 객체로 응답하며, 해당 URL이 CDP 클라이언트가 연결할 대상입니다. curl: (7) Failed to connect to 127.0.0.1 port 9222: Connection refused은 아무것도 수신 대기 중이지 않다는 뜻이므로, 서버를 시작한 터미널을 확인하거나 서비스로 등록된 경우 journalctl -u moli -n 50을 확인하십시오. /json/list은 열려 있는 타겟을 나열하며, /json/protocol는 현재 빌드에서 구현된 도메인을 나열합니다. 이를 통해 의존하는 CDP 메서드가 이 빌드에 존재하는지 확인할 수 있습니다.
Playwright는 자체 브라우저를 실행하는 대신 해당 엔드포인트에 연결합니다:
import { chromium } from "playwright";
const browser = await chromium.connectOverCDP("http://127.0.0.1:9222");
const context = browser.contexts()[0];
const page = context.pages()[0] ?? await context.newPage();
await page.goto("https://example.com");
console.log(await page.locator("body").innerText());
await browser.close();중요한 줄은 chromium.launch()이 아니라 connectOverCDP입니다. 여기에는 자식 Chromium 프로세스가 없으므로, executablePath나 --no-sandbox과 같은 일반적인 컨테이너 플래그는 적용되지 않습니다. 같은 이유로 프록시, 쿠키, 사용자 에이전트 설정은 Moli 서버의 자체 플래그로 전달해야 합니다. 전체 Chrome 프로토콜이 아닌 선별된 CDP 지원을 예상하십시오. 명시적인 지원되지 않는 메서드 오류는 엔진의 경계일 뿐, 코드의 버그가 아닙니다.
두 가지 서버 플래그가 에이전트의 기능을 결정합니다. --layout는 좌표 클릭과 스크린샷에 필요한 실제 지오메트리를 활성화합니다. --resource는 선택적인 이미지, 폰트, 미디어를 가져오며 페이지 로드 시마다 대역폭과 메모리를 소모하므로, 페이지에서 반드시 필요하다는 것이 증명되기 전까지는 끄십시오. --profile-dir은 실행 간에 쿠키와 저장소를 유지하며, 이 옵션이 없으면 모든 실행은 일회성으로 처리됩니다.
이 차트의 데이터
[
{
"engine": "Moli",
"cdp_ready_ms": 34.85,
"peak_pss_mib": 102.46,
"processes": 1
},
{
"engine": "Chromium",
"cdp_ready_ms": 169.37,
"peak_pss_mib": 348.82,
"processes": 11
}
]프로젝트의 샘플 에이전트 워크로드에서 Moli는 34.85 ms 만에 CDP 연결을 수락했습니다(Chromium은 169.37 ms). 최대 PSS(공유 페이지를 프로세스 간에 분할하여 계산한 메모리 사용량)는 102.46 MiB를 기록했습니다(Chromium은 348.82 MiB). 구조적인 차이는 마지막 열에 나타납니다. 1개의 프로세스 대 11개입니다. 하나의 프로세스는 systemd가 관리하고 cgroup으로 제한할 대상이 하나라는 의미이며, 이는 다음 섹션을 짧게 만드는 이유입니다.
moli serve를 systemd 서비스로 loopback에서 실행하기
에이전트가 브라우저를 대기시켜야 할 때는 서버를 서비스로 실행하십시오. 그렇지 않은 경우에는 moli fetch를 계속 사용하십시오. 유휴 상태의 서버도 메모리를 점유하기 때문입니다.
포트 9222를 공용 인터페이스에 노출하지 마십시오. CDP에는 어떠한 인증 단계도 없습니다. 해당 포트에 접근할 수 있는 사람은 누구나 브라우저를 제어할 수 있으며, 프로필 디렉터리에 있는 쿠키를 포함하여 브라우저가 접근할 수 있는 모든 정보를 읽을 수 있습니다. 127.0.0.1로 유지하십시오. SSH 터널(ssh -L 9222:127.0.0.1:9222 user@your-vps)이나 사설 VPN 인터페이스를 통해 다른 머신에서 접근하고, 에이전트가 터널의 자기 쪽 끝에 있는 http://127.0.0.1:9222에 연결하도록 하십시오.
서비스 사용자를 생성한 다음 unit 파일을 만드십시오:
sudo useradd --system --home-dir /var/lib/moli --shell /usr/sbin/nologin moli/etc/systemd/system/moli.service를 작성하십시오:
[Unit]
Description=Moli headless browser CDP server
After=network-online.target
Wants=network-online.target
[Service]
Type=simple
User=moli
Group=moli
ExecStart=/usr/local/bin/moli serve --host 127.0.0.1 --port 9222 --profile-dir /var/lib/moli/profile --block-private-networks
Restart=on-failure
RestartSec=2
StateDirectory=moli
MemoryAccounting=yes
MemoryMax=768M
NoNewPrivileges=yes
PrivateTmp=yes
ProtectHome=yes
ProtectSystem=strict
[Install]
WantedBy=multi-user.targetsudo systemctl daemon-reload
sudo systemctl enable --now moli.service
systemctl status moli.service
curl -s http://127.0.0.1:9222/json/versionsystemctl status는 active (running)을 보여야 하며, curl은 discovery JSON을 반환해야 합니다. ProtectSystem=strict는 API 파일 시스템과 설정된 예외를 제외한 파일 시스템을 읽기 전용으로 만듭니다. StateDirectory=moli은 서비스 사용자가 소유하는 /var/lib/moli를 생성하고 쓰기 가능 상태로 유지합니다. PrivateTmp=yes를 사용하면 unit의 전용 /tmp과 /var/tmp도 쓰기 가능해집니다. 시작 직후 journalctl -u moli에서 권한 오류로 종료되는 unit은 거의 항상 ProtectSystem가 읽기 전용으로 만든 경로에 쓰기를 시도하는 경우이므로, 해당 경로를 상태 디렉터리 아래로 옮기십시오.
MemoryMax=768M은 unit의 메모리 사용량을 제한합니다. unit은 고유한 cgroup을 가지며, 사용량이 제한에 도달하면 커널이 메모리 회수를 시도합니다. 사용량을 줄일 수 없으면 해당 cgroup 내부에서 OOM killer가 호출되며, 외부 프로세스는 종료하지 않습니다. 저널에는 다음과 같은 종료 기록이 남습니다:
moli.service: A process of this unit has been killed by the OOM killer.이 줄을 사이징 신호로 읽으십시오. 페이지가 계획보다 무겁거나 제한이 너무 낮은 경우입니다. 다음 섹션에서 다룰 자체 페이지 측정값을 바탕으로 숫자를 설정하십시오. Accounting은 사용량을 측정하며, MemoryMax 및 CPUQuota와 같은 별도의 제어 장치는 다른 서비스에 제한을 가합니다. systemd로 메모리 및 CPU 제한하기를 통해 나머지를 처리할 수 있습니다.
직접 최대 메모리 사용량 측정하기
공개된 수치는 다른 사람의 하드웨어와 다른 페이지를 기준으로 측정된 것입니다. 최대 메모리 사용량은 서버의 생존 여부를 결정하며, 이는 전적으로 어떤 페이지를 로드하느냐에 달려 있습니다. 서버 규모를 산정하기 전에 직접 측정하십시오.
일회성으로 페이지를 가져올 때는 time 바이너리를 사용하십시오. 이는 셸 내장 명령어보다 훨씬 더 많은 정보를 제공합니다.
sudo apt update && sudo apt install -y time
/usr/bin/time -v moli fetch --dump markdown --wait-until networkidle https://example.com > /dev/null출력 결과 마지막에는 Maximum resident set size (kbytes)를 포함한 리소스 통계 블록이 표시됩니다. 이 값을 1024로 나누면 MiB 단위가 됩니다. example.com를 대상으로 실행하지 말고, 에이전트가 실제로 방문하는 10개의 페이지를 대상으로 실행하십시오. OOM killer는 최대치를 기준으로 동작하므로 평균값이 아닌 최악의 결과값을 기준으로 삼아야 합니다.
서비스의 경우, 커널이 cgroup을 위해 유지하고 있는 카운터를 확인하십시오.
cat /sys/fs/cgroup/system.slice/moli.service/memory.peak
systemd-cgtop -mmemory.peak은 바이트 단위의 수치이며, cgroup이 생성된 이후의 최대 사용량(high-water mark)을 나타냅니다. 서비스가 재시작되어도 cgroup이 다시 생성되지 않는 한 이 값은 초기화되지 않습니다. 이 수치는 MemoryMax이 확보해야 할 최소 기준이며, 아직 방문하지 않은 가장 무거운 페이지를 처리할 여유 공간까지 고려해야 합니다. systemd-cgtop -m은 유닛별 실시간 사용량을 보여주며, 현재 서버에서 가장 많은 메모리를 점유하는 서비스가 무엇인지 가장 빠르게 확인할 수 있는 방법입니다.
Moli는 어디에서 실패하며, 언제 여전히 Chrome이 필요한가?
이 프로젝트는 1,308개의 비교 가능한 브라우저 자동화 작업에 대한 벤치마크를 실행하고 여러 엔진의 점수를 공개합니다.
이 차트의 데이터
[
{
"engine": "Chrome",
"success_rate_pct": 99.85
},
{
"engine": "Moli 0.1.1",
"success_rate_pct": 81.88
},
{
"engine": "Kitesurf",
"success_rate_pct": 62.08
},
{
"engine": "Lightpanda",
"success_rate_pct": 53.29
},
{
"engine": "Obscura",
"success_rate_pct": 44.88
}
]5개의 엔진 전반에서 Moli 0.1.1은 작업의 81.88 퍼센트를 완료했으며, 기준 엔진인 Chrome은 99.85 퍼센트를 완료했습니다. 이는 프로젝트가 자체 제품군을 대상으로 스스로 점수를 매긴 것이므로, 독립적인 결과라기보다는 하나의 주장으로 해석해야 합니다.
실질적인 해석은 간단합니다. Moli 0.1.1은 선정된 1,308개의 작업 중 237개, 즉 대략 5개 중 1개꼴로 실패했습니다. 만약 에이전트가 직접 제어하는 고정된 페이지 집합을 방문한다면, 이 비율은 큰 의미가 없습니다. 해당 페이지들은 작동하거나 작동하지 않거나 둘 중 하나이며, 오늘 오후 중으로 직접 확인할 수 있기 때문입니다. 이 보고서는 관찰된 내용을 기술할 뿐 기능의 한계를 정의하는 것이 아니므로, 이러한 실패 사례가 지원되지 않는 기능이나 오픈 웹에서의 실패율을 확정 짓지는 않습니다.
프로젝트가 명시한 범위에 따르면 다음 작업들은 Chrome으로 확인해야 합니다.
- 고충실도 Canvas 렌더링이 필요한 애플리케이션: Moli는 Canvas 그리기 작업을 구현하므로, Canvas 사용 여부만으로 Chrome이 반드시 필요한 것은 아닙니다.
- 고충실도 WebGL이나 GPU 컴포지팅이 필요한 모든 작업: GPU 컴포지터가 없기 때문입니다.
- 고사양 미디어 재생.
- Chrome과 픽셀 단위로 정확히 일치하는 스크린샷을 검증해야 하는 시각적 테스트: Chrome과의 완벽한 일치는 목표가 아니기 때문입니다.
프로젝트가 언급한 또 다른 수치인 161만 2천 개의 웹 플랫폼 테스트 통과는 표준 준수 범위에 대한 설명입니다. 이는 에이전트가 방문할 사이트에 대한 보증이 아닙니다. 페이지가 잘 지원되는 표준만 사용하더라도 봇 탐지에서 실패할 수 있으며, 어떤 엔진 점수도 이를 보장하지 않습니다.
따라서 설계 시 폴백(fallback)을 유지하십시오. 모든 URL을 먼저 Moli로 보내십시오. 페이지가 비어 있거나 선택자가 나타나지 않으면, Playwright로 실제 Chrome을 구동하여 해당 URL을 다시 시도하십시오. 이때 더 큰 사양의 머신을 사용하거나 773 MiB 프로세스를 감당할 수 있는 일정에 맞춰 실행하십시오. 대부분의 에이전트는 일반적인 페이지에서 대부분의 시간을 보내므로, 가벼운 엔진이 전체 물량을 처리하고 무거운 엔진은 예외적인 경우를 처리하도록 구성하는 것이 좋습니다.
FAQ
Moli가 제 에이전트의 headless Chrome을 대체할 수 있습니까?
페이지 읽기, 텍스트 추출, 일반적인 클릭 작업이라면 대체로 가능합니다. 프로젝트 자체 벤치마크인 1,308개 작업에서 Moli 0.1.1 버전은 81.88%의 성공률을 기록하여 Chrome의 99.85%와 비교되었습니다. Moli에서 실패한 237개 작업이 모두 지원되지 않는 기능 때문이라고 단정할 수는 없습니다. 고충실도 Canvas/WebGL/미디어 재생은 프로젝트의 명시된 범위 밖이지만, Canvas를 사용한다고 해서 애플리케이션이 무조건 호환되지 않는 것은 아닙니다. 검증에 실패하는 URL 경로는 모든 것을 되돌리기보다 실제 Chrome으로 라우팅하십시오.
VPS에서 Moli는 어느 정도의 RAM을 필요로 합니까?
프로젝트 보고서에 따르면 192개 URL 크롤링 시 중앙값 RSS는 73 MiB이며, 샘플 에이전트 에피소드에서의 최대 PSS는 102.46 MiB입니다. 이는 headless Chrome의 중앙값인 773 MiB와 비교한 수치입니다. 이는 해당 페이지의 측정 결과이므로, 사용자의 환경에서 직접 측정해야 합니다. 일회성 사용 시에는 /usr/bin/time -v를 moli fetch 호출 전후로 사용하여 측정하고, 서비스로 운영할 때는 /sys/fs/cgroup/system.slice/moli.service/memory.peak을 확인한 뒤, 측정된 최악의 수치보다 높게 MemoryMax를 설정하십시오.
9222 포트를 인터넷에 노출해도 안전합니까?
아닙니다. CDP는 인증 기능이 없으므로 해당 포트에 접근할 수 있는 사람은 누구나 브라우저를 제어하고 브라우저가 접근할 수 있는 모든 정보를 읽을 수 있습니다. --host 127.0.0.1 상태를 유지하고, SSH 터널이나 사설 VPN 인터페이스를 통해 다른 머신에서 엔드포인트에 접근하십시오. 다른 주소에 바인딩해야 한다면 사설 인터페이스에 배치하고 방화벽으로 접근을 제어하십시오.
스크린샷이 비어 있거나 클릭이 엉뚱한 곳을 누르는 이유는 무엇입니까?
기본적으로 레이아웃이 꺼져 있기 때문입니다. README에 따르면 기본 정책은 LayoutPolicy::Mock이므로 요소의 기하학적 정보가 실제와 다르며, 페이지의 박스 모델에 의존하는 모든 기능이 작동하지 않습니다. 서버를 moli serve --layout로 시작하거나 moli fetch에 --layout을 추가하면 스크린샷과 좌표 경로가 정상적으로 작동합니다. 이미지가 누락되는 경우는 다른 플래그인 --resource을 확인하십시오.
어떤 버전의 Moli를 설치해야 합니까?
특정 버전을 고정하고 기록해 두십시오. 2026년 11월 16일 기준 최신 릴리스는 1.1.25이지만, 이 가이드의 명령어는 1.1.18에 고정되어 있습니다. 프로젝트의 Lexbench 점수는 0.1.1 버전에서 측정되었으므로, 다른 사람과 결과를 비교하기 전에 버전을 먼저 확인하십시오. 셸 설치 프로그램에 의존하여 최신 릴리스를 가져오지 말고, 해당 태그의 moli-x86_64-unknown-linux-gnu.tar.gz를 직접 다운로드하여 바이너리를 설치한 뒤 moli --version으로 버전을 확인하십시오.