AdGuard Linux 版 – Release – AdGuard 版本

AdGuard Linux 版 1.3
更新日期:2026年2月26日
AdGuard CLI 持續拓展功能邊界,逐步向功能完備的桌面版應用看齊。v1.3 版本帶來更強大、更靈活的體驗,管理也更加便捷。
本次更新新增 DNS 過濾與 Encrypted Client Hello(ECH)支援,引入使用者腳本與使用者樣式管理功能,並優化了更新流程,使其更清晰、更一致。

新增 DNS 過濾支援

啟用 DNS 過濾後,包含廣告、跟蹤器和惡意網站在內的不受信任域名將在建立連線前即被攔截。這為裝置增加了一層額外防護,能在最早階段阻斷有害流量,使其無法觸及使用者的裝置。
請注意:DNS 過濾預設處於關閉狀態。
啟用命令如下:
adguard-cli config set dns_filtering.enabled true
關閉命令如下:
adguard-cli config set dns_filtering.enabled false
請注意:預設情況下,AdGuard CLI 使用系統 DNS 伺服器或「AdGuard 無過濾」DNS 伺服器。使用者可以透過以下命令手動選擇其他伺服器:
adguard-cli config set dns_filtering.upstream '[server address]'
如需恢復預設伺服器,請執行以下命令:
adguard-cli config set dns_filtering.upstream default

Encrypted Client Hello

儘管 HTTPS 能加密流量內容,但所訪問的伺服器名稱通常仍可見。ECH 能夠加密這一部分連線資訊,有效防止網路服務商、深度包檢測系統及其他中間方窺探使用者所訪問的域名。

新增使用者腳本與使用者樣式支援

現在使用者可以透過命令列直接安裝和管理使用者腳本使用者樣式。管理命令遵循與過濾器相同的邏輯,啟用、關閉或移除使用者腳本的方式與您熟悉的操作一致。

其他改進

我們還進行了若干細微修復,並統一了 adguard-cli filters updateadguard-cli check-update 命令的邏輯。兩者現在使用相同的更新檢測機制,並提供更詳細、易於理解的進度輸出。

更新記錄

改進

新增 DNS 過濾支援 #90
新增完整的使用者腳本/使用者樣式支援 #118
新增 Encrypted Client Hello (ECH) 支援 #111

CoreLibs(過濾引擎)

CoreLibs 更新至 v1.21.6

改進

預設啟用 Enabled HTTP/3 過濾 #2015

修復

在不支援 DNT/GPC 的瀏覽器上,“請勿追蹤”功能仍會同時傳送兩種訊號 #1982
啟用保護後,不再洩露 local.adguard.org 域名解析資訊 #1854
MWITools 在 AdGuard 中無法執行 #2001

Scriptlets(過濾規則的 JavaScript 改進)

Scriptlets 更新至 v2.2.15

改進

trusted-click-element — 新增對無法響應原生點選的 React 元素的支援 #542

修復

當事件型別為 null 時,prevent-addEventListener 腳本會丟擲錯誤 #539
AdGuard Linux 版 1.2.2
更新日期:2025年12月29日
廣告攔截封鎖功能出現了問題,但我們儘快盡一切努力,快速修復了使用者報告的一個惱人錯誤,並同時更新了我們的程式庫。
AdGuard Linux 版 1.2.1
更新日期:2025年12月22日
在這次更新中我們修復了程式錯誤,讓應用程式運行更穩定。
AdGuard Linux 版 1.2
更新日期:2025年12月8日
持續守護使用者的線上安全,是我們的核心使命。本次更新中,我們增強了對惡意與釣魚網站的防護能力,新增了對 CRLite 技術的支援,該技術能顯著加速並提升憑證驗證的效率和可靠性。同時,我們優化了 AdGuard Linux 版的請求處理機制,從而提升了穩定性,確保執行更流暢、更可靠。

更新記錄

改進

FLM 更新至 v2.3 #101

修復

配置時發生段錯誤 #97
代理伺服器無法啟動 #93

CoreLibs(過濾引擎)

CoreLibs 更新至 v1.20.53

改進

新增在 $urltransform 中解碼 URL 的選項 #1915
在 AdGuard 測試版/每夜版中預設啟用 HTTP/3 過濾 #2014
新增對 $reason 新修飾符的支援 #1986

修復

@connect 未按預期工作 #1985
HAR 檔案未完全編譯 #2002
啟用 AdGuard VPN 整合模式時,目標地址顯示為 127.0.0.1 #2021
HTTP/1.1 協議中 HTTP 10x 狀態碼處理錯誤 #2013
由於 BOM(位元組順序標記)導致使用者腳本無法新增到 AdGuard Android版 #2009
使用者腳本執行器錯誤新增了源對映 #1984
GM.xmlHttpRequestGM_xmlhttpRequest 實現有誤 #1983
在代理設定中啟用 FakeDNS 時, 修飾符過濾、腳本片段與隱藏模式失效 #2017
在 1.19 版本的手動代理模式下無法訪問本地主機 #2019
未將 CRLite 用作 OCSP 的替代方案 #1997
AdGuard Linux 版 1.1
更新日期:2025年10月6日
本次更新將我們的過濾引擎 CoreLibs 升級至 v1.19 版本,並將過濾器清單管理器(英文:Filter List Manager 簡稱:FLM)提升至 v2.0,至此您的所有過濾需求皆可得到悉心照料!
至於有哪些新變化,此版本主要是一次旨在提升整體穩定性的系統更新。此外,我們還修復了錯誤,並進行了多處細節最佳化,讓 Linux 上的廣告封鎖體驗更為可靠。

更新記錄

改進

新增更便捷的 outbound_proxy 配置方式
新增設定匯出與匯入功能
新增自定義資料目錄設定選項
新增對 cli 平臺過濾器的支援
FLM 更新至 v2.0
新增語言特定過濾器的自動啟用功能
新增可選的通知支援功能
新增 Linux 平臺的 UDP 過濾支援 #46

修復

當選擇不同更新通道時,使用測試版許可的 AdGuard CLI 無法正常更新
AdGuard 無法在 Arch Linux 中新增 CA 證書
錯誤頁面 Web page is not available 顯示為俄語而非系統語言
filter_ev_certificates 的預設值不正確
並行執行 Firefox 例項會觸發 HTTPS CA 證書警告
腳本小程式失效
Ubuntu 系統中缺少 /usr/local/bin/ 目錄
若過濾器元資料未更新,adguard-cli 會啟動失敗
證書建立與更新過程中出現錯誤
安裝程式不支援多瀏覽器配置檔案

CoreLibs(過濾引擎)

CoreLibs 更新至 v1.19

改進

新增對 ABP CSS 註入文法的支援 #1927
通過更有效地利用瀏覽器緩存,提升內容腳本性能 #1929
整體提升內容腳本的加載性能 #1930
新增移除空屬性內容的能力 #1934
$app 修飾符新增通配符和正則錶達式支援 #1906
移除了 $domain 修飾符中的復雜啟發式規則#1875
新增對 “zstd” 編碼的支援 #1976
新增對 ALPS 擴充套件的支援 #1987

修復

內容型別修飾符無法與 $urltransform修飾符同時使用 #1978
因可能影響網站效能而禁用過濾功能 [#1994](https://github.com/AdguardTeam/CoreLibs/issues/1994
部分基於 React 的網站因 Minified React error 而無法正確載入 #1953
部分擴充套件在更新至 CoreLibs v1.18 後停止工作 #1993
使用 immersivetranslate 使用者腳本時發生 XHR 超時 #2000
$removeparam$domain 修饰符配合使用时失效 #1999
$urltransform~3p 组合,且请求直接在地址栏中打开时,未能修改请求 URL #1931
AdGuard Linux 版 1.0
更新日期:2025年4月29日
本次更新將開啟全新篇章:AdGuard CLI 震撼登場,為 Linux 使用者帶來 AdGuard 一貫強大可靠的全方位保護!
多年來,Linux 使用者一直渴望擁有專屬的 AdGuard 版本,為此我們傾注心血,全力打造了這款功能強大的命令行工具。AdGuard CLI v1.0 為您提供全面的功能組合和靈活的防護方案,讓 Linux 系統取得完美保護。
若您體驗過 AdGuard CLI v1.0 Nightly 版,正式版將帶來更完善的性能與體驗升級。

應用例外

這一功能大幅提升了 AdGuard 在 Linux 上的易用性。如果您還不了解它,它允許使用者選擇性路由特定應用的流量,在不需要時跳過 AdGuard 的過濾。無論是故障排查,還是想保留某些服務的廣告,這個功能都能派上用場。
為了讓操作更簡便,我們准備了兩份預設清單(瀏覽器和應用)來免除 HTTPS 過濾,這樣設定排除項更快更省事。
該清單可在檔案 proxy.yaml (用於應用程式例外)和 browsers.yaml(用於瀏覽器例外)中編輯。您可以使用內置終端編輯器(或任何其他文本編輯器)編輯這些檔案,方法是輸入 nano [檔案路徑],然後重啟保護。要檢視檔案的位置,請檢視 config 命令的輸出。

差異化過濾器更新

本版本中,我們已將過濾器更新方式升級為差分更新機制。簡而言之,AdGuard CLI 現在只會下載自上次更新以來過濾器清單的變更內容,而不再需要取得完整清單。這不僅減少了更新流量消耗,還大幅提升了過濾器的更新速度。您將始終使用最新版本的過濾器,取得更精准的廣告封鎖效果。
已開始下載 AdGuard 點擊箭頭所指示的檔案開始安裝 AdGuard。 選擇"開啟"並點擊"確定",然後等待該檔案被下載。在被打開的視窗中,拖曳 AdGuard 圖像到"應用程式"檔案夾中。感謝您選擇 AdGuard! 選擇"開啟"並點擊"確定",然後等待該檔案被下載。在被打開的視窗中,點擊"安裝"。感謝您選擇 AdGuard!
在行動裝置上安裝 AdGuard