Cách khôi phục một công việc trình duyệt sau khi bị ngắt kết nối
TL;DR
Kết nối lại với ID trình duyệt ban đầu khi một worker mất kết nối và nhà cung cấp vẫn báo cáo phiên gốc là ready.
Phát hành thông tin xác thực ngắn hạn cho phiên đó, xác nhận danh tính của nó và giữ lại khóa API kinh doanh khỏi kết nối trình duyệt.
Chọn tab gốc theo URL đã phê duyệt và một điểm kiểm tra cụ thể cho công việc. Đối xử với một tab bị thiếu hoặc không rõ ràng như một quyết định để hòa giải.
Đọc biên nhận kinh doanh bền vững trước khi thử lại một hành động mà phản hồi của nó đã bị mất.
Một phiên trình duyệt ended yêu cầu một phiên mới nếu công việc có thể tiếp tục an toàn. Việc xây dựng lại một trình duyệt không thể thiết lập những gì đã xảy ra trong ứng dụng.
Kiểm tra việc chấp nhận nhiệm vụ và tắt phiên một cách độc lập. Một WebSocket mới và một trình duyệt ngừng hoạt động chứng minh các điều khác nhau.
Khi nào bạn có thể kết nối lại với một trình duyệt từ xa?
Bạn có thể kết nối lại với một trình duyệt từ xa khi runtime ban đầu vẫn còn và bạn có thể lấy được thông tin xác thực kết nối hiện tại cho cùng một phiên. Một sự ngắt kết nối mạng cho bạn biết worker đã quan sát điều gì. Trình duyệt có thể vẫn mở các trang của nó, và ứng dụng mục tiêu có thể đã chấp nhận hành động cuối cùng. Nstdata tài liệu một quy trình đính kèm cho các phiên Cloud Browser hiện có như một phần của dịch vụ tự động hóa trình duyệt của nó.
Giả sử một người xem xét phát hành đã đến một báo cáo staging và worker ngắt kết nối ngay sau khi nhấp vào một điều khiển phê duyệt. Nền tảng trình duyệt có thể báo cáo liệu phiên có tồn tại hay không. Báo cáo có thể chỉ ra bản sửa đổi nào đang hiển thị trên màn hình. Hồ sơ ứng dụng có thẩm quyền xác định liệu sự phê duyệt đã được cam kết. Đó là ba bằng chứng khác biệt. Worker nên khôi phục quan sát trước khi quyết định hành động.
Hướng dẫn chu trình sống của phiên trình duyệt đề cập đến việc tạo và kết thúc các phiên. Việc phục hồi bắt đầu sau đó, với một công việc hiện có và một ID phiên được giữ lại. Hướng dẫn đề cập đến trường hợp khác mà phản hồi tạo có thể đã bị mất và worker không bao giờ biết phiên nào đã được cấp phát.
Trạng thái nào một worker nên bảo tồn trước bất kỳ sự ngắt kết nối nào?
Lưu trữ danh tính công việc và phiên, ranh giới trang mong đợi, và điểm kiểm tra ứng dụng trước khi vào một bước có thể thay đổi trạng thái kinh doanh. Một bản ghi nhỏ có thể chứa ID công việc, nhãn không gian làm việc, ID phiên trình duyệt, nguồn gốc đã phê duyệt, lộ trình mong đợi, giá trị điểm kiểm tra an toàn, và tham chiếu hoạt động ứng dụng. Giữ chính sách truy cập của nó tách biệt khỏi thông tin xác thực trình duyệt.
Những gì bạn khôi phục
Bằng chứng để bảo tồn
Quyết định sau khi kết nối lại
Quyền sở hữu trình duyệt
ID phiên, chủ công việc, không gian làm việc dự định
Kiểm tra phiên gốc
Danh tính trang
Nguồn gốc đã phê duyệt, đường dẫn dự kiến, đánh dấu cụ thể cho nhiệm vụ
Tiếp tục quan sát chỉ khi trang là duy nhất
Tiến trình kinh doanh
Điểm kiểm tra và hoạt động đã cam kết cuối cùng
Đọc kết quả bền vững trước bất kỳ hành động mới nào
Trách nhiệm dọn dẹp
Một chủ sở hữu đã dừng lại và một hạn chót phát hành
Giữ hòa giải hoạt động cho đến khi tắt được xác nhận
Tránh lưu trữ địa chỉ WebSocket đã ký hoặc mã thông báo truy cập trong bản ghi công việc. Lưu trữ định danh được sử dụng để yêu cầu thông tin xác thực mới thông qua giao diện được hỗ trợ. Cách tiếp cận đó cung cấp cho một worker thay thế một điểm khởi đầu bền vững mà không làm lộ một kết nối có thể tái sử dụng trong hàng đợi, vé, hoặc theo dõi. Xem hướng dẫn vòng đời bí mật OWASP.
Làm thế nào bạn phục hồi phiên gốc và định vị tab của nó?
Kiểm tra phiên hiện có, thiết lập một kết nối CDP có giới hạn, và xác minh chính xác trang và điểm kiểm tra trước khi thực hiện hành động khác. Quy trình làm việc giả định có quyền truy cập vào không gian làm việc gốc, ID phiên đã ghi, và một cái nhìn an toàn về ứng dụng mục tiêu. Ví dụ địa phương sử dụng Node.js 22, playwright-core@1.65.1, và fixture đi kèm. Cài đặt Chromium với npx playwright-core install chromium cho nhánh địa phương.
Bước 1. Đọc bản ghi phiên
Mở Cloud Browser → Session History trong không gian làm việc đã dự kiến và tìm phiên gốc. Trong mã, kiểm tra GET /sessions/{sessionId} dưới API Cloud Browser đã được tài liệu hóa. Đối xử với ready như là quyền được tiến hành phát hành thông tin xác thực, tùy thuộc vào sự ủy quyền. Nếu một sự dừng đã diễn ra, quan sát cho đến khi nền tảng ổn định. Nếu phiên đã ended, sử dụng một điểm kiểm tra ứng dụng để quyết định liệu một phiên mới có thể tiếp tục an toàn không. Tài liệu tự động hóa Trình duyệt Cloud Browser.
[Ảnh chụp màn hình: Hiển thị một phiên thử nghiệm trong Lịch sử phiên, trạng thái của nó, và tham chiếu công việc phù hợp. Che giấu các định danh tài khoản và phiên.]
Bước 2. Obtaining current connection credentials
Để bắt đầu một phiên sẵn sàng, hãy yêu cầu POST /sessions/{sessionId}/automation-credentials với thông tin xác thực API của doanh nghiệp và ngữ cảnh không gian làm việc chính xác. Xác minh ID phiên trả về và thời gian hết hạn. Cung cấp địa chỉ CDP được trả về và tiêu đề cho khách hàng bằng cách sử dụng cách xây dựng tiêu đề được tài liệu hóa. Không bao giờ đăng nhập địa chỉ đã ký đầy đủ hoặc tiêu đề xác thực. Sử dụng tài liệu Playwright BrowserType cho các tùy chọn connectOverCDP() và giới hạn giao thức.
Bước 3. Tìm tab gốc mà không tạo ra một tab mới
Chạy node recover.mjs với LOCAL_CDP_URL vòng lặp lại và một APP_ORIGIN phục vụ tiện ích đi kèm. Bắt đầu node fixture.mjs và mở đường dẫn /recover của nó một lần trong trình duyệt thử nghiệm. Khách hàng đính kèm tìm kiếm các ngữ cảnh hiện có để tìm một sự khớp chính xác duy nhất, sau đó đọc dấu hiệu tiện ích mong đợi. Trình xác minh đi kèm cung cấp một hồ sơ Chromium tạm thời, kiểm tra rằng trang gốc vẫn còn sau khi khách hàng ngắt kết nối, và xác minh rằng hai tab khớp gây ra từ chối. Nhánh được quản lý yêu cầu một khóa Nstdata đã được ủy quyền và một phiên sẵn sàng hiện có với một điểm kiểm tra ứng dụng được phê duyệt tương đương. Sử dụng một điểm kiểm tra staging có thể tiếp cận trong môi trường được ủy quyền của trình duyệt được quản lý.
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);}
Kết quả của thiết lập dự kiến chỉ chứa nhãn công việc an toàn, điểm kiểm tra quan sát được và quyết định tiếp theo. Kết quả được cố ý để reconcile, vì việc nhìn thấy một trang được đánh dấu là đã xem không thể chứng minh rằng một hoạt động ghi sau đó đã hoàn tất. Khi một quy trình làm việc thực sự điều hướng hoặc mở một tab mới, hãy xác định các tuyến đường và dấu hiệu đã được phê duyệt cho mỗi chuyển đổi. Hướng dẫn Playwright về các trang và tab giải thích mối quan hệ giữa các trang và bối cảnh trình duyệt.
Bước 4. Kiểm tra ứng dụng trước khi phát lại một hoạt động ghi
Tìm kiếm biên nhận kinh doanh hoặc trạng thái bằng cách sử dụng một phương thức ứng dụng chỉ đọc. Nếu kết quả đã tồn tại cho hoạt động gốc, hãy đánh dấu nhiệm vụ được chấp nhận từ bằng chứng đó và lên lịch dọn dẹp. Nếu kết quả vắng mặt, hãy xác nhận yêu cầu ban đầu đã được giải quyết trước khi quyết định lặp lại nó. Ở nơi ứng dụng mục tiêu hỗ trợ một khóa idempotency, hãy giữ tham chiếu hoạt động gốc và tuân theo quy tắc của ứng dụng đó. Một kết quả không rõ ràng sẽ đi đến người điều hành hoặc hàng đợi giải quyết với một thời hạn nhất định.
Điều gì sẽ xảy ra nếu một bước khôi phục thất bại?
Một bước khôi phục thất bại nên giữ nguyên trạng thái hiện tại và báo cáo lớp nào đã ngăn cản việc xác minh. Một tìm kiếm phiên mà thất bại không thể xác định liệu trình duyệt còn tồn tại hay không. Một WebSocket thành công mà không có trang tương ứng là một sự thành công của việc đính kèm và một sự thất bại trong việc chọn trang. Những trạng thái này yêu cầu các hành động tiếp theo khác nhau.
Triệu chứng
Nguyên nhân khả dĩ cần kiểm tra
Hành động tiếp theo
Phiên gốc là cuối cùng
Hết thời gian, dừng lại một cách rõ ràng, hoặc kết quả vòng đời nhà cung cấp
Đọc điểm kiểm tra bền trước khi phân bổ một sự thay thế
Kết nối bị từ chối
Sai không gian làm việc, thông tin xác thực đã hết hạn, hoặc cấu trúc tiêu đề sai
Kiểm tra trạng thái gốc và phát hành thông tin xác thực hiện tại khi cấu hình được sửa chữa
Hai trang trùng khớp với URL
Tab trùng lặp hoặc quyền sở hữu song song
Dừng tự động hóa và yêu cầu một dấu hiệu nhiệm vụ mạnh mẽ hơn hoặc lựa chọn tab rõ ràng
Trang hiển thị một màn hình đã hoàn thành mà không có biên nhận
Trạng thái chưa hoàn chỉnh hoặc giao diện người dùng cũ
Xác minh hồ sơ hoạt động bên ứng dụng
Dọn dẹp vẫn đang chờ xử lý
Kết quả dừng chưa được xác nhận
Giữ phiên được theo dõi và kiểm tra trạng thái cuối cùng của nó
Nếu một công nhân mới có thể bắt đầu trong khi một công nhân cũ vẫn đang kết nối, hãy sử dụng một hợp đồng ứng dụng hoặc kiểm tra quyền sở hữu trước khi phát hành bất kỳ hoạt động ghi nào. Giải phóng khả năng trình duyệt chỉ sau khi dọn dẹp đã được xác nhận theo vòng đời của nhà cung cấp. Hướng dẫn xác thực CDP giúp cô lập một sự cố cấu hình trước khi công nhân chạm vào trang.
Nstdata Cloud Browser phù hợp với một cuốn sách hướng dẫn hồi phục như thế nào?
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 tác nhân AI, với trạng thái phiên và đính kèm CDP đã được tài liệu hóa. Một đội có thể sử dụng cùng một dịch vụ cho việc thực hiện nhiệm vụ thường xuyên và hồi phục được giám sát trong khi vẫn duy trì các điểm kiểm tra ứng dụng của riêng mình. Sử dụng đính kèm phiên hiện có khi không gian làm việc vẫn sở hữu một runtime sẵn sàng. Live View có thể giúp một người điều hành được ủy quyền xác thực một trang mà tự động hóa không thể xác định một cách độc đáo. Thông tin phiên của dịch vụ không thể xác định liệu phê duyệt chuẩn bị hoặc hành động ứng dụng khác đã được thực hiện hay chưa.
Tìm kiếm phiên. Sử dụng ID trước đó để kiểm tra trạng thái vòng đời và tránh phân bổ một sự thay thế khi có lỗi vận chuyển.
Đính kèm ngắn hạn. Yêu cầu thông tin xác thực hiện tại cho phiên, giữ chúng bên trong công nhân và chỉ lưu giữ tham chiếu hoạt động an toàn.
Bằng chứng của người điều hành. Sử dụng các quan sát có sẵn để hiểu trang nào đã hoạt động hoặc bị kẹt. Giữ ảnh chụp màn hình nhạy cảm, URL và nhật ký ra khỏi vé thường xuyên.
Dọn dẹp rõ ràng. Giao nhiệm vụ cho người điều khiển sẽ dừng trình duyệt được quản lý. Đóng đính kèm và kết thúc phiên quản lý là các hoạt động riêng biệt.
Một cuộc tập luyện phục hồi nên chứng minh điều gì?
Một cuộc tập luyện phục hồi nên chứng minh rằng một công nhân thay thế có thể tìm thấy trang đúng, nhận diện trạng thái kinh doanh không chắc chắn, và dừng phiên gốc dưới quyền sở hữu đã biết. Bắt đầu với một báo cáo phân phối được ủy quyền, ngắt kết nối công nhân trước một điểm kiểm tra chỉ đọc, và xác minh rằng sự thay thế đọc cùng một dấu hiệu nhiệm vụ. Lặp lại với một tab cạnh tranh và một điểm kiểm tra không thể giải quyết được kết quả kinh doanh. Cuộc chạy đầu tiên nên tiếp tục quan sát, trong khi các cuộc chạy khác nên dừng lại hoặc leo thang với một lý do hành động khả thi.
Ghi lại thời gian đã trôi qua từ khi ngắt kết nối đến khi có quyết định xác thực và đếm số trường hợp cần có sự can thiệp của con người. Theo dõi thành công công việc và dọn dẹp trình duyệt một cách riêng biệt. Khi một lỗi cần xem xét pháp lý, hãy xem xét ghi lại và phát lại phiên cho các trường hợp thử nghiệm tổng hợp với thời gian lưu trữ đã được phê duyệt.
Q: Việc ngắt WebSocket có nghĩa là trình duyệt gốc đã ngừng hoạt động?
Trạng thái trình duyệt được xác định bởi bản ghi phiên của nhà cung cấp. Truy vấn ID gốc trước khi kết nối lại hoặc thay thế trình duyệt.
Q: Có thể mở lại một phiên Cloud Browser đã kết thúc không?
Xem phiên đã kết thúc như là phiên cuối cùng. Sử dụng trạng thái ứng dụng liên tục để chọn bước tiếp theo an toàn trong một phiên mới.
Q: Người phục hồi có nên tạo một trang mới không?
Chọn trang hiện có khi bạn cần trạng thái của nó. Mở một trang mới chỉ cho một quy trình công việc cho phép rõ ràng việc tái tạo ngữ cảnh.
Q: Một địa chỉ CDP cũ có thể được sử dụng lại sau khi ngắt kết nối không?
Yêu cầu thông tin xác thực hiện tại cho phiên gốc đã sẵn sàng và kiểm tra thời gian hết hạn đã được tài liệu hóa. Chỉ lưu một tham chiếu phiên an toàn cho việc phục hồi tiếp theo.
Q: Người vận hành nên thấy gì trong một sự leo thang?
Cung cấp ID công việc, giai đoạn an toàn, trạng thái trình duyệt, chứng cứ kết quả, và chủ sở hữu dọn dẹp. Chia sẻ tài sản được bảo vệ thông qua kênh sự cố đã được phê duyệt.
Marcus Chen
Nov. 20th 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.