Все настройки работы BSB задаются в конфигурационном файле bsb.cfg. Файл содержит 2 секции: общие настройки - секция [Config] и список IP-адресов с индивидуальными настройками - секция [IP].

   Конфигурация должна быть задана правильно перед запуском программы BSB из программной строки или как службы. Если файл конфигурации содержит ошибки, то BSB не будет работать,  а информацию о том, что за ошибка - можно узнать в файле журнала bsb.log.

   Далее приводятся описания всех параметров файла bsb.cfg, однако, можно воспользоваться программой BSBConfig, и быстро настроить конфигурацию, не вдаваясь в подробности описаний параметров.

Общие настройки. Секция [Config].

   Для нормальной работы программы BSB в секции Config необходимо правильно задать следующие параметры (указаны возможные или рекомендуемые значения):

ListenPort=3128

Номер порта TCP, через который будет работать BSB в качестве прокси-сервера, ограничивая скорость, недельный входящий трафик и число одновременных соединений. Внимание! Если BSB и кэширующий прокси-сервер следующего для него уровня работают на одном и том же компьютере, то номера их рабочих портов должны различаться.

AdminPort=3131

Номер порта TCP, через который BSB будет принимать запросы от BSB Client Infomer пользователей о своей статистике. Этот порт не должен быть занят другими программами на компьютере, где работает BSB. На соединения, которые устанавливаются по этому порту, не накладывается никаких ограничений, и эти соединения не влияют на условия применения ограничений по скорости.

ParentProxy
ParentPort

Соответственно адрес или имя и порт следующего прокси-сервера, входящий трафик от которого BSB будет ограничивать. Значение ParentPort не может быть равно ListenPort, если BSB и ваш основной прокси-сервер работают вместе на одном компьютере. Т.к. сама программа BSB пока не умеет связываться напрямую с Web и FTP серверами, то этот прокси-сервер следующего уровня для этой операции и нужен, и попутно он ещё может выполнять полезную функцию кэширования.
Возможен и специфический вариант использования BSB, если в этих же параметрах прописать адрес Web-сервера и его порт 80 (обычно), тогда BSB может выполнять роль ограничителя трафика, исходящего от этого Web-сервера.

TotalSpeed=8000

Значение полной скорости канала в байтах в секунду для входящего трафика, который и необходимо ограничивать. Если у вас - выделенка на 256 КБит/с, то тут надо написать 32000, если же у вас выделенка только на 32 КБит/с, то - 4000, это же значение подойдет и для модемных соединений, если на скорости более 33600 бит/с обычно соединения не происходит.

DefaultSpeedLimit=значение не менее 100 или 0

Значение в этом параметре определяет максимальную по умолчанию скорость в байтах в секунду входящего трафика на IP-адрес, когда срабатывает ограничение по скорости (см. описание нескольких параметров далее). В секции IP можно указать для каждого IP адреса индивидуальные ограничения. Значение 0 отменяет по умолчанию ограничение скорости входящего трафика. Минимальное ограничение скорости установлено в программе BSB равным 100. Поэтому меньшие значения просто будут срабатывать, как значение 100

DefaultSizeLimit=30

Ограничение недельного трафика в мегабайтах для всех IP-адресов по умолчанию. В секции IP можно указать для каждого IP адреса индивидуальные ограничения. Если с IP-адреса скачан больший объем данных, чем указано в этом параметре, то все соединения с этого IP-адреса обрываются, а при установлении новых соединений на них выдается содержимое файла, указанного в параметре SizeLimitFile. Значение 0 выключает ограничение недельного трафика. Одна неделя заканчивается, а новая начинается в воскресенье в 0:00:00.

LimitTime=20

Время в секундах от момента установки клиентом соединения, по истечении которого начинает работать ограничение по скорости. Рекомендуются значения от 10 до 60 секунд, чтобы все мелкие файлы успевали скачиваться к клиенту без ограничений, а вот большие файлы уже ограничивались по скорости.

ConnectionsCount=2

Число одновременных активных соединений с различных IP-адресов, начиная с которого действуют ограничения скорости для каждого соединения. Если на данный момент времени с BSB установлено соединений меньше, чем указано в параметре, то ограничение скорости не производится. Если число одновременных соединений больше или равно параметру, но все они с одного IP-адреса, то на каждое соединение применяется ограничение определенное для данного IP-адреса или ограничение по умолчанию. Но если с BSB установили соединения клиенты с различных IP-адресов числом, превышающим значение параметра, но на все эти соединения срабатывает ограничение по скорости, зависящие дополнительно от параметра IPSpeedLimitType.

MaxConnections=5

Ограничение по умолчанию на максимальное число соединений с одного компьютера, 0 - нет ограничений. В секции IP можно указать для каждого IP адреса индивидуальные ограничения. Например, один процесс IE версий 5.x устанавливает, по-видимому, не более 4-х соединений для получения данных, независимо от числа открытых окон. Если клиент пытается установить соединения, и их число больше максимального, то такие соединения с этого IP-адреса обрываются и на них выдается содержимое файла, указанного в параметре NoConnFile.

ConnTimeoutTime=240

Число секунд, в течение которого происходит ожидание поступления каких-нибудь данных от сервера, если это время проходит без поступления данных, то соединение закрывается по тайм-ауту, а клиенту отсылается содержимое файла, указанного в параметре ConnTimeoutFile

SpeedLimitHours=0:00-24:00

Список интервалов времени, в которых программа BSB регулирует скорость, вне указанных интервалов никакого ограничения на скорость скачивания информации не накладывается. Несколько интервалов времени задаются через запятую, часы могут быть от 0 до 24, минуты от 0 до 59.

SizeLimitFile=errors\bsb.html
ParentNoConnFile=errors\pnc.html
ConnTimeoutFile=errors\cto.html,,504 Gateway Timeout
NoConnFile=errors\nmc.html

В этих параметра указываются файлы с сообщением для пользователей, когда возникает одна из ситуаций, соответственно:
- пользователем достигнуто недельное ограничение трафика
- невозможно подсоединиться к прокси-серверу следующего уровня
- по соединению не передавалось от сервера долгое время каких-либо данных
- с компьютера пользователя уже установлено максимально разрешенное для него число одновременных соединений.
В файле, который указан в параметре ParentNoConnFile, первые 2 вхождения строки %s заменяются на адрес и порт проски-сервера из параметра ParentProxy.
По умолчанию, предполагается, что указанные файлы имеют формат HTML, но можно указать не только текстовые HTML-файлы, а файлы любого формата, которые понимают браузеры, но при этом надо указать точное описание его формата, которое будет передаваться в поле Content-Type HTTP-заголовка ответа, например:
NoConnFile=myerrors\info.gif, image/gif
По умолчанию, содержимое указанных файлов выдается клиенту с HTTP-кодом ошибки "503 Service Unavailable". Однако можно этот код поменять на любой другой стандартный HTTP-код 4хх или 5хх с любым текстовым описанием, например:
NoConnFile=myerrors\info.gif, image/gif, 503 Service Unavailable - Connections
ParentNoConnFile=errors\pnc.html,, 503 Service Unavailable - Next Proxy

IPSizeLog=ipsize.csv

Файл, в который в текстовом виде каждые 60 секунд пишется размер скачанных данных на IP-адреса за прошлую и за текущую недели. Формат файла - значения разделенные запятыми

AllIPMode=0

Параметр разрешает подключения. Если равен 1, то с BSB может установить соединение клиент с любого адреса, и если его адрес не прописан в секции [IP], то ограничение по скорости и трафику для соединений с этого адреса будут по умолчанию, но если адрес есть в секции IP, то для него есть возможность прописать индивидуальные настройки ограничений. Если параметр равен 2, то с BSB может установить соединение клиент с любого адреса безо всяких ограничений. Рекомендуется устанавливать значение этого параметра равным 0, тогда с BSB могут установить соединения клиенты только с IP-адресов, перечисленных в секции IP.

IPSpeedLimitType=1

Параметр определяет тип ограничения по скорости. При значении 0 лимит по скорости действует на каждое соединение с IP-адреса в отдельности. Т.е если ограничение по скорости равно 2000 байт/с и с IP-адреса установлено 5 соединений, на каждое действует ограничение по 2000. При значении 1 лимит по скорости распределяется на все соединения с IP-адреса. Т.е. в рассмотренном выше примере на каждое соединение будет действовать ограничение 400 байт/с.

Индивидуальные настройки. Секция [IP]

   В этой секции идет перечисление IP-адресов, c которых возможны подключения к BSB по протоколу TCP. Для каждого IP-адреса можно задать ограничения по скорости, недельному трафику и числу соединений, отличные от значений по умолчанию, заданных в секции [Config], а так же связать с IP-адресом имя, которое пишется в журнале запросов. Чтобы программа BSB воспринимала перечисленные в этой секции IP-адреса параметр AllIPMode должен быть равен 0 или 1. Пример списка IP-адресов с различными настройками:

192.168.0.1=L0 W0 C0 Nbsbcomp

Здесь задано, что скорость скачивания данных BSB не будет ограничивать (параметр L0), еженедельный объем данных не ограничен (W0), число одновременных соединений не ограничено (C0), и в журналах обращения с этого IP-адреса будут регистрироваться ещё и с именем bsbcomp (Nbsbcomp). В общем, настройки с нулями создавать не рекомендуется, т.к. в этом случае BSB не играет своей ограничивающей роли.

192.168.0.2=L2000 W40 C4 Nhuge_downloader

В данном случае задано, ограничение по скорости в 2000 байт/с (L2000 ), которое, видимо, отлично от установленного по умолчанию. Так же задано явное ограничение недельного трафика в 40 мегабайт и числа соединений. Ограничение на максимум 4 одновременных соединения (C4) - это рекомендуемое минимальное значение для пользователей с браузерами IE 5.x. Так же ассоциировано имя huge_downloader для записи в журналах.

192.168.101.2=B W50 C0 Nras1

Настройка для подключения удаленного пользователя по модему. Первая буква B задает баласирующее ограничение скорости скачивания.

192.168.0.2=Nuser_1
192.168.0.3
192.168.0.4

Простое перечисление IP-адресов. По соединениям с этих IP-адресов будут применены ограничения по умолчанию заданные в секции [Config]. Имя user_1 связано с одним адресом, а с остальными никакого имени не ассоциировано, в журналах будет прочек (-) в поле, где записывается имя.

   Т.о у каждого IP-адреса можно уточнить индивидуальные настройки ограничения скорости с помощью только одного из параметров B или Lчисло, ограничения недельного трафика параметром Wчисло, ограничения числа одновременных подключений параметром Cчисло. А так же указать с помощью параметра Nсимволы_имени_без_пробелов некоторое имя, ассоциированное с IP-адресом для регистрации его с журналах. Параметры должны следовать в строке в перечисленном выше порядке и могут отсутствовать.