vi.md

Dành cho các bạn Việt Nam

---

Các bạn cần phân biệt bộ lọc DNS và bộ lọc browser. Mình thấy nhiều bạn đem bộ lọc browser lên chạy -> lỗi lướt web

Hướng dẫn sử dụng

---

Thêm Variables Secrets vào https://github.com/your-user/your-repository/settings/secrets/actions:

• CF_IDENTIFIER được lấy từ tài khoản CF của bạn (dãy ký tự ngay sau https://dash.cloudflare.com/: https://dash.cloudflare.com/?to=/:account/workers

• CF_API_TOKEN lấy từ : https://dash.cloudflare.com/profile/api-tokens với 3 permissions

  1. Account.Zero Trust : Edit
  2. Account.Account Firewall Access Rules : Edit
  3. Account.Access: Apps and Policies : Edit

hoặc có thể thêm vào .env ( không khuyến khích )

Secret Github Action giống như sau:

Tạo CF_API_TOKEN giống như sau:

Cài thời gian script tự động chạy

---

Sử dụng Cloudflare Workers để chạy Github Action. Không lo sau 2 tháng Github tắt Action.Tạo Github Token không hết hạn với quyền truy cập workflow là đủ.

addEventListener('scheduled', event => {
  event.waitUntil(handleScheduledEvent());
});

async function handleScheduledEvent() {
  const GITHUB_TOKEN = 'YOUR_GITHUB_TOKEN_HERE';
  try {
    const dispatchResponse = await fetch('https://api.github.com/repos/YOUR_USER_NAME/YOUR_REPO_NAME/actions/workflows/main.yml/dispatches', {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${GITHUB_TOKEN}`,
        'Content-Type': 'application/json',
        'User-Agent': 'Mozilla/5.0',
      },
      body: JSON.stringify({
        ref: 'main'
      }),
    });

    if (!dispatchResponse.ok) throw new Error('Failed to dispatch workflow');
  } catch (error) {
    console.error('Error handling scheduled event:', error);
  }
}

Nhớ cài cron trigger cho Cloudflare Workers

Chú ý

---

• Giới hạn của Cloudflare Gateway Zero Trust free là 300k domains nên các bạn nhớ chú ý log, nếu quá script sẽ stop

• Các bạn đã tải các danh sách bộ lọc bằng script khác thì nên xoá đi bằng tính năng xoá của script đã up hoặc xoá tay

• Mình đã update thêm tính năng xoá danh sách khi các bạn không muốn sử dụng script nữa. Vào main.yml để như sau:

      - name: Cloudflare Gateway Zero Trust 
        run: python -m src leave

• Hỗ trợ dynamic_blacklist.txt và dynamic_whitelist.txt để các bạn tự chặn hoặc bỏ chặn tên miền theo ý thích

• Hỗ trợ thêm chặn và bỏ chặn trong Github Actions variables . Định dạng giống như dynamic_blacklist.txt và dynamic_whitelist.txt ở Value*. DYNAMIC_BLACKLIST và DYNAMIC_WHITELIST cho Name*

• Thêm danh sách chặn của bạn vào adlist.ini và loại bỏ chặn ở whitelist.ini

• Đã hỗ trợ 2 loại định dạng danh sách

https://adguardteam.github.io/AdGuardSDNSFilter/Filters/filter.txt

hoặc

[Ad-Urls]
Adguard = https://adguardteam.github.io/AdGuardSDNSFilter/Filters/filter.txt

• Bạn nên thêm danh sách tùy chỉnh vào Action variables như sau

Name:

ADLIST_URLS hoặc WHITELIST_URLS.

Value: danh sách các URLs

Ví dụ:

https://adguardteam.github.io/AdGuardSDNSFilter/Filters/filter.txt
https://raw.githubusercontent.com/hagezi/dns-blocklists/main/wildcard/light-onlydomains.txt

👌 Chúc các bạn thành công

👌 Mọi thắc mắc về script các bạn có thể mở issue