SSD Nodes Learn Hosting plans →
Hướng dẫn Matt ConnorBởi Matt Connor

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.

Bạn đang chạy gì

Headless browser trên VPS là Chromium không có cửa sổ, được điều khiển bằng code thay vì người dùng. Trên server, đây là một cây tiến trình chạy lâu dài để agent của bạn giao tiếp qua local socket. Cài đặt chỉ cần một lệnh. Phần việc chính nằm ở mọi thứ sau đó. Bạn phải giới hạn tài nguyên browser được phép sử dụng và giữ endpoint điều khiển của nó ngoài Internet công cộng.

Hướng dẫn này giả định bạn đã chọn công cụ và bây giờ cần vận hành công cụ đó. Nếu bạn vẫn đang so sánh các crawler và extractor, hãy bắt đầu với các lựa chọn thay thế Firecrawl tự host rồi quay lại đây. Toàn bộ nội dung bên dưới sử dụng Chromium của Playwright, vì Playwright cung cấp browser build riêng và trình cài dependency riêng. Do đó, cùng một bộ lệnh có thể chạy trên Ubuntu VPS cài trực tiếp và bên trong container. Các lệnh cố định Playwright ở phiên bản 1.62.

Không đoán dependency khi cài Chromium

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 quyền root khi cần. Bản build của browser được tải vào ~/.cache/ms-playwright cho user đã chạy lệnh. Đ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 bằng quyền admin với sudo npx playwright install-deps chromium, sau đó đặt PLAYWRIGHT_BROWSERS_PATH=/opt/pw-browsers trong cả lệnh cài đặt và service unit để dùng chung một bản. Service không nhìn thấy browser sẽ fail khi khởi động và hiển thị thông báo chứa path mà nó đã tìm kiếm.

Hãy pin phiên bản Playwright. Mỗi release gắn với một browser build cụ thể, vì vậy npm update không được pin có thể thay browser trong khi service đang chạy. Tính đến November 16, 2026, release mới nhất là 1.65.1, nên hãy đọc release notes trước khi thay đổi phiên bản đã pin. Trên server ARM64, lưu ý rằng 1.63 đã đổi tên các thư mục browser. Điều này ảnh hưởng đến AppArmor profile được đề cập ở phần sau.

Có 2 Chromium build và chúng không phải cùng một chương trình. Ở headless mode, Playwright mặc định dùng headless shell, một binary nhỏ hơn chỉ chạy headless. Lệnh cài đặt thông thường tải nó cùng với full browser, còn npx playwright install --with-deps --only-shell chỉ cài shell. Full browser là 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, vì vậy xác thực hơn, đáng tin cậy hơn và có nhiều tính năng hơn”. Hãy dùng shell để fetch số lượng lớn. Dùng full browser khi website hoạt động khác thường và bạn cần tìm nguyên nhân.

Vì sao headless browser bị crash trong container

Docker cấp cho mỗi container một /dev/shm 64 MB. Tài liệu Docker nêu rõ: "Nếu bạn bỏ qua hoàn toàn kích thước, hệ thống sẽ dùng 64m". Chromium truyền nội dung đã render giữa các process thông qua vùng shared memory này, nên một trang nặng có thể làm đầy vùng đó. Sau đó renderer bị dừng và client của bạn báo target bị crash, dù trang này vẫn hoạt động bình thường trên laptop. Hãy xác nhận kích thước từ bên trong container trước khi thay đổi bất cứ điều gì.

df -h /dev/shm

Có 2 cách khắc phục thực sự và chúng là các lựa chọn thay thế, không dùng đồng thời. --ipc=host đưa container vào IPC namespace của host để sử dụng /dev/shm của host, thường có kích thước bằng một nửa RAM. Hướng dẫn Docker của Playwright khuyến nghị cách này vì nếu không, "Chromium có thể hết bộ nhớ và crash". Đổi lại, bạn mất isolation IPC giữa container và host. --shm-size=1g giữ namespace riêng và chỉ 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/bash

Flag --disable-dev-shm-usage là cách khắc phục bạn sẽ thấy trong hầu hết kết quả tìm kiếm, nhưng nó thực hiện việc khác: chuyển các file đó từ /dev/shm sang một thư mục tạm thời. Nếu /tmp nằm trên disk, bạn đã đổi lỗi crash lấy tốc độ render chậm hơn và nhiều thao tác ghi disk hơn. Nếu /tmp là tmpfs, dữ liệu vẫn nằm trong RAM và chỉ bị giới hạn bởi giới hạn kích thước của tmpfs; tài liệu kernel đặt giới hạn mặc định này bằng một nửa RAM vật lý, đồng thời các page của tmpfs có thể bị đẩy sang swap. Đây là một cách khiến browser ngốn hết một VPS nhỏ. Playwright 1.62 truyền --disable-dev-shm-usage theo mặc định; để sử dụng /dev/shm mà bạn đã cấp kích thước, hãy xóa argument đó bằng ignoreDefaultArgs: ['--disable-dev-shm-usage'] trong các launch option.

Cái giá thực sự của --no-sandbox

Chromium cô lập mỗi renderer trong một sandbox được xây dựng trên Linux user namespace. Sandbox đó là ranh giới giữa trang web độc hại và server của bạn. Playwright mặc định tắt sandbox của Chromium, vì vậy hãy bật nó bằng chromiumSandbox: true trong tùy chọn khởi chạy. Khi sandbox đã bật nhưng không thể khởi động, Chromium sẽ từ chối chạy và log sẽ có dòng như sau:

Failed to move to new namespace: PID namespaces supported, Network namespace supported, but failed: errno = Operation not permitted

Khuyến nghị thường gặp là --no-sandbox. Các trang bảo mật của chính 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ể mức độ bảo mật của bạn và có thể khiến Chromium không hoạt động đúng." Agent làm theo các liên kết thì về bản chất đang duyệt web công khai. Đây chính là môi trường kiểm tra mức bảo mật đã bị giảm đó. Hãy tìm nguyên nhân thực sự.

Chạy với root và user namespace bị chặn là hai nguyên nhân cần kiểm tra. Sandbox của Chromium không khả dụng khi chạy với root. Vì vậy image của Playwright cung cấp một user thông thường tên là pwuser. Trong Docker, Playwright cũng khuyến nghị dùng seccomp profile cho phép clone, setns và unshare để duyệt web có sandbox. Trên Ubuntu 24.04 trở lên, AppArmor hạn chế user namespace không đặc quyền. Một binary Chromium nằm ở path không có profile đi kèm nào bao phủ sẽ bị từ chối. Bản tải xuống của Playwright trong ~/.cache/ms-playwright đúng là một path như vậy. Hãy kiểm tra cả hai:

id -u
sysctl kernel.apparmor_restrict_unprivileged_userns
sudo dmesg | grep -i userns_create

Giá trị 1 từ sysctl cùng với một dòng kernel có 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ữ hạn chế đối với mọi binary 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 cấu hình bằng sudo apparmor_parser -r /etc/apparmor.d/pw-chromium. Trên x86-64, Playwright đặt toàn bộ browser tại chrome-linux64/chrome và shell tại chrome-headless-shell-linux64/chrome-headless-shell. Trên ARM64, Playwright 1.62 cài chúng vào hai thư mục riêng: chromium-<revision>/chrome-linux/chrome và chromium_headless_shell-<revision>/chrome-linux/headless_shell. Từ bản 1.63, ARM64 dùng cùng cấu trúc với x86-64, gồm chrome-linux-arm64/chrome và chrome-headless-shell-linux-arm64/chrome-headless-shell. Glob chrome-* bao phủ tất cả các layout này. Nhánh /opt/pw-browsers bao phủ cả installation dùng chung được tạo bằng PLAYWRIGHT_BROWSERS_PATH. Path cũng chứa revision của browser nên thay đổi sau mỗi lần nâng cấp Playwright. Các glob ở trên không bị ảnh hưởng bởi thay đổi đó. Profile ghi theo một path chính xác sẽ âm thầm ngừng khớp. Sau một lần update tưởng như không liên quan, browser lại bắt đầu fail.

Vì sao screenshot trống hoặc đầy các ô vuông

Screenshot trống hoặc đầy các hình chữ nhật rỗng thường là vấn đề về font, không phải lỗi render. install-deps cài sẵn một bộ font cơ bả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 và 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ố hệ chữ khác sẽ fallback sang font mà fontconfig tìm được. Hãy yêu cầu fontconfig kiểm tra thay vì đoán:

fc-match "sans-serif:lang=ko"
fc-match "sans-serif:lang=ar"
fc-list | wc -l

Nếu ngôn ngữ bạn cần được resolve thành unifont hoặc 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 kết quả, vì vậy hãy restart browser sau khi cài font. Image đã bị lược bỏ toàn bộ font sẽ ghi Fontconfig error: Cannot load default config file khi khởi động và render mọi trang thành nội dung trống.

Locale và time zone không phụ thuộc vào font. Chúng thay đổi nội dung trang hiển thị, không chỉ cách hiển thị. Locale và time zone của context trong Playwright mặc định lấy theo thiết lập hệ thống. Vì vậy, hãy kiểm tra cấu hình của image thay vì giả định LANG chưa được set hoặc time zone là UTC. Hãy set chúng theo từng browser context thay vì theo từng máy. Nhờ đó, 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 -20

Số 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.

Cần bao nhiêu RAM cho một browser context

Hãy đặt câu hỏi chính xác, vì “một browser” không phải là một process. Chromium chạy một browser process, một GPU process, các utility process và một renderer process cho mỗi site. Site isolation cũng cấp cho iframe khác site một renderer riêng. Một BrowserContext là một cookie jar và vùng lưu trữ riêng bên trong cùng cây process đó, nên context thứ hai không tốn nhiều tài nguyên. Page thứ hai thì khác, vì nó khởi chạy các renderer process. Một trang có nhiều quảng cáo còn có thể khởi chạy nhiều process hơn.

Vì vậy, số cần đo là mức sử dụng memory cao nhất của toàn bộ cây process trong workload của bạn. Con số từ blog của người khác không có giá trị ở đây, vì chính các page mà agent mở mới quyết định mức sử dụng. Hãy đo trên máy bạn sẽ dùng, với đúng các site 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-probe

Trên Ubuntu 24.04, dòng Memory: trong output đó cho biết mức sử dụng hiện tại và cao nhất của unit. Chạy worker với mỗi lần chỉ mở một page, ghi lại mức cao nhất, rồi lặp lại với hai page đang mở để biết page thứ hai thực sự tốn bao nhiêu. Sau đó tính concurrency như sau: lấy tổng RAM, trừ phần mà các thành phần khác của máy cần dùng, chừa lại vài trăm MB dự phòng, rồi chia cho mức cao nhất đã đo trên mỗi worker. Để sizing máy bên dưới, xem agent VPS cần bao nhiêu RAM và CPU.

Hãy áp dụng giới hạn này ở hai nơi. Trong code, dùng fixed worker pool hoặc semaphore để một burst request từ agent được xếp hàng thay vì khởi chạy thêm browser. Trong OS, dùng cgroup limit để lỗi trong hàng đợi không kéo sập cả máy:

[Service]
MemoryMax=2G
MemorySwapMax=0
TasksMax=512
Restart=always

MemorySwapMax=0 quan trọng hơn bạn nghĩ. Nếu không có nó, cgroup có thể đẩy page vào swap khi gần chạm giới hạn. Khi đó máy thường vẫn hoạt động nhưng mọi request đều chậm, khó chẩn đoán hơn một lỗi dừng rõ ràng. Swap chỉ trì hoãn sự cố: tài liệu của systemd nêu rằng nếu mức sử dụng “không thể được giữ trong giới hạn, out-of-memory killer sẽ được gọi bên trong unit”. Khi swap được giới hạn ở 0, unit không thể dùng swap. Khi chạm đến MemoryMax, hệ thống sẽ reclaim trước khi OOM kill nếu reclaim không thể kiểm soát mức sử dụng. Restart=always khởi động lại service khi main process của nó thoát, nhưng việc renderer bị OOM kill riêng lẻ không đảm bảo service sẽ được khởi động lại. Các control tương ứng trong Compose là mem_limit, shm_size và init, được trình bày trong thiết lập memory limit 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 -ltnp

Bấ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-vps

Rủ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à đầu vào không đáng tin cậy

Agent duyệt web công khai sẽ đưa văn bản do người lạ viết vào model, trong khi model cũng nhận được instruction của bạn. Một trang có thể chứa văn bản nhắm đến model đó, yêu cầu model bỏ qua nhiệm vụ, gọi tool hoặc gửi dữ liệu đế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 instruction của bạn. Hãy thiết kế hệ thống sao cho một trang độc hại có ít khả năng gây ảnh hưởng.

  • Chạy browser dưới một OS user riêng, không có SSH key và cloud credential trong environment.
  • Dùng context mới cho mỗi task, đồng thời --isolated với Playwright MCP; đóng browser MCP giữa các task để xóa storage của session đó.
  • Duy trì allowlist origin khi job hỗ trợ. Playwright MCP nhận --allowed-origins và --blocked-origins dưới dạng các danh sách phân tách bằng dấu chấm phẩy. Các bộ lọc này không áp dụng cho redirect và không phải là security boundary.
  • Yêu cầu con người xác nhận trước mọi action làm thay đổi trạng thái, chẳng hạn gửi mail hoặc chi tiền.

Tốt hơn nữa, hãy chạy toàn bộ browser trên một máy có thể hủy 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 job 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 do bạn tự vận hành trả về kết quả mà không bao giờ tải trang độc hại.

FAQ

Tại sao Chromium bị crash trong Docker nhưng chạy bình thường trực tiếp trên cùng VPS?

Vì container mặc định chỉ có 64 MB /dev/shm, trong khi host có vùng lớn hơn nhiều. Chromium đưa nội dung đã render qua vùng shared memory này, nên một trang nặng có thể làm đầy vùng đó và khiến renderer dừng. Chạy df -h /dev/shm bên trong container để xác nhận. Sau đó khởi động bằng --ipc=host để dùng shared memory của host, hoặc bằng --shm-size=1g để tăng kích thước vùng riêng của container. --disable-dev-shm-usage chỉ chuyển vấn đề sang /tmp. Playwright 1.62 mặc định truyền flag đó. Dùng ignoreDefaultArgs: ['--disable-dev-shm-usage'] để Chromium sử dụng vùng shared memory bạn đã cấp.

Dùng --no-sandbox có an toàn nếu VPS không chạy thêm gì khác không?

Không. Sandbox ngăn một trang độc hại truy cập phần còn lại của máy. Các trang bảo mật của Chromium ghi rõ về flag này: "We do not encourage this as it will significantly reduce your security, and may prevent Chromium from working properly." Một agent làm nhiệm vụ theo các liên kết là đang duyệt web công khai. Hãy sửa nguyên nhân thay vì tắt sandbox: không chạy browser bằng root. Trên Ubuntu 24.04, hãy thêm một AppArmor profile chứa userns, cho đường dẫn binary của browser, để cho phép unprivileged user namespaces chỉ đối với chương trình đó. Bật sandboxing rõ ràng bằng chromiumSandbox: true. Trong Docker, đồng thời dùng seccomp profile được Playwright khuyến nghị.

Tôi có thể chạy bao nhiêu browser trên một VPS nhỏ?

Hãy đo thực tế, không sao chép một con số có sẵn. Chromium khởi động một renderer process cho mỗi site, nên số lượng phụ thuộc vào các trang bạn mở. Chạy một worker dưới systemd-run với MemoryMax được thiết lập. Đọc mức cao nhất từ dòng Memory: trong systemctl status, sau đó chia RAM còn trống cho mức đó và giữ lại một phần dự phòng. Thực thi giới hạn này ở 2 nơi: dùng queue trong code và một MemoryMax trong unit file, để một đợt request tăng đột biến phải chờ thay vì làm máy bắt đầu swap.

Agent của tôi có thể kết nối đến browser từ một máy khác không?

Có, nhưng không được bind port vào 0.0.0.0. Playwright server endpoint và Chrome DevTools port đều chấp nhận mọi client có thể truy cập đến chúng, không cần password. Giữ listener trên 127.0.0.1 và truyền kết nối qua SSH tunnel hoặc private VPN. Xác minh bằng ss -ltnp trên server, kiểm tra port từ bên ngoài, đồng thời kiểm tra network firewall riêng của nhà cung cấp.

Tại sao screenshot của tôi bị trắng dù trang đã tải rõ ràng?

Thiếu font. Nếu không có font hỗ trợ script của trang, text sẽ hiển thị thành các ô trống hoặc không hiển thị, nên một trang ít hình ảnh có thể cho ra ảnh trông như trắng hoàn toàn. Chạy fc-match "sans-serif:lang=ko" cho từng ngôn ngữ bạn scrape. Cài fonts-noto-core và fonts-noto-cjk khi kết quả là một fallback generic. Sau đó restart browser để fontconfig nạp lại cache. Container hoàn toàn không có font sẽ ghi Fontconfig error: Cannot load default config file khi khởi động.

Bài viết này có hữu ích không?