Розбіжності

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

--- mikrotikapi [2022/09/24 14:39]
127.0.0.1 зовнішнє редагування
+++ mikrotikapi [2023/07/11 12:44] (поточний)
nightfly [Увага]
@@ Рядок 1: / Рядок 1: @@
-====== Внимание ======
+====== Увага ======
-Данная реализация является устаревшей с релиза 0.9.6 и больше не поддерживается и не развивается.
+Ця реалізація є застарілою з релізу 0.9.6 і більше не підтримується та не розвивається.
 {{:alertold.png? |}}
 \\
-Используйте [[multigen|КучаГен aka MultiGen]]. Он неимоверно крут и избавлен от всех детских болезней пинания <del>трупа ногами</del> Mikrotik в API.
+Використовуйте [[multigen|КупаГен aka MultiGen]]. Він неймовірно крутий і позбавлений усіх дитячих хвороб штурхання <del>трупа ногами</del> Mikrotik в API.
-====== Настройка MikroTik в качестве NAS ======
+====== Налаштування MikroTik як NAS ======
-В данном разделе подробно описана процедура связывания устройств под управлением RouterOS с биллингом. Для начала вам нужно:
+У цьому розділі докладно описано процедуру зв'язування пристроїв під управлінням RouterOS з білінгом. Для початку вам потрібно:
   - Сервер Ubilling:
-    - Установлен при помощи [[setupubinstaller|UBinstaller]]
+    - Встановлений за допомогою [[setupubinstaller|UBinstaller]]
-    - Параметры:
+    - Параметри:
-      - Внешний интерфейс, //igb0// - 63.163.105.6/29
+      - Зовнішній інтерфейс, //igb0// - 63.163.105.6/29
-      - Локальный интерфейс, //igb1// - 10.0.0.254/24
+      - Локальний інтерфейс, //igb1// - 10.0.0.0.254/24
-  - Устройство MikroTik с ОС RouterOS:
+  - Пристрій MikroTik з ОС RouterOS:
-    - Сброшен к стандартным конфигурациям
+    - Скинутий до стандартних конфігурацій
-    - Настроены только:
+    - Налаштовані тільки:
-      - Интерфейсы (WAN - ether1, LAN - bridge1)
+      - Інтерфейси (WAN - ether1, LAN - bridge1)
-      - IP интерфейсов (ether1 - 63.163.105.2/29, bridge1 - 10.0.0.1/24)
+      - IP інтерфейсів (ether1 - 63.163.105.2/29, bridge1 - 10.0.0.1/24)
-      - Маршруты (0.0.0.0/0 63.163.105.1, 10.0.0.0/24 bridge1)
+      - Маршрути (0.0.0.0/0 63.163.105.1, 10.0.0.0.0/24 bridge1)
 {{ :mikrotik_network_schema.png?650 |}}
-===== Расширение функционала скриптов On* =====
+===== Розширення функціоналу скриптів On* =====
-Для того, чтобы скрипты On* могли управлять устройствами на базе RouterOS, необходимо заменить их, последовательно выполнив следующие команды в консоли сервера Ubilling:
+Для того, щоб скрипти On* могли керувати пристроями на базі RouterOS, необхідно замінити їх, послідовно виконавши такі команди в консолі сервера Ubilling:
 <code>
 # rm /etc/stargazer/Get* && rm /etc/stargazer/On* && rm /etc/stargazer/fullArp.php && rm /etc/stargazer/config
@@ Рядок 28: / Рядок 28: @@
 # chmod a+x /etc/stargazer/On*
 </code>
-**//Важно://** Скрипты разработаны для управления NAS под управлением ОС FreeBSD и RouterOS. Запуск скриптов возможен только на ОС FreeBSD.
+**//Важливо://** Скрипти розроблено для керування NAS під керуванням ОС FreeBSD і RouterOS. Запуск скриптів можливий тільки на ОС FreeBSD.
-Завершаем замену, указав параметры подключения к базе данных и пути к log-файлу в файле //<</etc/stargazer/config.ini>>//:
+Завершуємо заміну, вказавши параметри підключення до бази даних і шляхи до log-файлу у файлі //<</etc/stargazer/config.ini>> //:
 <code ini config.ini>
 [database]                 ; Настройки базы данных:
@@ Рядок 37: / Рядок 37: @@
 username = root              ; Логин сервера БД
 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"
 fwcmd = '/sbin/ipfw -q'      ; Команда "ipfw"
-[mikrotik]                 ; Настройки для MikroTik:
+[mikrotik]                 ; Налаштування для MikroTik:
 api_port = 8728              ; Порт API
-rate_val = 'k'               ; В чем измеряется скорость
+rate_val = 'k'               ; У чому вимірюється швидкість
-attempts = 3                 ; Количество попыток подключения
+attempts = 3                 ; Кількість спроб підключення
-timeout = 2                  ; Тайм-аут попытки подключения
+timeout = 2                  ; Тайм-аут спроби підключення
-delay = 1                    ; Количество попыток подключится
+delay = 1                    ; Кількість спроб підключитися
 </code>
+===== Модуль "Розширене налаштування MikroTik" =====
-===== Модуль "Расширенная настройка MikroTik" =====
+Починаючи з версії 0.4.3 для кожного сервера доступу MikroTik у модулі "Сервера доступу (NAS)" доступна кнопавка розширеного налаштування, яке, водночас, є мінімальним. Після переходу в модуль і введення у відповідні поля правильних логіна і пароля від сервера доступу побачимо, приблизно, таку картину:
-Начиная с версии 0.4.3 для каждого сервера доступа MikroTik в модуле "Сервера доступа (NAS)" доступна кнопочка расширенной настройки, которая, в то же время, является минимальной. После перехода в модуль и ввода в соответствующие поля правильных логина и пароля от сервера доступа увидим, приблизительно, следующую картину:
 {{ :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>
 /ip service set api port=8728 address=10.0.0.254 disabled=no
 </code>
-__//Описание параметров://__
+__//Опис параметрів://__
-  * //port// - номер API-порта, по которому будем подключаться к устройству
+  * //port// - номер API-порту, за яким будемо підключатися до пристрою
-  * //address// - адрес, с которого разрешено подключение, т.е адрес сервера Ubilling
+  * //address// - адреса, з якої дозволено підключення, тобто адреса сервера Ubilling
-===== Экспорт статистики по трафику =====
+===== Експорт статистики по трафіку =====
-Для того, чтобы лицезреть статистику по трафику в Ubilling надо включить NetFlow-сенсор (в MikroTik его именуют как Traffic Flow) и настроить экспорт на сервер Ubilling. Для этого последовательно исполняем в консоли устройства с RouterOS следующие команды:
+Для того, щоб споглядати статистику по трафіку в Ubilling, треба увімкнути NetFlow-сенсор (у MikroTik його іменують як Traffic Flow) і налаштувати експорт на сервер Ubilling. Для цього послідовно виконуємо в консолі пристрою з RouterOS такі команди:
 <code>
 /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
 </code>
-__//Описание параметров://__
+__//Опис параметрів://__
-  * //cache-entries// - максимальное количество netflow-потоков, одновременно обрабатываемое устройством
+  * //cache-entries// - максимальна кількість netflow-потоків, яку одночасно обробляє пристрій
-  * //address// - адрес:порт, на который экспортировать статистику, т.е адрес сервера Ubilling, порт - 42111
+  * //address// - адреса:порт, на який буде експортуватись статистика, тобто адреса сервера Ubilling, порт - 42111
-===== Настройка фаервола MikroTik =====
+===== Налаштування фаєрвола MikroTik =====
-  * Добавляем правило NAT. В него будут попадать все сети из списка адресов, с названием //"NAT"//:
+  * Додаємо правило NAT. У нього потраплятимуть усі мережі зі списку адрес, з назвою //"NAT"//:
 <code>
 /ip firewall nat add chain=srcnat out-interface="ether1" src-address-list="NAT" action=masquerade
 </code>
-  * Добавим сеть, которую будем NATить, в список //"NAT"//:
+  * Додамо мережу, яку будемо NATити, у список //"NAT"//:
 <code>
 /ip firewall address-list add address=10.0.0.0/24 list="NAT"
 </code>
-  * Добавим правила, разрешающие адресам из списка //"ALLOW"// хождение из локальной сети в Интернет (1) и обратно (2), а так же запрещающее хождение всего трафика, которые не попал под вышестоящие правила (3):
+* Додамо правила, що дозволяють адресам зі списку //"ALLOW"// ходити з локальної мережі в Інтернет (1) і назад (2), а також забороняють проходження всього трафіку, що не потрапив під вищезазначені правила (3):
 <code>
 /ip firewall filter \
@@ Рядок 111: / Рядок 110: @@
 </code>
-===== Настройка MikroTik DHCP =====
+===== Налаштування MikroTik DHCP =====
-В случае, если сервер Ubilling и устройство MikroTik находятся в разных широковещательных сегментах вы можете использовать DHCP-сервер MikroTik. Для этого нужно:
+У разі, якщо сервер Ubilling і пристрій MikroTik розташовані в різних широкомовних сегментах, ви можете використовувати DHCP-сервер MikroTik. Для цього потрібно:
-  *  Установить выдаваемые пользователям сети параметры. А именно: адрес основного шлюза (gateway), маску подсети (netmask) и адрес сервера имён (dns):
+  * Встановити параметри, що видаються користувачам мережі. А саме: адресу основного шлюзу (gateway), маску підмережі (netmask) і адресу сервера імен (dns):
 <code>
 /ip dhcp-server network add address=10.0.0.0/24 gateway=10.0.0.1 netmask=24 dns=10.0.0.1
 </code>
-  * Добавить DHCP-сервер на интерфейсе пользователей:
+  * Додати DHCP-сервер на інтерфейсі користувачів:
 <code>
 /ip dhcp-server add interface="bridge1" address-pool=static-only authoritative=yes
 </code>
-  * В модуле "Расширенная настройка MikroTik" для настраиваемой сети поставить галочку напротив //"Управлять DHCP"//
+  * У модулі "Розширене налаштування MikroTik" для мережі, що налаштовується, поставити галочку навпроти //"Керувати DHCP"//.
-===== Настройка MikroTik PPPoE =====
+===== Налаштування MikroTik PPPoE =====
-В случае, если сервер Ubilling должен создавать пользователей PPP:
+У разі, якщо сервер Ubilling повинен створювати користувачів PPP:
-  * Добавить PPPoE-сервер на интерфейсе пользователей:
+  * Додати PPPoE-сервер на інтерфейсі користувачів:
 <code>
 /interface pppoe-server server  \
@@ Рядок 133: / Рядок 132: @@
 </code>
-  * В модуле "Расширенная настройка MikroTik" для настраиваемой сети поставить галочку напротив //"Управлять PPP"//
+  * У модулі "Розширене налаштування MikroTik" для мережі, що налаштовується, поставити галочку навпроти //"Керувати PPP"//.
-===== Настройка MikroTik Queue Tree =====
+===== Налаштування MikroTik Queue Tree =====
-С версии 0.7.7 скрипты инициализации умеют управлять деревьями очередей. С версии 0.7.7 эта функция идёт из коробки, для всех предшествующих установок, необходимо в консоли биллинга прописать следующие команды:
+З версії 0.7.7 скрипти ініціалізації вміють керувати деревами черг. З версії 0.7.7 ця функція йде з коробки, для всіх попередніх налаштувань, необхідно в консолі білінгу прописати такі команди:
 <code>
 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**, яка в теорії, може відтермінувати ваш перехід на КучаГен, але це не точно.

Ubilling Wiki

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

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

Розбіжності

Налаштування сторінки