Справочник команд (CLI)#

В Angie ADC доступно два интерфейса командной строки (CLI), позволяющих управлять настройками Angie ADC:

СLI на порту 2222 (новая версия, рекомендуемый интерфейс для большинства операций, кроме настройки VRRP и HTTPS);
СLI на порту 2022 (старая версия).

Ниже приведен обзор команд для новой версии СLI (на порту 2222). Список команд будет пополнен в ближайших релизах.

См. также инструкцию по запуску командной строки.

Синтаксис#

command option0 {option1|option2|...|option N} [option3] [{option4|option5|...|option M}] [option6 <user-input1>] [<user-input2>] <user-input3>

Параметры:

command — команда;
option0 — обязательный параметр;
{option1|option2|...|option N} — выбор из списка обязательных параметров;
[option3] — необязательный параметр;
[{option4|option5|...|option M}] — выбор из списка необязательных параметров;
[option6 <user-input1>] — необязательный параметр с пользовательским аргументом;
[<user-input2>] — необязательный пользовательский аргумент;
<user-input3> — обязательный пользовательский аргумент.

Возможности:

автодополнение команд по TAB;
поддержка истории команд;
подсказки по синтаксису команд по нажатию ?;
поддержка цветовой схемы;
поддержка сокращенных команд.

Поддерживаемые команды#

Область	Команда
Управление сертификатами	cert-config
Управление правилами брандмауэра	firewall
Просмотр журналов	logs
Просмотр информации о динамических модулях	modules
Просмотр и изменение настроек	settings
Управление системой	system
Работа с директорией `transfer`	transfer
Выполнение команды `ping`	ping
Выполнение команды `ip`	ip
Выполнение команды `vtysh`	vtysh
Выполнение команды `show`	show

cert-config#

Контекст cert-config позволяет управлять сертификатами, используемыми Angie ADC.

Поддерживаемые команды:

`cert-config`	Вход в контекст
`tls-upload`	Контекст загрузки сертификатов и ключей Angie ADC
`use`	Контекст копирования сертификатов и ключей Angie ADC из директории `transfer`
`list`	Вывод списка сертификатов `traffic` Angie ADC
`info`	Просмотр информации о сертификате
`match`	Сопоставление пары `ключ-сертификат`
`exit` или `Ctrl+Z`	Выход из контекста
`?`	Список доступных команд
`quit` или `Ctrl+Q`	Завершение сессии

tls-upload#

Контекст загрузки сертификатов и ключей Angie ADC.

Поддерживаемые команды:

`tls-upload`	Вход в контекст
`management`	Загрузка сертификата и ключа для управления Angie ADC
`traffic`	Загрузка сертификатов и ключей для передачи данных Angie ADC
`exit` или `Ctrl+Z`	Выход из контекста
`?`	Список доступных команд
`quit` или `Ctrl+Q`	Завершение сессии

management#

Загрузка сертификата и ключа для управления Angie ADC.

Синтаксис: management {crt|key} [name <filename>].

Параметры:

crt — загрузка сертификата;
key — загрузка ключа;
name <filename> — имя сохраняемого файла (игнорируется для команды management).

Для загрузки сертификата или ключа необходимо вставить текст сертификата или ключа в строку, затем вставить пустую строку или написать END в новой строке.

Пример:

(cert-config-tls-upload)$$ management crt
Warning: filename will be ignored for management certificate
Insert the certificate line by line at the end of the input, add an empty line or enter END
-----BEGIN CERTIFICATE-----
MIIF9TCCA92gAwIBAgIBATANBgkqhkiG9w0BAQUFADBOMQswCQYDVQQGEwJSVTEP
...
Z7SIEeCr84fIlxFMpRxNGZhJQ67xWLwQmjVcphi037Wpx+6dmQRtp8Q=
-----END CERTIFICATE-----
END
Successfully wrote to /etc/angie/crt/cp.crt
(cert-config-tls-upload)$$

При загрузке ключа и сертификата проверяется их корректность. В случае некорректного значения сертификат или ключ не будет сохранен:

Пример вывода:

(cert-config-tls-upload)$$ management crt
Warning: filename will be ignored for management certificate
Insert the certificate line by line at the end of the input, add an empty line or enter END
simple cert

Validation error: Invalid certificate format
(cert-config-tls-upload)$$

traffic#

Загрузка сертификатов и ключей для передачи данных Angie ADC.

Синтаксис: traffic {crt|key} [name <filename>].

Параметры:

crt — загрузка сертификата;
key — загрузка ключа;
name <filename> — имя сохраняемого файла (если отсутствует, то будет использовано имя cp.crt для сертификата и cp.key для ключа).

Для загрузки сертификата или ключа необходимо вставить текст сертификата или ключа в строку, затем вставить пустую строку или написать END в новой строке.

Пример загрузки сертификата с именем:

(cert-config-tls-upload)$$ traffic crt name site1.crt
Insert the certificate line by line at the end of the input, add an empty line or enter END
-----BEGIN CERTIFICATE-----
MIIF9TCCA92gAwIBAgIBATANBgkqhkiG9w0BAQUFADBOMQswCQYDVQQGEwJSVTEP
...
Z7SIEeCr84fIlxFMpRxNGZhJQ67xWLwQmjVcphi037Wpx+6dmQRtp8Q=
-----END CERTIFICATE-----

Successfully wrote to /etc/angie-lb/crt/site1.crt

При загрузке ключа и сертификата проверяется их корректность. В случае некорректного значения сертификат или ключ не будет сохранен.

tls-use#

Контекст копирования сертификатов и ключей Angie ADC из директории transfer.

Поддерживаемые команды:

`tls-use`	Вход в контекст
`management`	Копирование сертификата и ключа для управления Angie ADC из директории `transfer`
`traffic`	Копирование сертификатов и ключей для передачи данных Angie ADC из директории `transfer`
`exit` или `Ctrl+Z`	Выход из контекста
`?`	Список доступных команд
`quit` или `Ctrl+Q`	Завершение сессии

management#

Копирование сертификата и ключа для управления Angie ADC из директории transfer.

Синтаксис: management {crt|key} <source-filename> [name <destination-filename>].

Параметры:

crt — копирование сертификата;
key — копирование ключа;
<source-filename> — имя файла в директории transfer;
name <destination-filename> — имя сохраняемого файла (игнорируется для команды management).

Пример:

(cert-config-tls-use)$$ management crt cert1.crt
Warning: filename will be ignored for management certificate
Successfully wrote to /etc/angie/crt/cp.crt
(cert-config-tls-use)$$

При копировании сертификата или ключа проверяется их корректность. В случае некорректного значения сертификат или ключ не будет сохранен.

traffic#

Копирование сертификатов и ключей для передачи данных Angie ADC из директории transfer.

Синтаксис: traffic {crt|key} <source_filename> [name <destination_filename>].

Параметры:

crt — копирование сертификата;
key — копирование ключа;
<source-filename> — имя файла в директории transfer;
name <destination-filename> — имя сохраняемого файла (если отсутствует, то будет использовано имя cp.crt для сертификата и cp.key для ключа).

Пример копирования сертификата с именем:

(cert-config-tls-use)$$ traffic crt cert1.crt name site1.crt
Successfully wrote to /etc/angie-lb/crt/site1.crt
(cert-config-tls-use)$$

При копировании ключа и сертификата проверяется их корректность. В случае некорректного значения сертификат или ключ не будет сохранен.

list#

Вывод списка сертификатов traffic Angie ADC.

Синтаксис: list.

Пример:

(cert-config)$$ list
cp.crt   : invalid
cp.key   : invalid
site1.crt: certificate
site1.key: key

Параметры:

invalid — сертификат или ключ не прошли проверку;
certificate — сертификат;
key — ключ.

info#

Просмотр информации о сертификате.

Синтаксис: info {management | traffic [name <filename>]}.

Параметры:

management — просмотр информации о сертификате для управления Angie ADC;
traffic — просмотр информации о сертификате для передачи данных Angie ADC;
name <filename> — имя сертификата.

Пример:

(cert-config)$$ info traffic name site1.crt
Certificate:
    Data:
        Version: 3 (0x2)
        Serial Number: 1 (0x1)
        Signature Algorithm: sha1WithRSAEncryption
        Issuer: C = RU, ST = Moscow, O = Angie, OU = EVO, CN = Root CA
        Validity
            Not Before: Feb 18 12:23:08 2025 GMT
            Not After : Feb 18 12:23:08 2027 GMT
        Subject: CN = Demo Certificate, ST = Moscow, C = RU, O = Angie, OU = EVO
        Subject Public Key Info:
            Public Key Algorithm: rsaEncryption
                Public-Key: (4096 bit)
                Modulus:
...
(cert-config)$$

match#

Сопоставление пары ключ-сертификат.

Синтаксис: match <certificate> <key>.

Параметры:

<certificate> — имя файла сертификата;
<key> — имя файла ключа.

Пример:

(cert-config)$$ match site1.crt site1.key
Certificate and key match
(cert-config)$$ match site1.crt site2.key
Certificate and key DO NOT match
(cert-config)$$

firewall#

Контекст firewall позволяет управлять правилами брандмауэра Angie ADC.

Поддерживаемые команды:

`firewall`	Вход в контекст
`list`	Вывод списка правил брандмауэра Angie ADC
`open`	Открытие порта в брандмауэре Angie ADC
`no open`	Закрытие порта в брандмауэре Angie ADC
`save`	Cохранение правил брандмауэра Angie ADC
`exit` или `Ctrl+Z`	Выход из контекста
`?`	Список доступных команд
`quit` или `Ctrl+Q`	Завершение сессии

list#

Вывод списка правил брандмауэра Angie ADC.

Синтаксис: list {ip|ip6}.

Параметры:

ip — вывод списка правил для IPv4;
ip6 — вывод списка правил для IPv6.

Пример вывода:

(firewall)$$ list ip
tcp 9999 enp0s2
(firewall)$$

open#

Открытие порта в брандмауэре Angie ADC.

Синтаксис: open {ip|ip6} {tcp|udp} <port> <interface>.

Параметры:

ip — открытие порта для IPv4;
ip6 — открытие порта для IPv6;
tcp — открытие порта для протокола TCP;
udp — открытие порта для протокола UDP;
<port> — номер порта;
<interface> — интерфейс.

Пример:

(firewall)$$ open ip tcp 9999 enp0s2
Port 9999/tcp successfully opened on interface enp0s2
(firewall)$$

no open#

Закрытие порта в брандмауэре Angie ADC.

Синтаксис: no open {ip|ip6} {tcp|udp} <port> <interface>.

Параметры:

ip — открытие порта для IPv4;
ip6 — открытие порта для IPv6;
tcp — открытие порта для протокола TCP;
udp — открытие порта для протокола UDP;
<port> — номер порта;
<interface> — интерфейс.

Пример:

(firewall)$$ no open ip tcp 9999 enp0s2
Port 9999/tcp successfully closed on interface enp0s2
(firewall)$$

save#

Сохранение правил брандмауэра Angie ADC.

Синтаксис: save.

logs#

Контекст logs позволяет просматривать журналы событий Angie ADC.

`logs`	Вход в контекст
`adc-agent`	События модуля `angie-adc-agent`
`adc-gslb`	События модуля `angie-adc-gslb`
`adc-server`	События модуля `angie-adc-server`
`adc-system`	События модуля `angie-adc-system`
`adc-tracker`	События модуля `angie-adc-tracker`
`kern`	События ядра
`lb`	События модуля `angie-lb` (балансировщика нагрузки)
`mgmt`	События модуля `angie`
`upgrade`	События обновления Angie ADC
`exit` или `Ctrl+Z`	Выход из контекста
`?`	Список доступных команд
`quit` или `Ctrl+Q`	Завершение сессии

adc-agent#

События модуля angie-adc-agent.

Синтаксис: adc-agent [{page|transfer}].

Параметры:

page — вывод записей в режиме постраничного просмотра;
transfer — копирование записей в директорию transfer.

adc-gslb#

События модуля angie-adc-gslb.

Синтаксис: adc-gslb [{page|transfer}].

Параметры:

page — вывод записей в режиме постраничного просмотра;
transfer — копирование записей в директорию transfer.

adc-server#

События модуля angie-adc-server.

Синтаксис: adc-server [{page|transfer}].

Параметры:

page — вывод записей в режиме постраничного просмотра;
transfer — копирование записей в директорию transfer.

adc-system#

События модуля angie-adc-system.

Синтаксис: adc-system [{page|transfer}].

Параметры:

page — вывод записей в режиме постраничного просмотра;
transfer — копирование записей в директорию transfer.

adc-tracker#

События модуля angie-adc-tracker.

Синтаксис: adc-tracker [{page|transfer}].

Параметры:

page — вывод записей в режиме постраничного просмотра;
transfer — копирование записей в директорию transfer.

kern#

События ядра.

Синтаксис: kern [{follow|page|transfer}].

Параметры:

follow — вывод записей в режиме реального времени;
page — вывод записей в режиме постраничного просмотра;
transfer — копирование записей в директорию transfer.

lb#

События модуля angie-lb (балансировщика нагрузки).

Синтаксис: lb {access|error} [{follow|page|transfer}].

Параметры:

access — вывод записей журнала запросов;
error — вывод записей журнала ошибок;
follow — вывод записей в режиме реального времени;
page — вывод записей в режиме постраничного просмотра;
transfer — копирование записей в директорию transfer.

mgmt#

События модуля angie.

Синтаксис: mgmt {access|error} [{follow|page|transfer}].

Параметры:

access — вывод записей журнала запросов;
error — вывод записей журнала ошибок;
follow — вывод записей в режиме реального времени;
page — вывод записей в режиме постраничного просмотра;
transfer — копирование записей в директорию transfer.

upgrade#

События обновления Angie ADC.

Синтаксис: upgrade [{follow|page|transfer}].

Параметры:

follow — вывод записей в режиме реального времени;
page — вывод записей в режиме постраничного просмотра;
transfer — копирование записей в директорию transfer.

Фильтрация вывода#

Вывод записей поддерживает фильтрацию через pipe. Допускается использование нескольких фильтров в виде:

command | filter1 | filter2 | ... | filterN

Поддерживаются следующие фильтры:

grep — фильтрация по подстроке;
exclude — исключение строк, содержащих указанную подстроку;
include — вывод только строк, содержащих указанную подстроку;
head — вывод первых N строк;
tail — вывод последних N строк.

grep#

Cинтаксис: grep -i -o -v <pattern>

Параметры:

-i — игнорировать регистр;
-o — показать только совпавшую часть вместо всей строки;
-v — инвертировать результат;
<pattern> — подстрока для поиска.

Пример:

(logs)$$ lb access | grep GET
127.0.0.1 - - [29/Aug/2025:14:34:03 +0300] "GET /metrics HTTP/1.1" 200 1800 "-" "Prometheus/" "-"
(logs)$$ lb access | grep -v GET
2025/08/29 10:19:42 [notice] 976#976: signal 29 (SIGIO) received
(logs)$$ lb access | grep -i get
127.0.0.1 - - [29/Aug/2025:14:34:03 +0300] "GET /metrics HTTP/1.1" 200 1800 "-" "Prometheus/" "-"
(logs)$$ lb access | grep -o GET
GET

include#

Синоним grep <pattern>.

Cинтаксис: include <pattern>.

Параметры:

<pattern> — подстрока для поиска.

Пример:

(logs)$$ lb access | include GET
127.0.0.1 - - [29/Aug/2025:14:34:03 +0300] "GET /metrics HTTP/1.1" 200 1800 "-" "Prometheus/" "-"

exclude#

Синоним grep -v <pattern>.

Cинтаксис: exclude <pattern>.

Параметры:

<pattern> — подстрока для поиска.

Пример:

(logs)$$ lb error | exclude exit
2025/08/29 10:19:42 [notice] 976#976: signal 29 (SIGIO) received

head#

Вывод первых N строк.

Cинтаксис: head <n>.

Параметры:

<n> — количество строк.

Пример:

(logs)$$ lb access | head 2
127.0.0.1 - - [28/Aug/2025:14:53:48 +0300] "GET /metrics HTTP/1.1" 200 1798 "-" "Prometheus/" "-"
127.0.0.1 - - [28/Aug/2025:14:53:58 +0300] "GET /metrics HTTP/1.1" 200 1798 "-" "Prometheus/" "-"

tail#

Вывод последних N строк.

Cинтаксис: tail <n>.

Параметры:

<n> — количество строк.

Пример:

(logs)$$ lb access | tail 2
127.0.0.1 - - [28/Aug/2025:14:53:48 +0300] "GET /metrics HTTP/1.1" 200 1798 "-" "Prometheus/" "-"
127.0.0.1 - - [28/Aug/2025:14:53:58 +0300] "GET /metrics HTTP/1.1" 200 1798 "-" "Prometheus/" "-"

modules#

Контекст modules позволяет просматривать информацию о динамических модулях Angie ADC.

`modules`	Вход в контекст
`list`	Получение списка доступных динамических модулей Angie ADC
`info`	Получение информации о динамическом модуле Angie ADC
`exit` или `Ctrl+Z`	Выход из контекста
`?`	Список доступных команд
`quit` или `Ctrl+Q`	Завершение сессии

list#

Получение списка доступных динамических модулей Angie ADC.

Синтаксис команды: list.

info#

Получение информации о динамическом модуле Angie ADC.

Синтаксис команды: info <module>.

Параметры:

<module> — имя модуля.

settings#

Контекст settings позволяет просматривать и изменять настройки Angie ADC.

Поддерживаемые команды:

`settings`	Вход в контекст
`angie`	Включение режима отладки
`no angie`	Отключение режима отладки
`nf_conntrack`	Управление размером таблицы коннектов
`no nf_conntrack`	Сброс настроек таблицы коннектов
`reload`	Перезагрузка элементов Angie ADC
`exit` или `Ctrl+Z`	Выход из контекста
`?`	Список доступных команд
`quit` или `Ctrl+Q`	Завершение сессии

angie#

Включение режима отладки.

Cинтаксис: angie debug.

no angie#

Отключение режима отладки angie.

Cинтаксис: no angie debug.

nf_conntrack#

Управление размером таблицы коннектов.

Cинтаксис: nf_conntrack max <size>.

Параметры:

<size> — размер таблицы коннектов.

no nf_conntrack#

Сброс настроек таблицы коннектов.

Cинтаксис: no nf_conntrack [max <size>].

reload#

Перезагрузка элементов Angie ADC.

Cинтаксис: reload {angie|prometheus}.

Параметры:

angie — перезагрузка angie-mgmt;
prometheus — перезагрузка prometheus.

system#

Контекст system для управления системой Angie ADC.

Поддерживаемые команды:

`system`	Вход в контекст
`reboot`	Перезагрузка системы Angie ADC
`stat`	Просмотр статистики системы Angie ADC
`upgrade`	Обновление Angie ADC
`version`	Просмотр версии Angie ADC
`exit` или `Ctrl+Z`	Выход из контекста
`?`	Список доступных команд
`quit` или `Ctrl+Q`	Завершение сессии

reboot#

Перезагрузка системы Angie ADC.

Синтаксис: reboot [force]

Параметры:

force — принудительная перезагрузка.

stat#

Просмотр статистики системы Angie ADC.

Синтаксис: stat [count <n>] [delay <m>]

Параметры:

count <n> — количество обновлений статистики;
delay <m> — задержка между обновлениями статистики в секундах.

upgrade#

Обновление Angie ADC.

Синтаксис: upgrade <filename>

Параметры:

<filename> — путь к файлу с обновлением.

version#

Просмотр версии Angie ADC.

Синтаксис: version [detail]

Параметры:

detail — подробный вывод версии.

transfer#

Контекст transfer для работы с директорией transfer.

Поддерживаемые команды:

`transfer`	Вход в контекст
`ls`	Получение списка файлов в директории `transfer`
`rm`	Удаление файла в директории `transfer`
`view`	Просмотр содержимого файла в директории `transfer`
`exit` или `Ctrl+Z`	Выход из контекста
`?`	Список доступных команд
`quit` или `Ctrl+Q`	Завершение сессии

ls#

Получение списка файлов в директории transfer.

Синтаксис: ls.

rm#

Удаление файла в директории transfer. Синтаксис: rm <filename>.

Параметры:

<filename> — имя файла.

view#

Просмотр содержимого файла в директории transfer.

Синтаксис: view <filename> [page].

Параметры:

<filename> — имя файла;
page — вывод записей в режиме постраничного просмотра.

ping#

Выполнение команды ping.

Синтаксис: ping [-c <count>] [-n] <hostname>

Параметры:

-c <count> — количество пакетов (по умолчанию бесконечно);
-n — не резолвить имя хоста;
<hostname> — имя хоста или IP-адрес.

pingc#

Выполнение команды ping в cisco-style.

Синтаксис: pingc {ip|ip6} <hostname> [count <n>]

Параметры:

ip — выполнение пинга через ipv4;
ip6 — выполнение пинга через ipv6;
<hostname> — имя хоста или IP-адрес;
count <n> — количество пакетов (по умолчанию 4).

ip#

Выполнение команды ip.

vtysh#

Выполнение команды vtysh.

show#

Выполнение команды show.