Перейти к содержимому

19 сентября 2026

Почему агент не принимает shell-команд

Одно решение определило в Maran всё остальное: корневой демон принимает типизированные операции, а не shell-строки. Рассказываем, чего оно стоит.

Любая панель управления устроена одинаково: есть то, на что нажимает человек, и то, что с правами root выполняет работу. Главный вопрос в том, что передаётся между ними.

Обычно это командная строка. Её проще всего собрать и тяжелее всего уберечь, потому что каждое значение, которое задаёт клиент (домен, имя базы, путь к файлу), в итоге попадает в строку, которую разбирает оболочка. Один раз сделать это правильно несложно. Но делать правильно везде и всегда, пока панель растёт, не получается ни у кого.

Что мы делаем вместо этого

Корневой демон Maran принимает только именованные операции с типизированными и проверенными аргументами. Операции, которая принимала бы команду для запуска, нет. Домен не экранируется перед записью в конфигурационный файл, а проверяется как домен: буквы, цифры, дефисы и точки. Поэтому в нём не может оказаться перевода строки, которым закончилась бы одна директива и началась другая.

На практике это значит, что всё, что можно заставить демон сделать, перечислено в контракте и доступно для ревью. Запросить операцию, которой в контракте нет, невозможно, как бы изобретательно ни была составлена просьба.

Чего это стоит

Каждая новая возможность требует изменения контракта, а не добавления строки. Это медленнее, и так задумано: чтобы добавить операцию, нужно решить, какие у неё аргументы, что считать допустимым и как поступать, если хост не согласен. Всё это решается до того, как что-либо будет выпущено.

Из-за этого панель не может предложить целый класс возможностей вроде «выполни за меня вот эту команду». Мы считаем такую цену оправданной для софта, который держит root на сервере с чужими клиентами.