Nvirya AdGuard v11.7.0
Ctrl K

Hướng dẫn khắc phục sự cố

Hướng dẫn này trình bày cách xử lý các sự cố phổ biến khi duyệt web cùng Nvirya AdGuard v11.7.0 theo từng bước an toàn bằng các nút điều khiển có sẵn trong giao diện.

A. Lớp phủ tối vẫn còn trên màn hình sau khi quảng cáo đã bị xóa#

1. Triệu chứng#

  • Hộp quảng cáo hoặc cửa sổ bật lên đã biến mất, nhưng toàn bộ trang web phía sau vẫn bị làm mờ bởi một lớp màn màu đen hoặc xám bán trong suốt.
  • Bạn không thể cuộn trang lên xuống, hoặc chạm vào các liên kết trên trang nhưng không có phản hồi.

2. Nguyên nhân có thể#

Nhiều trang web tạo hộp thoại quảng cáo bằng hai phần tử tách biệt:

  1. Khung chứa nội dung quảng cáo ở phía trước (<div> hoặc <iframe>), và
  2. Một lớp nền tối toàn màn hình độc lập (thường dùng position: fixed, z-index cao hoặc backdrop-filter: blur(...)) kết hợp với thuộc tính khóa cuộn overflow: hidden hoặc position: fixed trên thẻ <html> hoặc <body>.

Mặc dù Nvirya AdGuard tự động tìm xóa các lớp nền đi kèm (adjacentBackdropNodes) và lên lịch mở khóa cuộn trang (scheduleUnlockPageScroll tại 0 ms, 120 ms, 420 ms và 900 ms), một số trang web chèn lớp nền bất đồng bộ hoặc dùng cấu trúc bọc riêng khiến lớp nền không bị xóa cùng lúc với quảng cáo.

3. Các bước khắc phục khuyến nghị#

  1. Mở bảng điều khiển Nvirya AdGuard bằng cách chạm vào Nút thao tác nhanh hoặc nhấn Alt+A.
  2. Trong tab Tổng quan dưới mục Thao tác nhanh, chạm vào Mở khóa cuộn trang ("Khôi phục cuộn trang bị lớp phủ ẩn khóa"). Thao tác này áp dụng overflow: auto !important và đặt lại position: fixed trên <html> và <body>.
  3. Chạm vào Dọn khung trống ("Thu gọn ngay các khung quảng cáo còn sót"), giúp ẩn các khung quảng cáo Google còn sót và quét lại các lớp phủ anti-adblock (handleAntiAdblock).
  4. Nếu vẫn còn một lớp màn tối che khuất thao tác chạm, hãy chọn Ẩn phần tử trên trang trong Thao tác nhanh, chạm vào lớp phủ tối đó rồi nhấn Ẩn phần tử.

Cảnh báo: Khi dùng Ẩn phần tử trên trang, hãy quan sát khung viền màu xanh và thanh trượt Cấp (Cấp 1/...) trước khi xác nhận. Không ẩn các vùng chứa cấp cao của trang (như <main>, <article>, hoặc #app) nếu khung màu xanh bao phủ toàn bộ nội dung bài viết—nếu bạn lỡ tay ẩn mất nội dung trang, hãy nhấn ngay Ctrl+Z (hoặc chọn Hoàn tác (Ctrl+Z) trong Thao tác nhanh) để khôi phục.

4. Nếu sự cố vẫn tiếp diễn#

  1. Mở bảng điều khiển (Alt+A) và chạm vào Xem trang gốc (3 giây) để kiểm tra xem liệu quy tắc lọc có vô tình ẩn mất một hộp thoại yêu cầu người dùng xác nhận (như thông báo vùng miền hoặc xác nhận độ tuổi) hay không.
  2. Chọn Tạm dừng phiên này trong Thao tác nhanh và tải lại trang để hoàn tất thao tác với hộp thoại đó, sau đó chọn Tiếp tục bảo vệ phiên này.

5. Khi gửi báo cáo sự cố#

Mở Giới thiệu → Cộng đồng & hỗ trợ → Góp ý, chọn phân loại Lỗi bố cục trang, và ghi chú ngắn gọn xem nút Mở khóa cuộn trang hay Dọn khung trống có xử lý được lớp phủ đó hay không.

B. Xác minh Cloudflare hoặc CAPTCHA không thể hoàn tất#

1. Triệu chứng#

  • Trang kiểm tra bảo mật (như Cloudflare "Just a moment...", Cloudflare Turnstile, hCaptcha, reCAPTCHA hoặc DDoS-Guard) xoay vòng liên tục, tự tải lại lặp đi lặp lại hoặc không hiển thị ô đánh dấu xác minh.

2. Nguyên nhân có thể#

Các hệ thống xác minh bảo mật và chống bot dựa vào kiểm tra toàn vẹn trình duyệt nghiêm ngặt, script thử thách, cookie, thẻ meta refresh cùng nguồn và các tiện ích Shadow DOM đóng.

Nvirya AdGuard v11.7.0 tích hợp cơ chế miễn trừ đa tín hiệu (evaluateSecurityChallengeState, isSecurityChallengeRequest và isProtectedSecurityElement) để tự động bỏ qua quét biến đổi DOM, chặn script, xóa meta-refresh và can thiệp mạng đối với:

  • Thử thách Cloudflare (challenges.cloudflare.com, /cdn-cgi/challenge-platform/, __cf_chl_*, .cf-turnstile)
  • hCaptcha (hcaptcha.com, .h-captcha, [data-hcaptcha-widget-id])
  • Google reCAPTCHA (google.com/recaptcha, recaptcha.net, .g-recaptcha)
  • DDoS-Guard (ddos-guard, #ddg-captcha)

Tuy nhiên, quá trình xác minh vẫn có thể thất bại nếu trang web nhúng khung thử thách tùy biến, nếu việc bọc các prototype JavaScript (window.fetch hoặc Function) kích hoạt kiểm tra toàn vẹn khắt khe, hoặc nếu VPN/proxy/DNS bên ngoài chặn tài nguyên của nhà cung cấp CAPTCHA.

Quan trọng: Nvirya AdGuard là công cụ lọc quảng cáo và bảo vệ điều hướng, không phải công cụ vượt tường lửa CAPTCHA hay DDoS. Script không thể tự giải hoặc bỏ qua bước kiểm tra bảo mật thay bạn.

3. Các bước khắc phục khuyến nghị#

Thực hiện lần lượt theo đúng thứ tự sau:

  1. Tải lại trang một lần. Các mã phiên thử thách bị hết hạn tạm thời thường tự khắc phục sau một lần làm mới trang.
  2. Đảm bảo Nvirya AdGuard đã ở phiên bản mới nhất. Mở tab Giới thiệu và chọn Dữ liệu & cập nhật → Kiểm tra cập nhật để chắc chắn bạn đang dùng v11.7.0 trở lên.
  3. Tạm dừng script cho phiên hiện tại hoặc cho phép trang web. Mở tab Tổng quan và chạm vào Tạm dừng phiên này (hoặc Cho phép trang này).
  4. Thử xác minh lại. Tải lại trang và hoàn thành bước xác minh Cloudflare hoặc CAPTCHA. Sau khi vượt qua bước kiểm tra và cookie phiên đã được lưu, bạn có thể bật lại bảo vệ nếu đã dùng tính năng tạm dừng phiên.
  5. Báo cáo sự cố nếu lỗi vẫn lặp lại khi bật Nvirya AdGuard (nhưng hoạt động bình thường ngay khi tạm dừng).

4. Nếu sự cố vẫn tiếp diễn#

Nếu quá trình xác minh vẫn thất bại ngay cả sau khi đã tạm dừng Nvirya AdGuard và tải lại trang, nguyên nhân nằm ở bên ngoài userscript. Các nguyên nhân phổ biến bao gồm chế độ chống vân tay trình duyệt (fingerprinting protection), chặn cookie bên thứ ba, địa chỉ IP của máy chủ VPN/proxy bị hạn chế, hoặc quy tắc DNS tùy chỉnh chặn tên miền xác minh. Không tắt các tính năng bảo mật cốt lõi của trình duyệt; hãy thử đổi máy chủ VPN hoặc mở trang trong tab trình duyệt tiêu chuẩn.

5. Khi gửi báo cáo sự cố#

Chọn Lỗi bố cục trang hoặc Khác trong mục Gửi phản hồi, nêu rõ nhà cung cấp xác minh nào xuất hiện (Cloudflare, Turnstile, hCaptcha, reCAPTCHA hay DDoS-Guard) và cho biết việc tạm dừng Nvirya AdGuard có giúp vượt qua bước kiểm tra hay không.

C. Liên kết tải xuống hợp lệ không mở được#

1. Triệu chứng#

  • Bạn nhấp vào nút tải xuống hoặc liên kết dự phòng (mirror) nhưng không có gì xảy ra, hoặc xuất hiện hộp thoại Xác nhận liên kết ngoài hỏi bạn có muốn tiếp tục hay không.
  • Khi nhấn Tiếp tục, một thông báo nhanh xuất hiện (Trình duyệt đã chặn cửa sổ bật lên — đang mở trực tiếp) và tệp được mở ngay trong tab hiện tại thay vì tab mới.

2. Nguyên nhân có thể#

Các cổng tải tệp thường gắn script quảng cáo vào nút tải hoặc dẫn liên kết tải hợp lệ đi qua các bộ bọc chuyển hướng chéo tên miền. Trong v11.7.0, installRedirectGuard() và classifyUserAnchorNavigation() xử lý thao tác nhấp chuột như sau:

  • Cho phép trực tiếp các dịch vụ lưu trữ tệp uy tín: Liên kết tới các kho mã nguồn và dịch vụ đám mây phổ biến (github.com, gitlab.com, sourceforge.net, mega.nz, mediafire.com, drive.google.com, dropbox.com, onedrive.live.com, box.com, fshare.vn, pixeldrain.com, gofile.io, apkmirror.com, archive.org, v.v.) được mở ngay mà không bị gián đoạn trừ khi trùng với tên miền quảng cáo.
  • Bóc tách liên kết chuyển hướng (extractUnwrappedRedirectUrl): Nếu liên kết chứa tham số chuyển hướng (?url=, ?to=, ?target=, ?dest=, ?redirect=, bao gồm cả đích http/https mã hóa Base64), script sẽ trích xuất URL đích thực sự.
  • Hộp thoại Xác nhận liên kết ngoài (openRedirectConfirmModal): Khi bạn nhấp vào liên kết khác tên miền chưa được tin cậy mở trong tab mới (target="_blank"), đi qua bước chuyển hướng/theo dõi, hoặc trỏ tới máy chủ tải tệp lạ, Nvirya AdGuard sẽ tạm dừng điều hướng và hiển thị hộp thoại Xác nhận liên kết ngoài:
    • Thông điệp: "Trang web muốn mở liên kết ngoài:"
    • Nhãn tên miền đích: Hiển thị rõ hostname đích (ví dụ: files.example.org).
    • Câu hỏi: "Bạn có muốn tiếp tục?"
    • Nút bấm: Hủy và Tiếp tục.

3. Các bước khắc phục khuyến nghị#

  1. Kiểm tra tên miền trong hộp thoại Xác nhận liên kết ngoài:
    • Nếu tên miền hiển thị đúng là trang lưu trữ tệp hoặc trang web bạn muốn mở, hãy nhấn Tiếp tục. Script sẽ thêm tên miền đó vào danh sách cho phép tạm thời của phiên tab hiện tại (state.tempAllowPopupHosts), xóa window.opener (win.opener = null) để chống đánh cắp tab ngược (reverse tabnabbing) và mở liên kết (hoặc điều hướng trực tiếp trong tab hiện tại nếu trình duyệt chặn cửa sổ bật lên).
    • Nếu tên miền hiển thị hoàn toàn xa lạ hoặc đáng ngờ, hãy nhấn Hủy để ở lại trang hiện tại.
  2. Nếu không có hộp thoại xác nhận nào hiện ra và nút bấm không phản hồi:
    • Một số trang yêu cầu chạy sự kiện nhấp chuột đầu tiên trước khi mở khóa nút tải thực sự. Hãy đợi 1–2 giây rồi chạm lại lần thứ hai (triggerAdInterceptedAction tự động thử nhấp lại các nút tải/tiếp tục tiêu chuẩn sau 60 ms khi chặn pop-up quảng cáo, nhưng nút tùy biến có thể cần chạm lại).
    • Chạm vào Xem trang gốc (3 giây) trong Tổng quan → Thao tác nhanh để kiểm tra xem liên kết tải phụ hoặc bộ đếm ngược có bị quy tắc CSS ẩn mất hay không.

Lưu ý an toàn: Không tùy tiện thêm các trang chia sẻ tệp không rõ nguồn gốc vào danh sách cho phép hoặc mở tên miền lạ mà không kiểm tra kỹ hostname trong hộp thoại Xác nhận liên kết ngoài.

4. Nếu sự cố vẫn tiếp diễn#

Chạm vào Tạm dừng phiên này trong Tổng quan → Thao tác nhanh, tải lại trang và kiểm tra kỹ địa chỉ đích của nút tải trước khi tiếp tục.

5. Khi gửi báo cáo sự cố#

Sử dụng Gửi phản hồi với phân loại Lỗi bố cục trang hoặc Khác, và mô tả nút tải xuống nào trên trang không phản hồi.

D. Google Dịch hoặc Bing Translator bị chậm hoặc lỗi#

1. Triệu chứng#

  • Văn bản nhập vào Google Dịch (Google Translate) hoặc Bing Translator không được dịch, nút phát âm thanh không hoạt động, hoặc trang web dịch qua proxy *.translate.goog không tải đúng giao diện.

2. Nguyên nhân có thể#

Các ứng dụng dịch thuật thực hiện rất nhiều yêu cầu fetch và XMLHttpRequest ngầm, đồng thời liên tục cập nhật thuộc tính DOM (jscontroller, jsaction, jsname) khi bạn gõ phím.

Nvirya AdGuard v11.7.0 đã tích hợp sẵn cơ chế miễn trừ tương thích chuyên biệt (isTranslatorHostOrUrl, isTranslatorWhitelistedRequest và isProtectedTranslatorElement) cho:

  • Google Dịch: translate.google.<tld> (bao gồm các tên miền khu vực như .com, .co.uk, .com.vn, .co.in), tên miền proxy *.translate.goog, translate.googleapis.com, translate-pa.googleapis.com và các khung tiện ích Google Dịch (.goog-te-banner-frame, .goog-te-gadget, .skiptranslate).
  • Bing & Microsoft Translator: bing.com/translator (bao gồm www.bing.com và cn.bing.com), các điểm cuối RPC (/ttranslatev3, /tfetspktok, /tlookupv3, /tspeakv3, /tspellcheckv3), api.cognitive.microsofttranslator.com, edge.microsoft.com/translate/ và vùng chứa #tta_input_ta / #tta_output_ta.

Nếu việc dịch vẫn bị chậm hoặc lỗi, nguyên nhân thường thuộc một trong ba nhóm sau:

  1. Phiên bản script cũ hoặc quy tắc chặn thủ công: Bạn đang dùng phiên bản cũ hoặc đã vô tình tạo quy tắc ẩn phần tử trong Quy tắc lọc của trang / chặn tên miền trong Nhật ký kết nối.
  2. Tính năng dịch tích hợp sẵn của trình duyệt: Trình dịch trang tích hợp sẵn trong Safari hoặc Chrome (chạy trực tiếp trong trình duyệt thay vì trên translate.google.com) gặp giới hạn tốc độ hoặc xung đột DOM.
  3. Bộ lọc DNS hoặc VPN bên ngoài: Công cụ chặn cấp mạng đang chặn translate.googleapis.com, play.google.com/log, gstatic.com hoặc bat.bing.com.

3. Các bước khắc phục khuyến nghị#

  1. Tải lại trang một lần.
  2. Mở Giới thiệu → Dữ liệu & cập nhật và chọn Kiểm tra cập nhật để đảm bảo bạn đang chạy v11.7.0 trở lên.
  3. Mở Tổng quan → Quy tắc lọc của trang và Nhật ký kết nối để kiểm tra xem có quy tắc thủ công nào đang chặn phần tử hoặc tên miền API của Google/Microsoft hay không.
  4. Nếu bạn đang dịch một trang web bên thứ ba qua liên kết proxy hoặc tiện ích nhúng mà vẫn gặp lỗi, hãy chạm vào Tạm dừng phiên này (hoặc Cho phép trang này nếu đó là tên miền dịch thuật đáng tin cậy bạn dùng thường xuyên).

Lưu ý: Mặc dù giao diện chính thức của translate.google.com và bing.com/translator được bảo vệ an toàn, các trang web bên thứ ba được xem thông qua proxy dịch thuật vẫn có thể chứa quảng cáo hoặc chuyển hướng độc hại. Hãy ưu tiên dùng Tạm dừng phiên này khi kiểm tra một trang web lạ được dịch thay vì tắt bảo vệ vĩnh viễn.

4. Nếu sự cố vẫn tiếp diễn#

Hãy thử kiểm tra xem dịch vụ dịch có hoạt động khi tạm dừng Nvirya AdGuard hay không. Nếu vẫn lỗi khi đã tạm dừng, hãy kiểm tra cài đặt VPN, bộ lọc DNS hoặc trình dịch tích hợp của trình duyệt.

5. Khi gửi báo cáo sự cố#

Gửi báo cáo qua Gửi phản hồi dưới mục Lỗi bố cục trang, ghi rõ bạn đang dùng translate.google.*, bing.com/translator, liên kết *.translate.goog hay thanh dịch tích hợp của trình duyệt.

E. Trang web trở nên chậm hoặc đơ#

1. Triệu chứng#

  • Cuộn trang bị khựng, gõ chữ vào ô tìm kiếm có độ trễ, hoặc tab trình duyệt bị đơ vài giây khi mở một trang web cụ thể.

2. Nguyên nhân có thể#

  • Trang web liên tục thay đổi hàng nghìn nút DOM mỗi giây, kích hoạt nhiều đợt quét liên tiếp.
  • Chế độ Lọc kết nối sâu (strictMode) đang được bật trong Cài đặt, khiến bộ lọc DOM đánh giá và ẩn cả các phần tử chỉ có 1 tín hiệu (signals >= 1).
  • Một script anti-adblock trên trang bị kẹt trong vòng lặp thử chèn lại quảng cáo liên tục.

3. Các bước khắc phục khuyến nghị#

Để kiểm tra xem Nvirya AdGuard có phải là nguyên nhân gây chậm trên trang đó hay không:

  1. Mở bảng điều khiển (Alt+A) và chọn Tạm dừng phiên này trong Tổng quan → Thao tác nhanh.
  2. Tải lại trang để trang web chạy hoàn toàn không có hook hay bộ quan sát DOM của userscript.
  3. So sánh độ mượt của trang giữa lúc tạm dừng và lúc bật:
    • Nếu trang vẫn chậm khi đã tạm dừng, nguyên nhân nằm ở bản thân trang web, thiết bị/trình duyệt hoặc một tiện ích khác.
    • Nếu trang mượt trở lại ngay khi tạm dừng, Nvirya AdGuard đang xảy ra xung đột hiệu năng với cấu trúc DOM hoặc script của trang đó.
  4. Nếu bạn đang bật Lọc kết nối sâu trong Cài đặt, hãy thử tắt công tắc này rồi tải lại trang với chế độ bảo vệ thông thường.

4. Nếu sự cố vẫn tiếp diễn#

Chạm vào Cho phép trang này trong Tổng quan → Thao tác nhanh để tạm ngừng lọc trên tên miền đó trong khi chờ bản cập nhật khắc phục.

5. Khi gửi báo cáo sự cố#

Bật lại bảo vệ trên trang gặp lỗi (hoặc sao chép nhật ký chẩn đoán trước khi thêm vào danh sách cho phép), mở Giới thiệu → Cộng đồng & hỗ trợ → Góp ý, chọn Khác (hoặc Lỗi bố cục trang) và mô tả thao tác nào gây đơ trang (ví dụ: "Trang bị khựng khi cuộn xuống phần bình luận"). Bạn không cần phải mở công cụ lập trình viên (DevTools) để đo đạc.

F. Quảng cáo vẫn hiển thị trên trang#

1. Triệu chứng#

  • Một biểu ngữ quảng cáo, bài viết tài trợ, hộp nổi hoặc quảng cáo video vẫn xuất hiện trên trang dù Nvirya AdGuard đang bật.

2. Nguyên nhân có thể#

  • Quảng cáo nội bộ (first-party) hoặc làm rối mã: Trang web tải quảng cáo từ chính tên miền của họ kèm các tên class ngẫu nhiên không khớp với bộ chọn có sẵn.
  • Tên miền mạng quảng cáo mới: Quảng cáo được tải từ tên miền mới đăng ký chưa có trong danh sách RE_AD_HOST hoặc RE_SUSPECT_TLD.
  • Ngưỡng an toàn chủ đích: Để tránh xóa nhầm bài viết, hình ảnh minh họa hoặc trình phát video hợp lệ, inspectNode() yêu cầu tối thiểu hai tín hiệu quảng cáo độc lập (signals >= 2) trước khi xóa vùng chứa chung khi tắt Lọc kết nối sâu, đồng thời bỏ qua phần tử nằm trong ngữ cảnh bài báo (isNewsThumbnailContext) hoặc chứa nhiều văn bản (>= 50 ký tự).

3. Các bước khắc phục khuyến nghị#

  1. Đối với biểu ngữ tĩnh hoặc hộp nổi: Mở Tổng quan → Thao tác nhanh và chạm vào Ẩn phần tử trên trang. Chạm vào quảng cáo, điều chỉnh thanh trượt Cấp (Mở rộng / Thu hẹp) sao cho khung viền xanh bao trọn khung quảng cáo mà không dính nội dung chính, rồi nhấn Ẩn phần tử (hoặc Ẩn tất cả nếu có nhiều khung giống hệt nhau).
  2. Đối với tên miền quảng cáo bên thứ ba: Mở Tổng quan → Thao tác nhanh → Nhật ký kết nối, tìm tên miền bên thứ ba lạ đang tải quảng cáo và nhấn Chặn.
  3. Đối với khung quảng cáo Google còn sót: Nhấn Dọn khung trống trong Thao tác nhanh.

4. Nếu sự cố vẫn tiếp diễn#

Một số loại quảng cáo—đặc biệt là quảng cáo video ghép từ máy chủ hoặc thẻ tài trợ nội bộ có cấu trúc HTML giống hệt bài viết thường—không thể ẩn bằng một bộ chọn CSS đơn giản mà không làm mất nội dung thật trên cùng trang.

5. Khi gửi báo cáo sự cố#

Mở Giới thiệu → Cộng đồng & hỗ trợ → Góp ý, chọn Quảng cáo bị sót, và ghi chú ngắn gọn vị trí quảng cáo xuất hiện trên màn hình (ví dụ: "Banner bám dính ở đáy màn hình khi đọc bài" hoặc "Nhấn nút phát video thì nhảy sang tab cá cược"). Báo cáo sẽ tự động đính kèm tên miền và URL đã làm sạch.