Користувальницькькі налаштування

Налаштування сайту


mikrotikapi

Розбіжності

Тут показані розбіжності між вибраною ревізією та поточною версією сторінки.

Посилання на цей список змін

Порівняння попередніх версій Попередня ревізія
Наступна ревізія По сторонах наступні версії
mikrotikapi [2023/07/08 02:29]
bobr
mikrotikapi [2023/07/08 02:55]
bobr
Рядок 37: Рядок 37:
 username = root              ; Логин сервера БД username = root              ; Логин сервера БД
 password = password          ; Пароль сервера БД password = password          ; Пароль сервера БД
-database = stg               ; Название БД Ubilling+database = stg               ; Назва БД Ubilling
            
-[log]                      ; Настойки логирования: +[log]                      ; Налаштування логування: 
-enabled = true               ; Включено ли логирование (`true/false`) +enabled = true               ; Чи ввімкнено логування (`true/false`) 
-method = 'file'              ; Метод логирования (только `file`) +method = 'file'              ; Метод логування (тільки `file`) 
-path = '/var/stargazer'      ; Путь к log-файлу +path = '/var/stargazer'      ; Шлях до log-файлу 
-file = 'allconnect.log'      ; Имя log-файла +file = 'allconnect.log'      ; Ім'я log-файлу 
-debug = false                ; Режим отладки (`true/false`)+debug = false                ; Режим налагодження (`true/false`)
            
-[rscriptd]                 ; Настройки для RScriptD: +[rscriptd]                 ; Налаштування для RScriptD: 
-rate_val = 'Kbit/s'          ; В чем измеряется скорость+rate_val = 'Kbit/s'          ; У чому вимірюється швидкість
 arpcmd = '/usr/sbin/arp'     ; Команда "arp" arpcmd = '/usr/sbin/arp'     ; Команда "arp"
 fwcmd = '/sbin/ipfw -q'      ; Команда "ipfw" fwcmd = '/sbin/ipfw -q'      ; Команда "ipfw"
            
-[mikrotik]                 ; Настройки для MikroTik:+[mikrotik]                 ; Налаштування для MikroTik:
 api_port = 8728              ; Порт API api_port = 8728              ; Порт API
-rate_val = 'k'               ; В чем измеряется скорость +rate_val = 'k'               ; У чому вимірюється швидкість 
-attempts = 3                 ; Количество попыток подключения +attempts = 3                 ; Кількість спроб підключення 
-timeout = 2                  ; Тайм-аут попытки подключения+timeout = 2                  ; Тайм-аут спроби підключення
 delay = 1                    ; Количество попыток подключится delay = 1                    ; Количество попыток подключится
 </code> </code>
  
- +===== Модуль "Розширене налаштування MikroTik" ===== 
-===== Модуль "Расширенная настройка MikroTik" ===== +Починаючи з версії 0.4.3 для кожного сервера доступу MikroTik у модулі "Сервера доступу (NAS)" доступна кнопавка розширеного налаштування, яке, водночас, є мінімальним. Після переходу в модуль і введення у відповідні поля правильних логіна і пароля від сервера доступу побачимо, приблизно, таку картину:
-Начиная с версии 0.4.3 для каждого сервера доступа MikroTik в модуле "Сервера доступа (NAS)" доступна кнопочка расширенной настройки, которая, в то же времяявляется минимальной. После перехода в модуль и ввода в соответствующие поля правильных логина и пароля от сервера доступа увидим, приблизительно, следующую картину:+
  
 {{ :mikrotikextconf1.png?400|}} {{ :mikrotikextconf1.png?400|}}
  
-Здесь мы видим 2 селектора с интерфейсами: +Тут ми бачимо 2 селектори з інтерфейсами: 
-  * //Интерфейс пользователей// - ARP и DHCP записи будут созданы с привязкой к этому порту устройства +  * //Інтерфейс користувачів// - ARP і DHCP записи будуть створені з прив'язкою до цього порту пристрою 
-  * //Интерфейс графика// - графики этого интерфейса будут отображены для текущего NAS в модуле "Отчет по трафику".+  * //Інтерфейс графіка// - графіки цього інтерфейсу будуть відображені для поточного NAS у модулі "Звіт по трафіку".
  
-Далее идет раздел "__//Установка поведения скриптов OnConnect/OnDisconnect для NAS//__"Здесь мы ставим галочки там, где это необходимо. Соответственно скрипты будут выполнять те или иные действия, которые вы указали. Учтите, что перед установкой галочки "//Управлять DHCP//" необходима предварительная [[mikrotikapi#настройка_mikrotik_dhcp|настройка MikroTik DHCP]] на интерфейсе пользователей. Управление PPP - в разработке.+Далі йде розділ "__//Встановлення поведінки скриптів OnConnect/OnDisconnect для NAS//__"Тут ми ставимо галочки там, де це необхідно. Відповідно скрипти виконуватимуть ті чи інші дії, які ви вказали. Враховуйте, що перед встановленням галочки "//Керувати DHCP//" необхідна попередня [[mikrotikapi#налаштування_mikrotik_dhcp|налаштування MikroTik DHCP]] на інтерфейсі користувачів. Управління PPP - у розробці.
  
-Следующий раздел "__//Общая информация о состоянии MikroTik`a//__", который показывает uptime, процент использования CPU, RAM и другую информацию о состоянии устройства MikroTik.+Наступний розділ "__//Загальна інформація про стан MikroTik`a//__", який показує uptime, відсоток використання CPU, RAM та іншу інформацію про стан пристрою MikroTik.
  
-===== Включение MikroTik API ===== +===== Увімкнення MikroTik API ===== 
-Для того, чтобы включить поддержку управления устройством под управлением RouterOS через API выполним в терминале последнего следующую команду:+Для того, щоб увімкнути підтримку керування пристроєм під управлінням RouterOS через APIвиконаємо в терміналі останнього таку команду:
 <code> <code>
 /ip service set api port=8728 address=10.0.0.254 disabled=no /ip service set api port=8728 address=10.0.0.254 disabled=no
 </code> </code>
-__//Описание параметров://__ +__//Опис параметрів://__ 
-  * //port// - номер API-порта, по которому будем подключаться к устройству +  * //port// - номер API-порту, за яким будемо підключатися до пристрою 
-  * //address// - адрес, с которого разрешено подключение, т.е адрес сервера Ubilling+  * //address// - адресаз якої дозволено підключення, тобто адреса сервера Ubilling
  
-===== Экспорт статистики по трафику ===== +===== Експорт статистики по трафіку ===== 
-Для того, чтобы лицезреть статистику по трафику в Ubilling надо включить NetFlow-сенсор (в MikroTik его именуют как Traffic Flow) и настроить экспорт на сервер Ubilling. Для этого последовательно исполняем в консоли устройства с RouterOS следующие команды:+Для того, щоб споглядати статистику по трафіку в Ubilling, треба увімкнути NetFlow-сенсор (у MikroTik його іменують як Traffic Flow) і налаштувати експорт на сервер Ubilling. Для цього послідовно виконуємо в консолі пристрою з RouterOS такі команди:
 <code> <code>
 /ip traffic-flow set enable=yes interfaces=all cache-entries=256k active-flow-timeout=30m inactive-flow-timeout=15s /ip traffic-flow set enable=yes interfaces=all cache-entries=256k active-flow-timeout=30m inactive-flow-timeout=15s
 /ip traffic-flow target add address=10.0.0.254:42111 version=5 /ip traffic-flow target add address=10.0.0.254:42111 version=5
 </code> </code>
-__//Описание параметров://__ +__//Опис параметрів://__ 
-  * //cache-entries// - максимальное количество netflow-потоков, одновременно обрабатываемое устройством +  * //cache-entries// - максимальна кількість netflow-потоків, яку одночасно обробляє пристрій 
-  * //address// - адрес:порт, на который экспортировать статистику, т.е адрес сервера Ubilling, порт - 42111+  * //address// - адреса:порт, на який буде експортуватись статистика, тобто адреса сервера Ubilling, порт - 42111
  
-===== Настройка фаервола MikroTik ===== +===== Налаштування фаєрвола MikroTik ===== 
-  * Добавляем правило NAT. В него будут попадать все сети из списка адресовс названием //"NAT"//:+  * Додаємо правило NAT. У нього потраплятимуть усі мережі зі списку адрес, з назвою //"NAT"//:
 <code> <code>
 /ip firewall nat add chain=srcnat out-interface="ether1" src-address-list="NAT" action=masquerade /ip firewall nat add chain=srcnat out-interface="ether1" src-address-list="NAT" action=masquerade
 </code> </code>
  
-  * Добавим сеть, которую будем NATитьв список //"NAT"//:+  * Додамо мережуяку будемо NATитиу список //"NAT"//:
 <code> <code>
 /ip firewall address-list add address=10.0.0.0/24 list="NAT" /ip firewall address-list add address=10.0.0.0/24 list="NAT"
 </code> </code>
  
-  * Добавим правила, разрешающие адресам из списка //"ALLOW"// хождение из локальной сети в Интернет (1) и обратно (2), а так же запрещающее хождение всего трафикакоторые не попал под вышестоящие правила (3):+* Додамо правила, що дозволяють адресам зі списку //"ALLOW"// ходити з локальної мережі в Інтернет (1) і назад (2), а також забороняють проходження всього трафікущо не потрапив під вищезазначені правила (3):
 <code> <code>
 /ip firewall filter \  /ip firewall filter \ 
Рядок 111: Рядок 110:
 </code> </code>
  
-===== Настройка MikroTik DHCP ===== +===== Налаштування MikroTik DHCP ===== 
-В случаеесли сервер Ubilling и устройство MikroTik находятся в разных широковещательных сегментах вы можете использовать DHCP-сервер MikroTik. Для этого нужно: +У разіякщо сервер Ubilling і пристрій MikroTik розташовані в різних широкомовних сегментахви можете використовувати DHCP-сервер MikroTik. Для цього потрібно: 
-  *  Установить выдаваемые пользователям сети параметры. А именно: адрес основного шлюза (gateway), маску подсети (netmask) и адрес сервера имён (dns):+  * Встановити параметри, що видаються користувачам мережі. А саме: адресу основного шлюзу (gateway), маску підмережі (netmask) і адресу сервера імен (dns):
 <code> <code>
 /ip dhcp-server network add address=10.0.0.0/24 gateway=10.0.0.1 netmask=24 dns=10.0.0.1 /ip dhcp-server network add address=10.0.0.0/24 gateway=10.0.0.1 netmask=24 dns=10.0.0.1
 </code> </code>
  
-  * Добавить DHCP-сервер на интерфейсе пользователей:+  * Додати DHCP-сервер на інтерфейсі користувачів:
 <code> <code>
 /ip dhcp-server add interface="bridge1" address-pool=static-only authoritative=yes /ip dhcp-server add interface="bridge1" address-pool=static-only authoritative=yes
 </code> </code>
  
-  * В модуле асширенная настройка MikroTik" для настраиваемой сети поставить галочку напротив //"Управлять DHCP"//+  * У модулі озширене налаштування MikroTik" для мережі, що налаштовується, поставити галочку навпроти //"Керувати DHCP"//.
  
-===== Настройка MikroTik PPPoE ===== +===== Налаштування MikroTik PPPoE ===== 
-В случаеесли сервер Ubilling должен создавать пользователей PPP: +У разіякщо сервер Ubilling повинен створювати користувачів PPP: 
-  * Добавить PPPoE-сервер на интерфейсе пользователей:+  * Додати PPPoE-сервер на інтерфейсі користувачів:
 <code> <code>
 /interface pppoe-server server  \ /interface pppoe-server server  \
Рядок 133: Рядок 132:
 </code> </code>
  
-  * В модуле асширенная настройка MikroTik" для настраиваемой сети поставить галочку напротив //"Управлять PPP"//+  * У модулі озширене налаштування MikroTik" для мережі, що налаштовується, поставити галочку навпроти //"Керувати PPP"//.
  
  
-===== Настройка MikroTik Queue Tree ===== +===== Налаштування MikroTik Queue Tree ===== 
-С версии 0.7.7 скрипты инициализации умеют управлять деревьями очередейС версии 0.7.7 эта функция идёт из коробки, для всех предшествующих установок, необходимо в консоли биллинга прописать следующие команды:+З версії 0.7.7 скрипти ініціалізації вміють керувати деревами чергЗ версії 0.7.7 ця функція йде з коробки, для всіх попередніх налаштувань, необхідно в консолі білінгу прописати такі команди:
 <code> <code>
 cp -r /etc/stargazer/system /etc/stargazer/system.bak cp -r /etc/stargazer/system /etc/stargazer/system.bak
Рядок 146: Рядок 145:
  
  
-===== Дополнительно ===== +===== Додатково ===== 
-  В случаеесли вы неожиданно таки решите испытать судьбу и попробовать использовать Mikrotik NAS под Linux - можно попробовать обратить свой взор на [[http://local.com.ua/forum/topic/55756-релизы-ubilling-2014/?p=576378|вот этот пост на форуме]]. +У разіякщо ви раптом таки вирішили випробувати долю і спробувати використовувати Mikrotik NAS під Linux - можна спробувати звернути свій погляд на [[http://local.com.ua/forum/topic/55756-релизы-ubilling-2014/?p=576378|ось цей пост на форумі]]. 
-  * Можете также почитать, [[https://nixrecords.wordpress.com/2015/07/20/%D1%83%D0%BF%D1%80%D0%B0%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5-remote-mikrotik-nas-%D0%B8%D0%B7-ubilling/|интересную статью]] о тонкостях управления MikroTik из космоса за авторством [[http://local.com.ua/forum/user/15601-mac/|mac]]. +  * Можете також почитати, [[https://nixrecords.wordpress.com/2015/07/20/%D1%83%D0%BF%D1%80%D0%B0%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5-remote-mikrotik-nas-%D0%B8%D0%B7-ubilling/|цікаву статтю]] про тонкощі управління MikroTik з космосу за авторством [[http://local.com.ua/forum/user/15601-mac/|mac]]. 
-  * В случае затруднений с использованием DHCP на ROS6 можно воспользоваться [[http://local.com.ua/forum/topic/74680-ubiling-mikrotik-v6291/?p=786526|советом по ссылке]]. +  * У разі труднощів з використанням DHCP на ROS6 можна скористатися [[http://local.com.ua/forum/topic/74680-ubiling-mikrotik-v6291/?p=786526|порадою за посиланням]]. 
-  * с ROS 6.29 в конфиг микротика по умолчанию включено правило "fasttrack-connection", которое позволяет пускать пакеты мимо CPU, т.е. путь прохождения пакетов меняется таким образом, что пакеты проходят мимо "mangle" и "queue"В случаеесли вы используете "управление очередями" вам необходимо выключить правило 'fasttrack-connection"+  * з ROS 6.29 у конфіг мікротика за замовчуванням увімкнене правило "fasttrack-connection", яке дає змогу пускати пакети повз CPU, тобто шлях проходження пакетів змінюється таким чином, що пакети проходять повз "mangle" і "queue"У разіякщо ви використовуєте "управління чергами" вам необхідно вимкнути правило 'fasttrack-connection"
-  Начиная с релиза 0.8.3 в пресеты добавлен firewall_off.ini позволяющий использовать разные аддресс-листы для авторизованных и отсоединенных пользователейПодробнее [[https://github.com/nightflyza/Ubilling/pull/80|тут]]. +Починаючи з релізу 0.8.3 до пресетів додано firewall_off.ini, що дає змогу використовувати різні аддрес-листи для авторизованих і неавторизованих користувачівДокладніше [[https://github.com/nightflyza/Ubilling/pull/80|тут]]. 
-  Поскольку в RouterOS 6.43 и выше изменен метод авторизации при подключении к RouterOS API начиная с релиза 0.9.0 добавлена возможность указывать, какой метод подключения использовать для каждого конкретного NAS. +Оскільки в RouterOS 6.43 і вище змінено метод авторизації під час підключення до RouterOS API, починаючи з релізу 0.9.0 додано можливість вказуватиякий метод підключення використовувати для кожного конкретного NAS. 
-  Начиная с релиза 0.9.2 модуль теперь может использовать телепатию для определения версии RouterOS и <del>осознания</del> метода подключения к Mikrotik API. Регулируется опцией ROUTEROS_VERSION_TELEPATHY и сопутствующими опциями ROUTEROS_VERSION_GET_WEB_PORT и ROUTEROS_VERSION_GET_SNMP_COMMUNITY в alter.ini.\\ __Логика работы фичи следующая:__  +Починаючи з релізу 0.9.2 модуль тепер може використовувати телепатію для визначення версії RouterOS і <del>усвідомлення</del> методу підключення до Mikrotik API. Регулюється опцією ROUTEROS_VERSION_TELEPATHY і супутніми опціями ROUTEROS_VERSION_GET_WEB_PORT і ROUTEROS_VERSION_GET_SNMP_COMMUNITY в alter.ini.\\ __Логіка роботи фічі така:__  
-    - пытаемся определить версию NAS, к которому подключаемся по SNMP или, если по SNMP не удалось путем парсинга стандартной login web page +    - намагаємося визначити версію NAS, до якого підключаємося через SNMP абоякщо через SNMP не вдалося шляхом парсингу стандартної login web page 
-    - если версию определить удалось+    - якщо версію визначити вдалося
-      * отключаем "мануальное" управление методами подключения +      * відключаємо "мануальне" керування методами підключення 
-      * выводим вместо чекбокса соответствующее сообщение +      * виводимо замість чекбокса відповідне повідомлення 
-    - если версию определить **НЕ** удалось+    - якщо версію визначити **НЕ** вдалося
-      * включаем "мануальное" управление методами подключения, давая возможность администратору самостоятельно указать метод подключения для конкртеного NAS +    * вмикаємо "мануальне" керування методами підключення, даючи можливість адміністратору самостійно вказати метод підключення для конкретного NAS 
-    * __**после обновления RouterOS до 6.45.хх окончательно выпилена возможность**__ использовать "старый" метод авторизации по API. Потому, если вы используете телепатию для определения версии RouterOS и ваши микротикоNASы до этого момента были сконфигурированы с опцией **НЕ использовать новый метод авотризации** - вам __БУДЕТ НЕОБХОДИМО__ пройтись по всем имеющимся микротикоNASам в модуле "Сервера доступа (NAS)", понажимать для каждого из них кнопку с "магической шестеренкойиубедившись, что данные по NASу подтянулись корректно и в методе авторизации теперь указано использование нового метода подключения - нажать кнопку "Сохранить". +    * __**після оновлення RouterOS до 6.45.хх остаточно випиляно можливість **__ використовувати "старий" метод авторизації за API. Тому, якщо ви використовуєте телепатію для визначення версії RouterOS і ваші мікротікоNASи до цього моменту були сконфігуровані з опцією **Не використовувати новий метод авторизації** - вам __ БУДЕ НЕОБХІДНО__ пройтися по всім наявним мікротікоNASам у модулі "Сервера доступу (NAS)", натиснути для кожного з них кнопку з "магічною шестернеютапереконавшись, що дані щодо NASу підтягнулися коректно та в методі авторизації тепер зазначено використання нового методу підключення- натиснути кнопку "Зберегти". 
-  Начиная с релиза 1.0.4 кастомный API порт теперь используется не только [[mikrotikapi#модуль_расширенная_настройка_mikrotik|расширенным конфигуратором микротикоНАСов]], но [[dnswitchmtik|динамическим шейпером для Mikrotik]], и самим Старгейзером(при работе с Mikrotik через API, естественно).+Починаючи з релізу 1.0.4кастомний API-порт тепер використовується не тільки [[mikrotikapi#модуль_розширене_налаштування_mikrotik|розширеним конфігуратором мікротикоНАСів]], але й [[dnswitchmtik|динамічним шейпером для Mikrotik]] та і самим Старгейзером (під час роботи з Mikrotik через API, звісно ж).
  
-===== Боль ===== +===== Біль ===== 
-В случаеесли вы все же используете этот функционал, вместо крутого и модного [[multigen|КучаГен-а]] и периодически испытываете боль, при использовании функционала кредитования вашими клиентами, можете присмотреться к опции **SC_MTAPI_FIX** которая в теории может отсрочить ваш переход на КучаГен, но это не точно.+У разіякщо ви все ж таки використовуєте цей функціонал, замість крутого і модного [[multigen|КучаГен-а]] та періодично відчуваєте біль, під час використання функціоналу кредитування вашими клієнтами, можете придивитися до опції **SC_MTAPI_FIX**, яка в теорії, може відтермінувати ваш перехід на КучаГен, але це не точно.
mikrotikapi.txt · Востаннє змінено: 2023/07/11 12:44 повз nightfly