Quản lý Phiên Trình Duyệt Đám Mây: Tạo, Kết Nối Lại và Dừng An Toàn
TL;DR
Một vòng đời phiên trình duyệt đám mây theo dõi tài nguyên trình duyệt được quản lý, độc lập với việc đăng nhập vào một trang web hoặc kết nối khách hàng.
Lưu trữ một UUID v4 requestId và toàn bộ nội dung tạo trước khi gửi yêu cầu tạo phiên.
Thử lại một lần tạo không chắc chắn với cùng một ID và nội dung giống hệt; cấu hình thay đổi yêu cầu một ID mới.
ready có nghĩa là trình duyệt có sẵn để gắn, không phải rằng nhiệm vụ kinh doanh của bạn đã thành công.
Làm mới Live View hoặc kết nối lại CDP không làm reset tuổi thọ của trình duyệt.
Một yêu cầu dừng chỉ hoàn thành khi phiên gốc đạt đến ended; stopping là trung gian.
Vòng Đời Phiên Trình Duyệt Là Gì?
Một vòng đời phiên trình duyệt là chuỗi các trạng thái mà một trình duyệt được quản lý trải qua từ khi tạo cho đến khi kết thúc. Nó mô tả tài nguyên mà tự động hóa của bạn tiêu thụ. Một phiên xác thực trang web mô tả liệu một trang web cụ thể có xem người dùng đã đăng nhập hay không, trong khi một kết nối khách hàng CDP mô tả liệu chương trình của bạn hiện đang được gắn hay không. Ba thời gian tồn tại này có thể kết thúc độc lập.
Nstdata Cloud Browser cung cấp các trình duyệt đám mây được quản lý cho tự động hóa trình duyệt và các đại lý AI. Quản lý tài nguyên đó một cách rõ ràng cho phép một nhóm khôi phục từ các sự cố của người lao động, điều phối một sự chuyển giao giữa con người, và tính toán thời gian chạy sau khi nhiệm vụ trang hoàn tất. Giới thiệu Cloud Browser cung cấp bối cảnh sản phẩm; hướng dẫn này tập trung vào quyền sở hữu và các chuyển đổi trạng thái cần thiết trong một trình chạy công việc thực tế.
Ví dụ, kịch bản của bạn có thể mất WebSocket trong khi trình duyệt vẫn sẵn sàng và đã đăng nhập vào một ứng dụng. Ngược lại, socket có thể vẫn kết nối trong khi trang web hết hạn phiên đăng nhập. Một cờ đơn lẻ không thể đại diện cho cả hai điều kiện một cách chính xác.
Nstdata Cloud Browser Trình duyệt của bạn trên đám mây
success
Ứng Dụng Của Bạn Nên Xử Lý Những Trạng Thái Nào?
Ứng dụng của bạn nên xử lý creating, unknown, ready, stopping, ended, và failed từ trường state của phản hồi phiên. Đừng tìm trường status không tài liệu hoặc suy diễn trạng thái tài nguyên từ một hình ảnh xem trước.
Trạng thái
Ý nghĩa cho trình điều khiển
Hành động tiếp theo phù hợp
creating
Khởi động trình duyệt đang được tiến hành
Kiểm tra phiên cùng một trong một thời gian chết
unknown
Trạng thái tài nguyên hiện tại không chắc chắn
Điều chỉnh lại thao tác gốc; tránh tạo bản sao
ready
Trình duyệt có thể chấp nhận một kết nối
Nhận thông tin xác thực và xác minh trạng thái trang của nhiệm vụ
stopping
Yêu cầu tắt máy đã được gửi
Tiếp tục kiểm tra ended
ended
Phiên này đã hoàn tất
Đừng cố gắng làm hồi sinh nó với thông tin xác thực cũ
failed
Tài nguyên đã thất bại
Ghi lại bối cảnh thất bại và giải quyết việc dọn dẹp trước khi cố gắng mới
Hướng dẫn API Tự Động Hóa Trình Duyệt hiện tại là hợp đồng cho các giá trị này. Giữ một trạng thái nhiệm vụ ứng dụng riêng như đang-chờ-người, đang-làm việc, đã-được-chấp-nhận, hoặc đã-bị-từ-chối. Đó là các trạng thái công việc của riêng bạn, không phải là các trạng thái API Cloud Browser bổ sung.
Bạn Cần Những Endpoint Và Tham Số Nào?
Bạn cần các endpoint tùy chọn, tạo, kiểm tra, cấp phát thông tin xác thực và xóa dưới https://api.nstdata.io/api/v1/cloud-browser. Lấy các tùy chọn hiện tại trước khi xây dựng nội dung tạo vì các lớp tài nguyên, quốc gia, và khoảng thời gian cho phép phụ thuộc vào cấu hình dịch vụ hiện tại.
Ví dụ tạo cũng cung cấp targetUrl, recording: false, và captchaSolver: { enabled: false }. Xem lại warnings và effectiveConfiguration từ phản hồi tạo khi tùy chỉnh nó. Một cảnh báo cấu hình cần được điều tra trước khi công việc được phép thực hiện công việc có ý nghĩa.
Sử dụng x-api-key mà không có Bearer cho các cuộc gọi HTTP vòng đời. Nhận một khóa cá nhân dưới Settings → Account hoặc một khóa thành viên liên kết dưới Members. Với một khóa cá nhân, tùy chọn x-team-id chọn một đội tham gia; giữ cùng một giá trị trong mọi yêu cầu. Thông tin xác thực CDP được cấp phát riêng và không bao giờ nên được lưu trữ trong bản ghi công việc.
Làm Thế Nào Bạn Tạo Và Dừng Một Phiên Mà Không Tạo Bản Sao?
Tạo và dừng một phiên một cách an toàn bằng cách lưu giữ yêu cầu mong muốn trước khi tạo, giữ lại ID phiên đã trả về, và xem việc dừng lại như một trạng thái chuyển tiếp đã được xác nhận. Ví dụ này cố ý tách rời các lệnh để một công nhân bị ngắt có thể tiếp tục ý định hiện tại của mình.
Bước 1: Chuẩn bị dự án Node.js
Sử dụng Node.js 22.12 trở lên và tạo một thư mục làm việc. Bộ điều khiển vòng đời sử dụng các API Node tích hợp sẵn và không cài đặt khách hàng trình duyệt.
mkdir browser-lifecycle-demo
cd browser-lifecycle-demo
Tạo một tệp riêng tư .env chứa NSTDATA_API_KEY và, chỉ nếu cần thiết, NSTDATA_TEAM_ID. Loại trừ .env và bản ghi công việc được tạo ra khỏi kiểm soát phiên bản. Chạy mỗi công việc trong thư mục riêng của nó hoặc chọn một đường dẫn JOB_FILE riêng biệt.
Bước 2: Lưu trợ giúp HTTP
Lưu mô-đun này dưới dạng cloud-api.mjs. Nó xác thực phong bì phản hồi và tránh in các thông điệp máy chủ thô có thể chứa dữ liệu nhạy cảm. Thời gian chờ AbortSignal của Node giới hạn mỗi yêu cầu độc lập với vòng đời của trình duyệt.
Điều kiện tiên quyết về chứng chỉ: các yêu cầu HTTP này yêu cầu một khóa kinh doanh Nstdata. Hành vi API đã được kiểm tra theo tài liệu hiện có và các bài kiểm tra chuyển tiếp trạng thái tổng hợp; bài viết này không yêu cầu một phiên chạy tài khoản quản lý trực tiếp.
const root ='https://api.nstdata.io/api/v1/cloud-browser';exportasyncfunctionapi(method, path, body){const key = process.env.NSTDATA_API_KEY;if(!key)thrownewError('Set NSTDATA_API_KEY');const headers ={'x-api-key': key };if(process.env.NSTDATA_TEAM_ID) headers['x-team-id']= process.env.NSTDATA_TEAM_ID;if(body) headers['content-type']='application/json';let response;try{ response =awaitfetch(root + path,{ method, headers,redirect:'error',body: body ?JSON.stringify(body):undefined,signal:AbortSignal.timeout(20_000),});}catch{throwObject.assign(newError('API transport failed; reconcile the original operation'),{retryable:true});}const retryable = response.status===429|| response.status>=500;let result;try{ result =await response.json();}catch{throwObject.assign(newError('Invalid API JSON'),{ retryable });}if(!response.ok|| result.err===true|| result.success===false){throwObject.assign(newError(`Cloud Browser API HTTP ${response.status}`),{ retryable });}if(!result.data)thrownewError('Missing API data');return result.data;}exportasyncfunctionconnection(id){if(!id)thrownewError('Set NSTDATA_SESSION_ID');const path =`/sessions/${encodeURIComponent(id)}`;const session =awaitapi('GET', path);if(session.state!=='ready')thrownewError(`Session is ${session.state}, not ready`);const c =awaitapi('POST', path +'/automation-credentials');if(c.sessionId!== id ||!c.headerName||!c.accessToken||!(Date.parse(c.expiresAt)>Date.now())||newURL(c.cdpUrl).protocol!=='wss:'){thrownewError('Invalid or expired CDP credentials');}return{endpoint: c.cdpUrl,headers:{[c.headerName]: c.headerName.toLowerCase()==='authorization'?`Bearer ${c.accessToken}`: c.accessToken},};}exportasyncfunctionendpoint(){// An isolated local CDP endpoint can test the client without managed credentials.if(process.env.LOCAL_CDP_URL){const url =newURL(process.env.LOCAL_CDP_URL);if(!['127.0.0.1','localhost','[::1]'].includes(url.hostname)){thrownewError('LOCAL_CDP_URL must use loopback');}return{endpoint: url.href,headers:{}};}returnconnection(process.env.NSTDATA_SESSION_ID);}
Bước 3: Lưu bộ điều khiển có thể tiếp tục
Lưu đoạn mã sau dưới dạng lifecycle.mjs. Bộ điều khiển chỉ tạo bản ghi cục bộ và từ chối ghi đè ý định hiện có. Vòng lặp thử lại của nó tái sử dụng phần thân đã lưu, bao gồm cùng một UUID được tạo với Node.js randomUUID.
Điều kiện tiên quyết về chứng chỉ: nhánh API yêu cầu khóa không gian làm việc của bạn. Hành vi phục hồi và tạo lại nhiều lần đã được thử nghiệm với một vật liệu HTTP được tách biệt rõ ràng, không được trình bày dưới dạng đầu ra dịch vụ Nstdata.
import{ randomUUID }from'node:crypto';import{ readFile, writeFile }from'node:fs/promises';import{ setTimeout as delay }from'node:timers/promises';import{ api }from'./cloud-api.mjs';const file = process.env.JOB_FILE||'browser-job.json';constpathFor=id=>`/sessions/${encodeURIComponent(id)}`;constsave=job=>writeFile(file,JSON.stringify(job,null,2),{mode:0o600});asyncfunctionretry(operation){for(let attempt =0;; attempt++){try{returnawaitoperation();}catch(error){if(!error.retryable|| attempt ===2)throw error;awaitdelay(500*2** attempt +Math.random()*250);}}}asyncfunctionwait(id, expected){const deadline =Date.now()+90_000;while(Date.now()< deadline){const session =awaitretry(()=>api('GET',pathFor(id)));if(session.state=== expected)return session;if(['ended','failed'].includes(session.state)){thrownewError(`Session ${session.state}; expected ${expected}`);}awaitdelay(2_000);}thrownewError('State wait expired; inspect the original session');}const command = process.argv[2];if(command ==='create'){const options =awaitapi('GET','/sessions/options');const{ resourceClass, proxyCountry, ttlSeconds }= options.defaults;if(!options.resourceClasses.some(x=> x.value=== resourceClass)||!options.proxyCountries.some(x=> x.value=== proxyCountry)||!Number.isInteger(ttlSeconds)|| ttlSeconds < options.session.minSeconds|| ttlSeconds > options.session.maxSeconds)thrownewError('Inspect current options');const job ={body:{requestId:randomUUID(),name:'lifecycle-demo', resourceClass, proxyCountry, ttlSeconds,targetUrl:'https://example.com/',recording:false,captchaSolver:{enabled:false}}};awaitwriteFile(file,JSON.stringify(job,null,2),{flag:'wx',mode:0o600});console.log('Saved create intent. Run: node lifecycle.mjs resume');}elseif(['resume','inspect','stop'].includes(command)){const job =JSON.parse(awaitreadFile(file,'utf8'));if(!job.sessionId&& command ==='resume'){const created =awaitretry(()=>api('POST','/sessions', job.body));if(typeof created.sessionId!=='string'||!created.sessionId)thrownewError('Missing sessionId'); job.sessionId= created.sessionId; job.configurationWarningsPresent=Boolean(created.warnings?.length);awaitsave(job);}if(!job.sessionId)thrownewError('Resume the original create intent first');if(command ==='stop'){const current =awaitapi('GET',pathFor(job.sessionId));if(current.state!=='ended')awaitretry(()=>api('DELETE',pathFor(job.sessionId)));awaitwait(job.sessionId,'ended');}elseif(command ==='resume'){awaitwait(job.sessionId,'ready');}const current =awaitapi('GET',pathFor(job.sessionId));console.log(JSON.stringify({sessionId: job.sessionId,state: current.state,configurationWarningsPresent: job.configurationWarningsPresent}));}elsethrownewError('Use create, resume, inspect, or stop');
Bước 4: Lưu một ý định tạo
Chạy lệnh tạo. Nó lấy các giá trị mặc định hợp lệ và ghi browser-job.json trước bất kỳ yêu cầu tạo phiên nào. Tập tin là một hồ sơ vận hành cục bộ, không phải một trường API Cloud Browser.
node --env-file=.env lifecycle.mjs create
Lệnh này cố ý không khởi động trình duyệt. Kiểm tra lớp tài nguyên đã ghi, quốc gia, thời gian sống và URL mục tiêu trước khi tiếp tục. Nếu cấu hình cần thay đổi tại giai đoạn này, hãy bắt đầu một ý định mới có chủ ý với một tập tin công việc và ID yêu cầu mới; không tái sử dụng một ID đã được gửi đến dịch vụ.
Bước 5: Tiếp tục ý định đã lưu
Chạy lệnh tiếp tục để gửi yêu cầu đã ghi lại và chờ đến ready. Nếu việc tạo không trả về kết quả có thể sử dụng, hãy điều tra và tiếp tục cùng một bản ghi thay vì xóa nó và chạy lại lệnh tạo.
node --env-file=.env lifecycle.mjs resume
Thành công in ra sessionId gốc và trạng thái quan sát được. Giá trị configurationWarningsPresent là true có nghĩa là bạn nên kiểm tra cấu hình tạo trước khi gắn một tác vụ. Các lần thử giới hạn trong ví dụ là một chính sách minh họa, không phải là một lời hứa rằng mọi thất bại tạm thời sẽ phục hồi.
Bước 6: Kiểm tra phiên gốc
Sử dụng lệnh kiểm tra khi một công nhân hoặc khách hàng CDP ngắt kết nối. Phiên đó có thể vẫn đang chạy. Nếu nó sẵn sàng, một khách hàng tự động riêng biệt có thể yêu cầu thông tin xác thực mới và tìm lại trạng thái trang của nó.
node --env-file=.env lifecycle.mjs inspect
Đừng khôi phục hành động chỉ từ bộ nhớ. Xác định xem bước trước đó đã hoàn thành hay chưa trước khi lặp lại, đặc biệt nếu nó có thể gửi một mẫu hoặc tạo một bản ghi. Hướng dẫn xử lý lỗi của bộ thu thập sản phẩm production scraper error-handling guide giải thích tại sao việc thử lại trong vận tải và thử lại trong hoạt động kinh doanh cần các chính sách khác nhau.
Bước 7: Dừng lại và xác nhận việc kết thúc
Chạy lệnh dừng sau tác vụ của bạn hoặc ngay lập tức sau buổi trình diễn vòng đời này. Nó yêu cầu xóa khi cần thiết, chờ đến ended, và in ra trạng thái quan sát cuối cùng.
node --env-file=.env lifecycle.mjs stop
Nếu không thể xác nhận việc tắt, hãy giữ hồ sơ công việc và kiểm tra phiên gốc trong Cloud Browser → Session History. Một lỗi xuất hiện không nên được chuyển đổi thành một chỉ số dọn dẹp thành công.
[Screenshot: Lịch sử phiên hiển thị phiên gốc đã kết thúc, với các URL truy cập và chi tiết tài khoản bị ẩn.]
Cloud Browser hỗ trợ quản lý vòng đời phiên như thế nào?
Trình duyệt đám mây Nstdata cung cấp cho một người điều khiển các thao tác tạo, kiểm tra, gắn kết và dừng phiên một cách rõ ràng. Bảng điều khiển cung cấp cho người vận hành một cách thứ hai để kiểm tra tài nguyên khi một công nhân bị lỗi. Các thông tin xác thực tự động tạm thời giữ cho quyền truy cập kết nối tách biệt với khóa API của doanh nghiệp. Cấu hình proxy tích hợp thuộc về phiên thay vì từng kịch bản khách hàng. Những khả năng này giúp một nhóm thực hiện việc phục hồi, nhưng chúng không thay thế cơ sở dữ liệu công việc hoặc quy tắc sở hữu của nó.
Khám phá cấu hình hiện tại: đọc các giá trị tùy chọn hỗ trợ thay vì triển khai các lớp tài nguyên mã hóa cứng hoặc giới hạn thời gian sống.
Thời gian chạy có thể kiểm tra: liên kết một ID phiên với trình duyệt hoạt động và lịch sử khi một nhiệm vụ bị gián đoạn.
Gắn kết có kiểm soát: phát hành thông tin xác thực cho phiên sẵn sàng dự định và kết nối lại mà không giả định một phiên mới chứa trạng thái cũ.
Kết thúc rõ ràng: làm cho việc tắt xác nhận trở thành một phần của hồ sơ hoàn thành công việc.
Thời gian chạy của trình duyệt, lưu lượng proxy và hoạt động CAPTCHA tùy chọn nên được đánh giá riêng biệt bằng cách sử dụng giá cả của Cloud Browser. Chờ đợi một con người hoặc gỡ lỗi một trang bị kẹt có thể giữ cho trình duyệt hoạt động. Giới hạn thời gian phiên ràng buộc việc tiếp xúc, nhưng việc dừng chủ động vẫn là dọn dẹp bình thường.
Những vấn đề nào vẫn có thể xảy ra trong môi trường production?
Các lỗi trong vòng đời sản xuất thường phát sinh từ việc tạo không chắc chắn, các chủ sở hữu cạnh tranh, dọn dẹp bị gián đoạn, hoặc đối xử với trạng thái xác thực như trạng thái trình duyệt.
Triệu Chứng
Nguyên Nhân
Phản Ứng
Thời gian tạo đã hết hạn
Phản hồi có thể đã bị mất sau khi tạo
Bảo lưu phần thân gốc và ID yêu cầu; hòa giải thao tác đó
HTTP 400
Cấu hình rõ ràng không hợp lệ hoặc đã lỗi thời
Lấy tùy chọn và sửa trường; sử dụng một ý định mới khi thay đổi cấu hình
HTTP 401/403/470
Xác thực doanh nghiệp hoặc sai sót không gian làm việc
Kiểm tra khóa và bối cảnh nhóm nhất quán
HTTP 409
Trạng thái xung đột hoặc ID đã sử dụng với các tham số đã thay đổi
Kiểm tra thao tác và phiên gốc
HTTP 429/503
Áp lực năng lực tạm thời hoặc tỷ lệ
Áp dụng backoff giới hạn cho cùng một thao tác
Dừng vẫn chưa được xác nhận
Việc tắt bị trì hoãn hoặc người điều khiển đã mất kết nối
Kiểm tra lại cùng một phiên và tăng cường lên một người vận hành
Hồ sơ JSON cục bộ là đủ cho một buổi trình diễn của một công nhân duy nhất. Nó không phải là một khóa phân tán, cơ sở dữ liệu giao dịch, hoặc bộ lập lịch đa công nhân an toàn. Trong sản xuất, lưu trữ ý định và danh tính phiên trong một hồ sơ công việc bền vững, cấp cho một người điều khiển quyền cho phép thay đổi trình duyệt, và chạy hòa giải cho các công việc chưa hoàn thành sau các sự cố.
Đừng ghi lại các khóa API, mã thông báo tự động, URL CDP đầy đủ hoặc URL Live đã ký. Hướng dẫn OWASP về việc ghi nhật ký hỗ trợ việc giữ bí mật ra khỏi các bản ghi. Hạn chế hồ sơ công việc và chẩn đoán cho các nhà điều hành được ủy quyền; hướng dẫn công cụ tự động hóa trình duyệt là hữu ích khi so sánh những trách nhiệm mà một hệ thống hoặc môi trường chạy được quản lý thực sự sở hữu.
Một Công Việc Trình Duyệt Hoàn Thành Nên Chứng Minh Gì?
Một công việc trình duyệt hoàn thành nên chứng minh rằng đầu ra dự kiến của nó đã được chấp nhận và phiên trình duyệt thuộc về nó đã kết thúc. Lưu trữ những kết quả đó riêng biệt, cùng với ID phiên và trạng thái dọn dẹp chưa giải quyết khi cần thiết. Kết nối lại chỉ với một tài nguyên đang chạy đã được xác nhận, hòa giải việc tạo không chắc chắn trước khi tạo lại, và để một người điều hành nhìn thấy công việc chưa hoàn thành. Đó là cơ sở thực tiễn cho việc quản lý phiên trình duyệt từ xa.
Q: H: ready có nghĩa là nhiệm vụ của tôi đã hoàn thành?
Không. ready có nghĩa là trình duyệt có thể chấp nhận một kết nối. Ứng dụng của bạn phải xác minh riêng trang và kết quả nhiệm vụ.
Q: H: Tôi có thể kết nối lại sau khi phiên kết thúc không?
Không. Một phiên đã kết thúc không thể được phục hồi bằng cách yêu cầu một mã thông báo CDP khác. Tạo một tác vụ được ủy quyền mới và chỉ khôi phục trạng thái ứng dụng được hỗ trợ rõ ràng.
Q: H: Có nên tạo lại một ID yêu cầu mới không?
Không. Hãy thử lại cùng một lần tạo không chắc chắn với ID ban đầu của nó và thân xác định. Cấu hình đã thay đổi hoặc một tác vụ mới có chủ ý yêu cầu một ID mới.
Q: H: Đăng nhập vào website có giống với phiên trình duyệt không?
Không. Một website kiểm soát thời gian sống xác thực của nó một cách độc lập với trình duyệt được quản lý. Kiểm tra trạng thái đăng nhập sau khi kết nối lại; đừng suy đoán nó từ ready.
Q: H: Thời gian phiên có thay thế việc dọn dẹp không?
Không. Thời gian phiên là một giới hạn tự động. Dừng phiên của bạn sau tác vụ và xác nhận ended để tránh thời gian chạy hoạt động không cần thiết.
Q: H: Tệp công việc cục bộ có đủ cho một dịch vụ phân tán không?
Không. Một dịch vụ phân tán cần các bản ghi bền vững, kiểm soát đồng thời, và một quy trình đối chiếu. Tệp cục bộ thể hiện ý định được bảo tồn mà không tuyên bố những đảm bảo sản xuất đó.
Hãy để một người điều hành đăng nhập qua Live View trước khi một kịch bản xác minh cùng một tab ứng dụng. Định nghĩa quyền sở hữu, xác nhận tài khoản, ranh giới phê duyệt và dọn dẹp mà không nhúng mật khẩu vào quá trình tự động hóa.
Ivy Lin
Nov. 17th 2026
Khởi chạy trình duyệt đám mây theo nhu cầu
Xử lý dấu vân tay trình duyệt và CAPTCHA
Tự động hóa quy trình và hỗ trợ tác nhân AI
Từ thu thập dữ liệu web và kiểm thử đến tự động hóa bằng AI, vận hành tất cả trên đám mây.