Chạy Chromium headless cho AI agent trên VPS
Chromium headless trên VPS thường lỗi vì /dev/shm quá nhỏ, thiếu font, sandbox hoặc process rò rỉ. Cấu hình giới hạn trước khi agent chạm ngưỡng.
Những gì bạn đang chạy
Một headless browser trên VPS là Chromium không có giao diện đồ họa, được điều khiển bởi code của bạn thay vì con người. Trên máy chủ, nó là một cây tiến trình chạy dài hạn mà agent của bạn giao tiếp qua một socket cục bộ. Việc cài đặt chỉ cần một câu lệnh. Công việc thực sự nằm ở các bước sau đó. Bạn cần giới hạn tài nguyên mà trình duyệt được phép sử dụng từ máy chủ và giữ cho endpoint điều khiển của nó không bị lộ ra Internet công cộng.
Hướng dẫn này giả định bạn đã chọn xong công cụ và giờ cần vận hành nó. Nếu bạn vẫn đang so sánh các trình thu thập và trích xuất dữ liệu, hãy bắt đầu với các lựa chọn thay thế Firecrawl tự host rồi quay lại đây. Mọi nội dung bên dưới đều sử dụng Chromium của Playwright, vì Playwright tự đóng gói bản build trình duyệt và trình cài đặt dependency riêng, nên các câu lệnh này hoạt động đồng nhất trên một VPS Ubuntu thuần hoặc bên trong container. Các câu lệnh này ghim phiên bản Playwright 1.62, bản release hiện hành vào tháng 8 năm 2026.
Cài Chromium mà không phải đoán dependency
npm i -D playwright@1.62.0
npx playwright install --with-deps chromium--with-deps chạy apt để cài các shared library và font mà Chromium cần, rồi yêu cầu root khi đến bước đó. Bản build của browser được tải vào ~/.cache/ms-playwright cho user đã chạy command. Điều này quan trọng trên server vì service user thường không phải user mà bạn dùng để đăng nhập. Hãy cài các system package một lần với quyền admin bằng sudo npx playwright install-deps chromium, rồi đặt PLAYWRIGHT_BROWSERS_PATH=/opt/pw-browsers trong cả install command và service unit để dùng chung một bản. Service không thấy browser sẽ fail khi khởi động, kèm theo message nêu path mà nó đã tìm.
Hãy pin version của Playwright. Mỗi release gắn với một browser build cụ thể, nên npm update không được pin có thể thay browser trong khi service đang chạy. Playwright 1.62 là bản hiện tại vào tháng 8 năm 2026. Tính đến ngày 17 tháng 10 năm 2026, release mới nhất là 1.64.1, vì vậy hãy đọc release notes trước khi thay đổi pin. Trên server ARM64, lưu ý rằng 1.63 đã đổi tên các browser folder. Điều này ảnh hưởng đến AppArmor profile ở phần bên dưới.
Có 2 Chromium build và chúng không phải cùng một chương trình. Ở chế độ headless, Playwright mặc định dùng headless shell, một binary nhỏ hơn chỉ chạy headless. Install thông thường tải shell bên cạnh full browser, còn npx playwright install --with-deps --only-shell chỉ cài shell. Full browser là bản bạn nhận được với channel chromium. Tài liệu browser của Playwright gọi đây là "Chrome browser thực, nên xác thực hơn, đáng tin cậy hơn và có nhiều tính năng hơn". Dùng shell cho tác vụ fetch số lượng lớn. Dùng full browser khi website hoạt động khác nhau và bạn cần tìm nguyên nhân.
Tại sao headless browser bị crash trong container
Docker cấp cho mỗi container một /dev/shm 64 MB. Tài liệu của Docker đã ghi rõ: "Nếu bạn bỏ qua kích thước, hệ thống sẽ mặc định dùng 64m". Chromium truyền nội dung đã render giữa các tiến trình thông qua vùng nhớ chia sẻ đó, nên một trang web nặng có thể làm đầy nó. Renderer sau đó sẽ chết và client của bạn báo lỗi crashed target, dù trang đó vẫn chạy tốt trên laptop của bạn. Hãy kiểm tra kích thước từ bên trong container trước khi thay đổi bất cứ thứ gì.
df -h /dev/shmCó hai cách sửa lỗi thực sự và chúng là các phương án thay thế, không phải dùng cùng lúc. --ipc=host đặt container vào IPC namespace của host để nó sử dụng /dev/shm của host, thường là một nửa dung lượng RAM. Hướng dẫn Docker của Playwright khuyến nghị cách này, vì nếu không có nó "Chromium có thể bị hết bộ nhớ và crash". Cái giá phải trả là bạn mất đi sự cô lập IPC giữa container và host. --shm-size=1g giữ nguyên namespace riêng và chỉ đơn giản là tăng kích thước mount.
docker run --rm -it --init --ipc=host --user pwuser mcr.microsoft.com/playwright:v1.62.0-noble /bin/bashFlag --disable-dev-shm-usage là câu trả lời bạn sẽ thấy trong hầu hết các kết quả tìm kiếm, và nó thực hiện một việc khác: nó di chuyển các file đó ra khỏi /dev/shm vào một thư mục tạm. Nếu /tmp nằm trên ổ đĩa, bạn đã đánh đổi lỗi crash lấy tốc độ render chậm hơn và việc ghi đĩa. Nếu /tmp là một tmpfs, dữ liệu sẽ quay lại RAM, chỉ bị giới hạn bởi dung lượng tmpfs, vốn được tài liệu kernel đặt mặc định là một nửa RAM vật lý, và các trang tmpfs có thể bị đẩy ra swap. Đó là một cách khiến trình duyệt ngốn sạch tài nguyên trên một VPS nhỏ. Hãy cấu hình kích thước /dev/shm cho phù hợp.
Cái giá thực sự của --no-sandbox
Chromium cô lập mọi renderer trong sandbox dựa trên Linux user namespace. Sandbox đó là ranh giới giữa một trang độc hại và server của bạn. Khi sandbox không thể khởi động, Chromium từ chối chạy và log sẽ có một dòng như sau:
Failed to move to new namespace: PID namespaces supported, Network namespace supported, but failed: errno = Operation not permittedCách thường được khuyên là --no-sandbox. Các trang security của Chromium nói rõ về cái giá phải trả: "Chúng tôi không khuyến khích cách này vì nó sẽ làm giảm đáng kể security của bạn và có thể khiến Chromium không hoạt động đúng." Một agent làm theo các link về bản chất đang duyệt open web. Đây chính là môi trường kiểm tra mức security đã bị giảm đó. Hãy tìm nguyên nhân thực sự.
Có 2 nguyên nhân bao quát gần như mọi trường hợp. Chạy browser bằng root sẽ vô hiệu hóa sandbox vì process không thể drop privilege mà nó đã có. Đây là lý do image của Playwright có sẵn một user thông thường tên là pwuser. Trên Ubuntu 24.04 trở lên, AppArmor hạn chế unprivileged user namespace. Một Chromium binary nằm tại path không có profile nào được cung cấp bao phủ sẽ bị từ chối. Bản download của Playwright dưới ~/.cache/ms-playwright chính xác là một path như vậy. Hãy kiểm tra cả 2 nguyên nhân:
id -u
sysctl kernel.apparmor_restrict_unprivileged_userns
sudo dmesg | grep -i userns_create1 từ sysctl cùng với một dòng kernel chứa apparmor="DENIED" operation="userns_create" xác nhận nguyên nhân thứ hai. Hãy cho phép binary đó trong /etc/apparmor.d/pw-chromium. Cách này vẫn giữ restriction cho mọi thứ khác trên máy:
abi <abi/4.0>,
include <tunables/global>
profile pw-chromium /{home/*/.cache/ms-playwright,opt/pw-browsers}/*/chrome-*/{chrome,headless_shell,chrome-headless-shell} flags=(unconfined) {
userns,
}Nạp profile bằng sudo apparmor_parser -r /etc/apparmor.d/pw-chromium. Trên x86-64, Playwright đặt full browser tại chrome-linux64/chrome và shell tại chrome-headless-shell-linux64/chrome-headless-shell. Trên ARM64, Playwright 1.62 trở về trước dùng một folder chrome-linux duy nhất chứa cả chrome và headless_shell. Từ 1.63, ARM64 dùng layout giống x86-64 với chrome-linux-arm64/chrome và chrome-headless-shell-linux-arm64/chrome-headless-shell. Glob chrome-* bao phủ tất cả layout này, còn nhánh /opt/pw-browsers bao phủ shared install được tạo bằng PLAYWRIGHT_BROWSERS_PATH. Path này cũng chứa browser revision nên sẽ thay đổi sau mỗi lần upgrade Playwright. Các glob trên vẫn hoạt động sau những thay đổi đó. Profile viết theo một path chính xác sẽ âm thầm ngừng match. Browser lại bắt đầu fail sau một lần update tưởng như không liên quan.
Vì sao screenshot bị trắng hoặc đầy ô vuông
Screenshot trắng, hoặc đầy các hình chữ nhật rỗng, thường là do vấn đề font chứ không phải lỗi render. install-deps cung cấp bộ nền hoạt động được: fonts-liberation, fonts-freefont-ttf, fonts-noto-color-emoji, fonts-unifont, fonts-ipafont-gothic cho tiếng Nhật, fonts-wqy-zenhei cho tiếng Trung, fonts-tlwg-loma-otf cho tiếng Thái. Bộ này không có Noto CJK, nên tiếng Hàn và một số script khác sẽ fallback sang font mà fontconfig tìm được. Hãy hỏi fontconfig thay vì đoán:
fc-match "sans-serif:lang=ko"
fc-match "sans-serif:lang=ar"
fc-list | wc -lNếu ngôn ngữ bạn cần được ánh xạ đến unifont hoặc đến một font fallback không có glyph thực, hãy cài fonts-noto-core và fonts-noto-cjk, rồi chạy lại kiểm tra. Fontconfig cache các kết quả, nên hãy khởi động lại browser sau khi cài font. Image đã bị lược bỏ, không có font nào sẽ ghi Fontconfig error: Cannot load default config file khi khởi động và render mọi trang thành rỗng.
Locale và time zone tách biệt với font, đồng thời chúng thay đổi nội dung trang chứ không chỉ cách hiển thị. Container thường để LANG chưa được set và đặt TZ ở UTC, nên các site sẽ phân phối nội dung tiếng Anh và in timestamp UTC; agent của bạn cũng báo thời gian không khớp với những gì người dùng tại quốc gia đó thấy. Hãy đặt chúng theo từng browser context thay vì theo từng máy, để một browser có thể xử lý task cho nhiều khu vực khác nhau.
const context = await browser.newContext({
locale: 'en-GB',
timezoneId: 'Europe/Paris',
});Vì các tiến trình browser bị rò rỉ khiến máy chủ phải dùng swap
Hai vấn đề khác nhau cùng được gọi là “zombie”. Zombie thực sự là một tiến trình đã kết thúc nhưng tiến trình cha chưa gọi wait(). Nó chỉ giữ một mục PID và không giữ thêm gì khác, nên không tiêu thụ bộ nhớ. Bạn phải thu gom các tiến trình này khi browser chạy với PID 1 trong container, vì PID 1 không có cơ chế reaper mặc định. Flag --init của Docker xử lý đúng vấn đề này bằng cách chạy một init nhỏ để “chuyển tiếp signal và thu gom tiến trình”. Trong Compose, tùy chọn tương ứng là init: true.
Loại rò rỉ thực sự khiến máy chủ phải dùng swap lại khác: đó là các tiến trình Chromium vẫn đang chạy nhưng không có tiến trình nào đóng chúng. Điều này xảy ra khi một task phát sinh lỗi giữa newContext() và close(), hoặc khi script điều khiển bị kill và để lại cả cây browser mồ côi. Trường hợp tệ nhất là code khởi chạy một browser mới cho mỗi request. Hãy đếm số tiến trình:
pgrep -c -f 'headless_shell|chrome'
ps -eo pid,ppid,rss,etime,comm --sort=-rss | head -20Số lượng này phải trở về mức idle giữa các task. Nếu nó tăng dần trong một ngày, vấn đề nằm trong code chứ không phải các flag khởi chạy: đóng context trong block finally, đóng browser khi SIGTERM, và recycle browser sau một số lượng task cố định thay vì để một browser chạy suốt một tháng. Với systemd, thao tác stop hoặc restart sẽ kill mọi thứ trong cgroup của unit, nên sudo systemctl restart browser.service là cách reset đáng tin cậy. Browser được khởi chạy thủ công bên trong terminal multiplexer không có bảo đảm này, và các tiến trình mồ côi của nó vẫn tồn tại sau khi session kết thúc.
Một context trình duyệt cần bao nhiêu RAM
Hãy đặt câu hỏi một cách chính xác, vì "một trình duyệt" không chỉ là một tiến trình. Chromium chạy một tiến trình trình duyệt, một tiến trình GPU, các tiến trình tiện ích và mỗi site sẽ có một tiến trình renderer riêng; tính năng site isolation cũng cấp cho các iframe cross-site một renderer riêng biệt. Một BrowserContext là một cookie jar và vùng lưu trữ riêng biệt nằm trong cùng một cây tiến trình, nên context thứ hai rất nhẹ. Một trang thứ hai thì không, vì nó khởi chạy các tiến trình renderer, và một trang chứa nhiều quảng cáo sẽ khởi chạy thêm vài tiến trình nữa.
Vì vậy, con số cần đo lường là mức sử dụng RAM đỉnh điểm cho toàn bộ cây tiến trình dưới workload của bạn. Số liệu từ blog của người khác không có giá trị ở đây, vì các trang mà agent của bạn mở mới là yếu tố quyết định câu trả lời. Hãy đo lường trên chính máy chủ bạn sẽ sử dụng, với các trang web bạn sẽ truy cập:
sudo systemd-run --unit=browser-probe -p MemoryMax=2G -p MemorySwapMax=0 -p WorkingDirectory=/srv/agent /usr/bin/node worker.js
systemctl status browser-probeTrên Ubuntu 24.04, dòng Memory: trong kết quả đó báo cáo cả mức sử dụng hiện tại và đỉnh điểm cho unit. Hãy chạy worker với từng trang một, ghi lại mức đỉnh điểm, sau đó lặp lại với hai trang đang mở để thấy chi phí thực sự của trang thứ hai. Concurrency sau đó là bài toán số học: lấy tổng RAM, trừ đi phần mà các thành phần khác của máy chủ cần, giữ lại vài trăm MB làm vùng đệm, rồi chia cho mức đỉnh điểm đã đo được trên mỗi worker. Để định cỡ máy chủ bên dưới, hãy xem cần bao nhiêu RAM và CPU cho một agent VPS.
Hãy áp đặt con số đó tại hai nơi. Trong code, hãy sử dụng một worker pool cố định hoặc một semaphore, để các yêu cầu agent dồn dập sẽ được xếp hàng thay vì khởi chạy thêm trình duyệt. Trong OS, hãy sử dụng giới hạn cgroup, để một lỗi trong hàng đợi không thể làm sập cả máy chủ:
[Service]
MemoryMax=2G
MemorySwapMax=0
TasksMax=512
Restart=alwaysMemorySwapMax=0 quan trọng hơn vẻ ngoài của nó. Nếu không có nó, cgroup được phép đẩy các page vào swap khi tiến gần đến giới hạn, khiến máy chủ thường vẫn chạy nhưng mọi yêu cầu đều chậm đi, điều này khó chẩn đoán hơn là một lỗi dừng hẳn. Swap chỉ trì hoãn kết thúc: tài liệu của systemd nêu rõ rằng nếu mức sử dụng "không thể nằm trong giới hạn, out-of-memory killer sẽ được gọi bên trong unit". Với swap được giới hạn bằng 0, điều đó xảy ra ngay khi cây trình duyệt đạt đến MemoryMax, systemd khởi động lại unit, và sshd vẫn tồn tại. Các thiết lập tương tự trong Compose là mem_limit, shm_size và init, được đề cập trong thiết lập giới hạn bộ nhớ trong Docker Compose.
Giữ endpoint của trình duyệt ngoài Internet công cộng
Playwright có thể chạy trình duyệt dưới dạng server và cung cấp cho agent một WebSocket URL:
const { chromium } = require('playwright');
const server = await chromium.launchServer({ port: 3000 });
console.log(server.wsEndpoint());Endpoint này không có chức năng đăng nhập. Tài liệu API của Playwright nêu rõ: “Bất kỳ process hoặc trang web nào (kể cả những process và trang web đang chạy trong Playwright) biết wsPath đều có thể điều khiển user OS.” Host mặc định là localhost, “chỉ chấp nhận kết nối từ loopback interface”, và tài liệu cảnh báo rằng việc truyền một địa chỉ cụ thể như 0.0.0.0 “sẽ expose browser RPC cho mọi đối tượng có thể truy cập listening port”. --remote-debugging-port của Chrome còn nguy hiểm hơn. DevTools protocol không có bất kỳ cơ chế authentication nào và hoàn toàn phụ thuộc vào việc bind vào loopback.
Kiểm tra những gì bạn thực sự đã publish. Đồng thời kiểm tra từ một máy thứ hai, không chỉ từ VPS:
ss -ltnpBất kỳ browser port nào bind vào 0.0.0.0 đều là một phát hiện cần xử lý. Hãy nhớ rằng hầu hết nhà cung cấp đều có network firewall riêng trong control panel, trong khi các rule ufw của bạn không biết gì về firewall đó. Hãy truy cập endpoint từ một máy khác thông qua SSH tunnel hoặc private VPN:
ssh -N -L 3000:127.0.0.1:3000 you@your-vpsRủi ro ở đây lớn hơn việc ai đó chiếm thời gian chạy trình duyệt. Một trình duyệt mà bạn có thể điều khiển là một máy request forgery nằm bên trong network của bạn. Bất kỳ ai truy cập được socket đó đều có thể yêu cầu trình duyệt fetch http://127.0.0.1:8080, trang quản trị database hoặc địa chỉ cloud metadata tại 169.254.169.254, rồi đọc response từ trang web. Firewall của bạn thấy request xuất phát từ chính VPS, nên request đó được cho phép. Hãy coi control endpoint tương đương với quyền shell trên máy đó.
MCP server cũng có mô hình tương tự. npx @playwright/mcp@latest --headless --port 8931 phục vụ qua HTTP trên localhost, còn --host 0.0.0.0 là flag biến một local tool thành public tool. README của dự án nêu rõ rằng Playwright MCP “không phải là security boundary”. Giữ port trên loopback và cho agent truy cập qua cùng tunnel đó.
Các trang mà agent đọc là input không đáng tin cậy
Agent duyệt web mở sẽ đưa văn bản do người lạ viết vào cùng model đang nhận instructions của bạn. Một trang có thể chứa văn bản nhắm vào model đó, yêu cầu model bỏ nhiệm vụ, gọi tool hoặc đăng dữ liệu lên một URL. Model nhận cả hai dưới dạng văn bản, nên không có cách đáng tin cậy để phân biệt nội dung của trang với instructions của bạn. Hãy thiết kế hệ thống để một trang độc hại có ít khả năng gây tác động.
- Chạy browser dưới một OS user riêng, không có SSH keys và cloud credentials trong environment của user đó.
- Dùng context mới cho mỗi task và
--isolatedvới Playwright MCP để session trên một site không được dùng cho trang tiếp theo. - Duy trì origin allowlist khi job cho phép. Playwright MCP nhận
--allowed-originsvà--blocked-originsdưới dạng các danh sách phân tách bằng dấu chấm phẩy. - Yêu cầu con người xác nhận trước mọi hành động làm thay đổi trạng thái, chẳng hạn gửi mail hoặc thanh toán.
Tốt hơn nữa, hãy chạy toàn bộ browser trên một máy có thể loại bỏ và rebuild. Đây cũng là lý do nên chạy coding agent trong một VM dùng một lần. Nếu nhiệm vụ thực tế của agent chỉ là tìm kiếm thay vì duyệt web không giới hạn, một tool hẹp hơn sẽ an toàn hơn full browser: một search skill dùng SearXNG của bạn làm backend trả về kết quả mà không bao giờ load trang độc hại.
FAQ
Tại sao Chromium bị crash trong Docker nhưng vẫn chạy bình thường trên VPS?
Vì container mặc định chỉ nhận 64 MB /dev/shm trong khi máy chủ có dung lượng lớn hơn nhiều. Chromium truyền nội dung đã render qua vùng nhớ chia sẻ này, nên một trang web nặng sẽ làm đầy bộ nhớ và tiến trình renderer bị chết. Hãy chạy df -h /dev/shm bên trong container để xác nhận, sau đó khởi động container với --ipc=host để sử dụng bộ nhớ chia sẻ của máy chủ, hoặc dùng --shm-size=1g để tăng dung lượng bộ nhớ của chính container đó. --disable-dev-shm-usage chỉ chuyển vấn đề sang /tmp mà thôi.
Dùng --no-sandbox có an toàn nếu VPS không chạy dịch vụ nào khác không?
Không. Sandbox là cơ chế ngăn chặn một trang web độc hại truy cập vào phần còn lại của máy chủ. Các trang tài liệu bảo mật của Chromium ghi rõ về flag này: "Chúng tôi không khuyến khích điều này vì nó làm giảm đáng kể tính bảo mật và có thể khiến Chromium không hoạt động đúng cách." Một agent khi truy cập các đường link cũng giống như đang duyệt web công cộng. Hãy sửa tận gốc vấn đề: không chạy trình duyệt dưới quyền root, và trên Ubuntu 24.04 hãy thêm một profile AppArmor chứa userns, cho đường dẫn file thực thi của trình duyệt, để cho phép user namespaces không đặc quyền đối với riêng chương trình đó.
Tôi có thể chạy bao nhiêu trình duyệt trên một VPS nhỏ?
Hãy đo lường, đừng sao chép một con số cố định. Chromium khởi chạy một tiến trình renderer cho mỗi trang web, nên câu trả lời phụ thuộc vào các trang bạn mở. Hãy chạy một worker dưới quyền systemd-run với MemoryMax được thiết lập, đọc giá trị đỉnh từ dòng Memory: trong systemctl status, sau đó chia dung lượng RAM trống của bạn cho giá trị đỉnh đó và giữ lại một phần dự phòng. Hãy áp dụng kết quả này hai lần, kết hợp với một hàng đợi trong code và một MemoryMax trong file unit, để khi có lượng request tăng đột biến, chúng sẽ chờ thay vì làm máy chủ bị swap.
Agent của tôi có thể kết nối tới trình duyệt từ một máy khác không?
Có, nhưng tuyệt đối không được bind cổng ra 0.0.0.0. Cả endpoint của Playwright server và cổng Chrome DevTools đều chấp nhận bất kỳ client nào kết nối tới mà không cần mật khẩu. Hãy giữ listener ở 127.0.0.1 và thực hiện kết nối thông qua SSH tunnel hoặc VPN riêng. Xác minh bằng ss -ltnp trên máy chủ và kiểm tra cổng từ bên ngoài, đồng thời kiểm tra cả firewall mạng riêng của nhà cung cấp VPS.
Tại sao ảnh chụp màn hình bị trắng trong khi trang web đã load xong?
Do thiếu font. Nếu không có font hỗ trợ script của trang web, văn bản sẽ hiển thị thành các ô trống hoặc không hiển thị gì cả, khiến một trang web ít hình ảnh trông như bị trắng. Hãy chạy fc-match "sans-serif:lang=ko" cho mỗi ngôn ngữ bạn cần scrape, cài đặt fonts-noto-core và fonts-noto-cjk khi câu trả lời là một font fallback chung, sau đó khởi động lại trình duyệt để fontconfig tải lại cache. Một container không có font sẽ log Fontconfig error: Cannot load default config file khi khởi động.