Tài liệu

Tùy chọn kho danh sách chặn kết nối

Thời gian đọc 2 phút Gói: Nalix.Network
Trên trang này

Không gian tên: Nalix.Network.Options
Assembly: Nalix.Network

ConnectionBlacklistStoreOptions cấu hình danh sách chặn IP và dải CIDR cố định (NetworkAccessList) được ConnectionGuard kiểm tra trước khi chấp nhận kết nối đến.

Ánh xạ mã nguồn

  • src/Nalix.Network/Options/ConnectionBlacklistStoreOptions.cs
  • src/Nalix.Network/Internal/Security/NetworkAccessList.cs
  • src/Nalix.Network/RateLimiting/Connection.Guard.cs

Giá trị mặc định và kiểm tra hợp lệ

Thuộc tínhKiểuMặc địnhKiểm tra hợp lệMô tả
EnabledbooltrueKhông cóBật hoặc tắt việc nạp và kiểm tra tệp danh sách chặn cố định IP/CIDR.
StoreFileNamestring"blacklist.txt"Không cóTên tệp văn bản nằm trong Directories.ConfigurationDirectory, chứa các địa chỉ IP hoặc dải CIDR bị chặn (mỗi dòng một mục).
MaxBlacklistedIpsint100_000[ValueRange(10, 1_000_000)]Số mục danh sách chặn tối đa được nạp vào bộ nhớ (10..1,000,000).

Validate() thực thi this.ValidateDataAnnotations() và ném ValidationException khi vi phạm ràng buộc.

Ví dụ cấu hình

Cấu hình bằng code

using Nalix.Hosting;
using Nalix.Network.Options;

INetworkApplicationBuilder builder = NetworkApplication.CreateBuilder();

builder.Configure<ConnectionBlacklistStoreOptions>(options =>
{
    options.Enabled = true;
    options.StoreFileName = "blacklist.txt";
    options.MaxBlacklistedIps = 200_000;
});

Cấu hình INI (default.ini)

[ConnectionBlacklistStore]
Enabled = true
StoreFileName = blacklist.txt
MaxBlacklistedIps = 100000

Định dạng tệp danh sách chặn (blacklist.txt)

Đặt blacklist.txt trong Directories.ConfigurationDirectory, mỗi dòng một địa chỉ IPv4/IPv6 hoặc dải subnet CIDR (các dòng bắt đầu bằng # sẽ bị bỏ qua):

# Block a single IPv4 address
192.0.2.44

# Block IPv4 and IPv6 CIDR subnets
198.51.100.0/24
2001:db8:dead::/48

API liên quan