Урк 2т согласователь: Устройство ротации УРК-2Т

Войти

Все сервисы становятся доступными без ограничений

Сможете пользоваться сервисом Festima.Ru на разных устройствах.

Это удобно и бесплатно

назначение, необходимость, характеристики. Особенности работы блока ротации кондиционеров

Содержание

• 1 Назначение и функциональные особенности
  • 1. 1 Для чего предназначен блок ротации кондиционеров
  • 1.2 Как подключается блок ротации на предприятиях.
  • 1.3 Классификация по типу управления кондиционерами
    • 1.3.1 Проводные устройства согласования
  • 1.4 Функция управления по инфракрасному каналу
  • 1.5 Функция управления включением питания
  • 1.6 Технические характеристики модуля ротации для кондиционера
  • 1.7 Показатели температуры воздуха в серверной
  • 1.8 Виды резервирования
  • 1.9 Схемы резервирования кондиционеров
  • 1.10 Принцип работы блока ротации
  • 1.11 Сравнение устройств ротации
• 2 Особенности эксплуатации и подключения модуля ротации УРК-2
• 3 Дистанционное управление и мониторинг
  • 3.1 GSM управление
  • 3.2 Сопряжение с компьютером
  • 3.3 Мониторинг и управление через сервер
• 4 Правила ухода за оборудованием

Назначение и функциональные особенности

Основной функцией модуля ротации является чередование работы кондиционеров в заданном интервале времени, путем регулирования подачи напряжения на все устройства охлаждения.

• Попеременного переключения климатической техники, частота которой устанавливается пользователем.
• Переключение с неисправного кондиционера на резервный. При этом в локальную сеть оповещения предприятия передается код неисправности.
• Возможность контроля за температурой в серверной, за счет собственного датчика, а в случае ее повышения, подключение дополнительной климатической техники.
• Отключение всего охлаждающего оборудования в случае непредусмотренной или аварийной ситуации, с выдачей во внешнюю сеть сигнала «Авария».

Следует учесть, что блоки ротации УРК-2 и УРК-2Т являются наиболее простыми устройствами чередования двух групп бытовой климатической техники, полупромышленных кондиционеров или испарительных блоков мультисистем. Использование таких модулей позволяет систему охлаждения интегрировать с охранной или пожарной сигнализацией, что дает возможность оперативно отреагировать на взлом и возгорание в помещении с дорогостоящим оборудованием.

Для чего предназначен блок ротации кондиционеров

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

Несколько сплит-систем будут работать по очереди регулируемые устройством ротации кондиционеров. Этот прибор будет обеспечивать последовательность их работы с включением и выключением кондиционеров в нужном режиме.

Согласователь деятельности кондиционеров отменяет необходимость присутствия человека на стадии управления. Такое устройство сможет включать и выключать кондиционеры по мере надобности через равные временные отрезки. Сам механизм обеспечивается изменением параметров по подаче напряжения. Такой принцип работы предотвращает преждевременный износ оборудования и распределяет нагрузку равномерно.

Рассмотрим, для чего же предназначена система ротации климатической техники.

1. 1. Напряжение переключается с вышедшего из строя аппарата на агрегат находящийся в резерве.
2. 2. Поочередное подключение обоих охлаждающих модулей сохранит и поддержит нужный температурный режим в серверном помещении.
3. 3. Если случилось отключение электроэнергии в данном районе, то при ее возобновлении все группы кондиционеров будут перезапущены.
4. 4. Становится невозможным незапланированное отключение этого оборудования с использованием пульта или же изменение режимов работы кондиционера.
5. 5. Осуществляется контроль при ситуации включения двух или более систем при очень жаркой погоде.
6. 6. Если в случае аномальной внешней температуры, повышается норматив в помещении, следует последовательное включение дополнительных мощностей. Это становится возможным за счет датчиков обследующих температурный режим.

Благодаря последнему пункту при аномальной ситуации можно резко понизить повышенное тепло в серверной.

Какова структура согласователя для кондиционеров? Основными элементами такой системы будут встроенный программируемый микропроцессор и различные датчики, предназначенные для сбора информации.

Основной датчик связан с изменением температурной среды и действует в границах от пятидесяти градусов мороза до ста двадцати градусов тепла. Процесс подключения кондиционеров осуществляется через специальные адаптеры. Режим регулируется с помощью таймера. Периодичность подключений возможна в диапазоне от одного часа до десяти суток.

Тестовый режим работы предполагает использование всех подключенных систем одновременно.

Отличия, которые закладывают производители, несущественные и в основном касаются способов подключения климатического оборудования.

Как подключается блок ротации на предприятиях.

Как известно на предприятиях работает промышленное оборудование. Оно по своим техническим характеристикам значительно сильнее бытовых аналогов. При этом увеличивается производительность кондиционеров, длина магистралей и границы температур в которых может оперировать данный агрегат.

При подключении блока ротации, нужно помнить о наличии в его программе функции, перезапускающей все системы после аварийного отключения.

Если в помещении расположены два кондиционера, то существует несколько способов их подключения:

• с помощью провода;
• по инфракрасному каналу;
• с применением сухих контактов.

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

Сама ротационная система обязательно оснащается датчиками, которые фиксируют различные критерии работы. После нормализации температуры в помещении или достижения приемлемых показателей ротационная система дает команду на отключение охлаждающего оборудования.

Часто можно встретиться с ситуацией, когда вместо промышленных аппаратов, владельцы офиса монтируют обычные – бытовые кондиционера. На первых порах, такая экономия дает свои плоды. Но, нагрузка на обычные кондиционеры приводит к частым поломкам и нарушению температурного режима. А при этом уже страдает дорогостоящее оборудование из серверной комнаты.

Использование блока ротации поможет и в этой ситуации. В принципе согласователь работы может одновременно управлять пятнадцатью единицами оборудования.

После того как произошло подключение кондиционеров и устройств ротации можно запускать системы по одному из трех вариантов.

1. 1. Подключаются все информаторы из наборов кондиционеров, плюс комнатный датчик, отвечающий за температуру. В этой ситуации блок ротации полностью контролирует процесс и работает в нормальном режиме. Стандартное переключение осуществляется через восемь часов. При этом второй аппарат, выполняющий функции резервного, включится и в экстремальных случаях. Например, внезапное отключение первого кондиционера или при резком повышении температурных показателей.

Блок управления ротацией

1. 2. Подключено все оборудование кроме датчика в комнате. Работа в обычном режиме и восьмичасовое переключение. На экстремальные ситуации реакции нет.
2. 3. Работает только датчик температуры в помещении. Такая ситуация подразумевает несколько сценариев основанных на качественных характеристиках данной модели и программ заданных производителем.

Классификация по типу управления кондиционерами

Разберем самые популярные способы управления двумя или более кондиционерами с ротационной системой.

• Управление осуществляется по инфракрасному каналу. Самое доступное и популярное подключение. Его особенности рассмотрим в отдельном пункте.
• Процесс управления, который происходит с включением питания. Такой механизм подразумевает отдельного пояснения ниже.
• Проводное устройство согласования. Такие приборы соединяют с ротационным блоком и кондиционером при помощи витой пары.
• Дистанционный вариант управления. Подразумевает использование:
• компьютера;
• сервера;
• встроенного контроллера.
• Управление с помощью GSM. При возникновении нештатной ситуации аварийный сигнал подается на запрограммированный номер телефона при помощи смс-сообщения.
• Компьютерное управление подразумевает связь через интернет с функциями управления.
• Через сервер. Нужный контроллер мониторит все показатели и производит необходимое управление.

Проводные устройства согласования

Такие согласователи соединяются витой парой с базовым блоком и с платой кондиционера (обычно к выводам пульта управления)

Для кондиционеров Daikin -KRP4A51 — KRP4A54, KRP413, для Mitsubishi Electric — MMAC-397-IF

Функция управления по инфракрасному каналу

Такие устройства имеют свой собственный модуль, подключенный к согласователю работы. Такой модуль устанавливается на кондиционере и получает от него электропитание. С ротационным устройством происходит связь по инфракрасному каналу. Нет нужды прокладывать кабели. Может регулировать до пятнадцати систем одновременно.

Проанализируем достоинства.

1. 1. Возможность осуществлять охлаждение с использованием пятнадцати систем, что приведет к снижению износа техники и почти исключит вероятность нештатной ситуации при таких резервах.
2. 2. Экономия средств на прокладке кабелей.
3. 3. Не нужна функция перезапуска.
4. 4. Система характеризуется повышенной надежностью.
5. 5. Базу можно разместить в соседней комнате, а настройка на удивление проста.

Функция управления включением питания

Такие блоки самые экономичные в плане финансов и простые в обслуживании. Процесс управления осуществляется подачей напряжения на выбранный кондиционер. Или его выключением в нужный момент.

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

Главное стоит запомнить, что без применения ротационных систем можно потерять не только кондиционеры, а гораздо больше – дорогое оборудование серверного помещения. Действительно – скупой платит дважды.

Технические характеристики модуля ротации для кондиционера

При помощи радиосигнала из базового модуля на устройство (блок ротации) подается сигнал о прекращении работы. Подобные команды действуют вопреки первоначальным настройкам всей системы. Радиус действия сигнала достигает пятидесяти метров, что удобно для дистанционного управления охладительной системой серверной. Основным преимуществом модуля ротации является его многозадачность, ведь к одному простому блоку подключается сразу несколько габаритных, сложных в эксплуатации кондиционеров. Запуск резервных устройств, сели возникла подобная необходимость, происходит мгновенно, без заминок и промедлений (они могут стоять владельцу помещения драгоценного оборудования).

Модуль ротации – универсальное устройство, способное скрыть недостатки климатической техники. В условиях неправильной работы кондиционера, при помощи блока, регулируется переключение режимов.

Для кондиционеров, установленных в помещениях, где поток поступающих данных нуждается в создании отдельной серверной комнаты, распределение нагрузки является первоначальной задачей. Для чего нужен модуль ротации? Устройство с простыми настройками и определенным принципом работы, гарантирует корректную работу охладителей при любых сменах температуры. В жаркую или холодную пору года модули сбалансируют климат внутри технического помещения – серверной комнаты.

Показатели температуры воздуха в серверной

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

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

К температурному режиму в серверной комнате предъявляются строгие требования, выполнение которых возможно только при наличии двух и более кондиционеров

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

По рекомендации Американского общества инженеров по отоплению, холодильному оборудованию и кондиционированию воздуха (ASHRAE), температура в серверных должна быть в пределах от 18 °С до 27 °С. Большинство специализированных компаний, к примеру, предоставляющих услуги хостинга, не допускают повышения температуры воздуха выше 24 °С.

Повышение температуры даже на короткое время способно вызвать сбой в работе серверного оборудования, а для устранения аварии потребуется замена дорогостоящих комплектующих

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

Современный сервер оснащен внутренней системой отвода тепла. Охлаждаются всех внутренние компоненты, выделяющие тепло во время своего функционирования. Но невозможно полностью избежать теплообмена вследствие негерметичности корпуса. Несмотря на радиаторы и даже жидкостное охлаждение, температура внутри корпуса будет близка к температуре окружающей среды.

Наиболее чувствительны к климатическим условиям эксплуатации следующие компоненты:

• центральный процессор;
• жесткий диск;
• оперативная память.

При повышении температуры, происходит расширение материалов, из которых изготовлены компоненты жесткого диска. Это приводит к выходу из строя магнитных дисков, головок, системы позиционирования. Проблемы с жестким диском чреваты потерей важной информации.

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

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

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

Не стоит рассчитывать, что если наружная (уличная) температура находится в приемлемом диапазоне, можно отказаться от охлаждения воздуха в серверном помещении. Необходимо учитывать все показатели тепловыделения и притоки тепла. Так, тепловая мощность серверов составляет 80-90% от потребленной электрической мощности и зачастую превышает 1 кВт.

Итак, использование дорогостоящего и важного для решения бизнес-задач оборудования, чувствительного к повышению и колебаниям температуры, требует правильно организованного кондиционирования, в котором каждая сплит-система должна работать бесперебойно.

Виды резервирования

Холодное резервирование

При данном виде резервирования только часть кондиционеров находится в работе. Остальные блоки сплит-системы включаются в работу вручную например, при авариях. Отключение других устройств также выполняется в ручном режиме. Основные преимущества такой системы – простота эксплуатации и невысокая стоимость обслуживания.

Горячее резервирование

При данном виде резервирования: ввод в работу резервных блоков осуществляется автоматически, они находятся в дежурном режиме, получая сигналы задания и датчиков.

Такая работа блоков системы сокращает выход резерва на рабочий уровень до времени пуска агрегатов кондиционера (компрессора и вентиляторов). На это время недостаток производительности вышедших из строя или выведенных на профилактику блоков легко компенсируется рабочими

Схемы резервирования кондиционеров

Возможна реализация различных схем резервирования, которые условно обозначаются, как N+1 и 2N, где N – количество кондиционеров, выполняющих аналогичную функцию в системе (от английского «Need» – «Необходимость»).

Самая простая схема, подразумевающая использование всего одного резервного кондиционера, – N+1. Если не настроена система ротации, резервный кондиционер включается только в аварийных случаях и берет на себя всю нагрузку.

В системе может быть несколько основных рабочих кондиционеров и у каждого из них – резервный кондиционер, что обозначается, как 2N и означает 100% резервирование. Понятно, что чем больше резервных кондиционеров, тем выше отказоустойчивость системы.

Принцип работы блока ротации

В процессе работы с БУРР-1 посредством радиосигналов на частоте 433 МГц передаются команды на исполнительные блоки, которые включают и выключают кондиционеры с помощью инфракрасных излучателей, в соответствии с установленными настройками. Кондиционеры должны быть оснащены фотоприемниками. Этому требованию отвечает большинство современных моделей, в том числе бытового назначения.

Исполняющий блок БИС-1М устанавливается обычно на стене непосредственно над кондиционером, в процессе эксплуатации принимает радиосигналы от управляющего блока и передает команды на включение и выключение кондиционера по ИК-каналу

Осуществляется непрерывный мониторинг термодатчиков. Путем сопоставления полученных данных определяется состояние каждого кондиционера. Если кондиционер включен, а датчик, установленный на его жалюзи, показывает, что на выходе изменение температуры менее 2 С, включаются резервные мощности и подается сигнал об аварии.

Сравнение устройств ротации

Особенности эксплуатации и подключения модуля ротации УРК-2

На этом приборе реализован вход для подключения дополнительного температурного датчика. При повышении температуры в помещении выше порога установленного для датчика, происходит кратковременный ввод в действие всех работающих устройств кондиционирования. Такое совместное охлаждение воздуха, в течение 5 минут способно понизить температуру в помещении. Если этого не происходит, то в локальную сеть оповещения предприятия посылается сигнал «Авария».

Важно!
Для использования модуля УРК-2, климатические устройства должны быть оснащены функцией автоматического рестарта.

Дистанционное управление и мониторинг

Для осуществления мониторинга существует несколько способов:

• сопряжение с компьютером
• сопряжение с сервером
• GSM-контроллер (встроенный, или дополнительный)

GSM управление

На объекте авария — сломался кондиционер, температура повышается.

На запрограммированный телефон после превышения заданного порога  отправится СМС .

Или наоборот, отправив сообщение на нужный номер можно включить кондиционер.

Такой контроль позволяет осуществить GSM-контроллер, встроенный есть в моделях ротаторов ССМ-33 (34).

Возможности такого управления и мониторинга довольно ограничены, но для выполнения определённых задач вполне подходят.

Сопряжение с компьютером

Контроллеры СРК-М, СРК-D осуществляют связь с компьютером по архаичному COM-порту, либо Ethernet.

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

Если в компьютере нет COM-порта предлагается подключаться через переходник USB/RS-232.

Мониторинг и управление через сервер

Такую возможность предоставляет контроллер SBR01 позволяет считывать все параметры и управлять в режиме онлайн через свой сервер.

Вся история с момента установки записывается и сохраняется также на сервере производителя:

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

Правила ухода за оборудованием

Чтобы обеспечить нормальную работу и долгий срок службы, регулярно выполняют техническое обслуживание управляющих и исполнительных блоков. Раз в 3-4 месяца проверяется надежность крепления, качество соединений, исправность разъемов. Клеммники и внешние поверхности корпусов по мере загрязнения необходимо очищать от пыли, не допуская попадания на них мусора и посторонних предметов.

Источники

• http://ventilationpro.ru/konditsionirovanie/dlya-chego-ispolzuetsya-blok-rotacii-kondicionerov.html
• https://oventilyacii.ru/ventilyaciya/kondicionirovanie/soglasovatel-raboty-konditsionerov.html
• https://MasterXoloda.ru/kondicionirovanie-servernoy/upravlenie-rotaciej-kondicionerov
• https://oboiman.ru/ingeneer/blok-rotacii-kondicionerov-ustrojstvo-pravila-podklucenia-i-nastrojki-modula.html
• https://sovet-ingenera.com/vent/cond/blok-rotatsii-konditsionerov-ustroystvo-pravila-podklyucheniya-i-nastroyki-modulya. html
• https://moskva-ustanovka-kondicionera.ru/ustanovka-bloka-rotacii/

[свернуть]

Поделиться:

• Предыдущая записьКак правильно подключить кондиционер к электросети
• Следующая записьОптимальная комнатная температура в разных помещениях: комфортный для человека режим

×

Рекомендуем посмотреть

Политика конфиденциальности

Adblock
detector

Сопоставители запросов (Caddyfile) — Caddy Documentation

Сопоставители запросов могут использоваться для фильтрации (или классификации) запросов по различным критериям.

• Синтаксис
  • Примеры
  • Сопоставители подстановочных знаков
  • Сопоставители пути
  • Именованные сопоставления
• Стандартные сопоставители
  • выражение
  • файл
  • заголовок
  • header_regexp
  • хост
  • метод
  • не
  • путь
  • path_regexp
  • протокол
  • запрос
  • удаленный_ip
  • вар
  • vars_regexp

Синтаксис

В Caddyfile токен соответствия сразу после директивы может ограничить область действия этой директивы. Токен сопоставления может быть одной из следующих форм:

1. * для соответствия всем запросам (шаблон; по умолчанию).
2. /путь начинайте с косой черты, чтобы соответствовать пути запроса.
3. @name чтобы указать именованный сопоставитель .

Жетоны Matcher обычно необязательны. Если токен сопоставителя опущен, он аналогичен сопоставителю с подстановочными знаками ( * ).

Примеры

Эта директива применяется ко всем HTTP-запросам:

 реверс_прокси локальный: 9000
 

А это то же самое (* здесь лишнее):

 обратный_прокси * локальный: 9000
 

Но эта директива применяется только к запросам, путь которых начинается с /api/ :

 reverse_proxy /api/* локальный хост: 9000
 

Чтобы сопоставить что-либо, кроме пути, определите именованный сопоставитель и обратитесь к нему, используя @name :

 @postfoo {
метод POST
путь /foo/*
}
reverse_proxy @postfoo локальный хост: 9000
 

Сопоставители подстановочных знаков

Подстановочный (или универсальный) сопоставитель * соответствует всем запросам и требуется только в том случае, если требуется токен сопоставителя. Например, если первый аргумент, который вы хотите передать директиве, также является путем, он будет выглядеть точно так же, как средство сопоставления путей! Таким образом, вы можете использовать сопоставитель подстановочных знаков для устранения неоднозначности, например:

 корень * /home/www/mysite
 

В остальном этот сопоставитель используется нечасто. Обычно мы рекомендуем опускать его, если синтаксис не требует этого.

Сопоставители пути

Сопоставление по пути URI является наиболее распространенным способом сопоставления запросов, поэтому сопоставитель может быть встроен, например:

 перенаправить /old.html /new.html
 

Токены сопоставления путей должны начинаться с косой черты / .

Сопоставление путей по умолчанию является точным совпадением, а не совпадением префикса. Вы должны добавить * для быстрого совпадения префикса. Обратите внимание, что /foo* будет соответствовать /foo и /foo/ , а также /foobar ; вместо этого вам может понадобиться /foo/* .

Именованные сопоставления

Все сопоставители, не являющиеся сопоставителями путей или подстановочных знаков, должны быть названы сопоставителями. Это сопоставитель, который определен вне какой-либо конкретной директивы и может использоваться повторно.

Определение сопоставления с уникальным именем обеспечивает большую гибкость, позволяя объединять любые доступные сопоставления в набор:

 @имя {
...
}
 

или, если в наборе только один матчер, можно поставить его в одну строку:

 @имя ...
 

Затем вы можете использовать сопоставитель следующим образом: @name

Например:

 @вебсокеты {
Заголовок Подключение *Обновление*
заголовок Обновление веб-сокета
}
reverse_proxy @websockets локальный хост: 6001
 

Проксирует только те запросы, в которых поле заголовка «Connection» содержит слово «Upgrade», а другое поле «Upgrade» имеет значение «websocket».

Если набор сопоставителей состоит только из одного сопоставителя, также работает однострочный синтаксис:

 метод @post POST
reverse_proxy @post localhost:6001
 

В качестве особого случая, сопоставитель выражения может использоваться без указания его имени, если за именем сопоставителя следует один аргумент в кавычках (само выражение CEL):

 @notFound `{err. status_code} == 404`
 

Как и директивы, определения именованных сопоставлений должны находиться внутри блоков сайта, которые их используют.

Определение именованного сопоставителя составляет набор сопоставителей . Сопоставители в наборе объединяются по И; то есть все должно совпадать. Например, если в наборе есть сопоставитель заголовка и пути , оба должны совпадать.

Несколько сопоставителей одного типа могут быть объединены (например, несколько сопоставителей пути в одном наборе) с использованием булевой алгебры (И/ИЛИ), как описано в соответствующих разделах ниже.

Стандартные сопоставители

Полную документацию по сопоставителю можно найти в документации каждого соответствующего модуля сопоставителя.

Запросы могут быть сопоставлены следующими способами:

выражение

 выражение 
 

Любым выражением CEL (Common Expression Language), которое возвращает true или false .

Заполнители Caddy (или сокращения Caddyfile) могут использоваться в этих выражениях CEL, поскольку они предварительно обрабатываются и преобразуются в обычные вызовы функций CEL перед интерпретацией средой CEL.

Начиная с версии 2.5.2, большинство других сопоставителей запросов также можно использовать в выражениях как функции, что обеспечивает большую гибкость для логической логики, чем внешние выражения. См. документацию для каждого сопоставителя для поддерживаемого синтаксиса в выражениях CEL.

Для удобства имя сопоставителя может быть опущено при определении именованного сопоставителя, состоящего исключительно из CEL-выражения. Это читается довольно красиво:

 @mutable `{метод}.startsWith("P")`
 

В этом случае предполагается наличие CEL-сопоставителя.

Примеры:

Соответствие запросам, методы которых начинаются с P , например. PUT или POST :

 выражение {метод}. startsWith("P")
 

Соответствие запросам, где обработчик возвратил код ошибки 9/(\ш*)’)

файл

 файл {
корень <путь>
try_files <файлы...>
try_policy first_exist|наименьший_размер|наибольший_размер|самый_последний_модифицированный
split_path <разделители...>
}
файл <файлы...>
выражение `файл({
'корень': '<путь>',
'try_files': ['<файлы...>'],
'try_policy': 'first_exist|наименьший_размер|наибольший_размер|самый_последний_модифицированный',
'split_path': ['<разделители...>']
})`
файл выражения('<файлы...>')
 

По файлам.

• root определяет каталог, в котором нужно искать файлы. По умолчанию используется текущий рабочий каталог или переменная root ( {http.vars.root} ), если она установлена ​​(можно установить с помощью директивы root ).

• try_files проверяет файлы в своем списке, которые соответствуют try_policy.

  Для сопоставления каталогов добавьте косую черту / в конце пути. Все пути к файлам указаны относительно корня сайта, а шаблоны глобусов будут расширены.

  Если try_policy равно first_exist (по умолчанию), то последним элементом в списке может быть число с префиксом = (например, =404 ), что в качестве запасного варианта выдаст ошибку с этим код; ошибка может быть обнаружена и обработана с помощью handle_errors .

• try_policy указывает, как выбрать файл. По умолчанию first_exist .

  • first_exist проверяет наличие файла. Выбирается первый существующий файл.

  • наименьший_размер выбирает файл с наименьшим размером.

  • самый большой размер выбирает файл с наибольшим размером.

  • most_recent_modified выбирает файл, который был изменен последним.

• split_path приведет к разделению пути по первому разделителю в списке, который находится в каждом пути к файлу, который нужно попробовать. Для каждого значения разделения левая сторона разделения, включая сам разделитель, будет пробным путем к файлу. Например, /remote.php/dav/ с использованием разделителя .php попробует файл /remote.php . Каждый разделитель должен появиться в конце компонента пути URI, чтобы его можно было использовать в качестве разделительного разделителя. Это нишевая настройка, которая в основном используется при обслуживании PHP-сайтов.

Поскольку try_files с политикой first_exist настолько распространены, для этого существует однострочный ярлык:

 файл <файлы...>
 

Пустой файл сопоставитель (тот, у которого нет файлов, перечисленных после него) увидит, существует ли запрошенный файл — дословно из URI относительно корня сайта. Фактически это то же самое, что и file {path} .

Поскольку перезапись, основанная на существовании файла на диске, очень распространена, существует также директива try_files , которая является ярлыком сопоставления файлов и обработчика перезаписи .

После сопоставления будут доступны четыре новых заполнителя:

• {file_match.relative} Путь к файлу относительно корня. Это часто бывает полезно при переписывании запросов.
• {file_match.absolute} Абсолютный путь к соответствующему файлу, включая корень.
• {file_match.type} Тип файла, файл или каталог .
• {file_match.remainder} Часть, оставшаяся после разделения пути к файлу (если настроено split_path )

Примеры:

Запросы соответствия, где путь является существующим файлом:

 файл
 

Сопоставление запросов, в которых путь, за которым следует .html , является существующим файлом, или, если нет, где путь является существующим файлом:

 файл {
try_files {путь}.html {путь}
}
 

То же, что и выше, за исключением использования однострочного ярлыка и возврата к выдаче ошибки 404, если файл не найден:

 файл {путь}. html {путь} = 404
 

 заголовок <поле> [<значение>]
заголовок выражения ({'<поле>': '<значение>'})
 

По полям заголовка запроса.

• <поле> — имя поля заголовка HTTP для проверки.
  • Если префикс ! , поле не должно существовать для соответствия (опустить значение arg).
• <значение> — значение, которое должно совпадать с полем.
  • Если используется префикс * , выполняется быстрое сопоставление суффикса.
  • Если с суффиксом * , выполняется быстрое сопоставление префикса.
  • Если он заключен в * , выполняется быстрое сопоставление подстроки.
  • В противном случае это быстрое точное совпадение.

Различные поля заголовков в одном наборе объединяются по И. Несколько значений в поле объединяются по ИЛИ.

Обратите внимание, что поля заголовков могут повторяться и иметь разные значения. Бэкэнд-приложения ДОЛЖНЫ учитывать, что значения полей заголовка являются массивами, а не единичными значениями, и Caddy не интерпретирует смысл в таких затруднениях.

Пример:

Запросы на сопоставление с заголовком Connection , содержащим Upgrade :

 *Обновление*
 

Запросы на сопоставление с заголовком Foo , содержащим bar ИЛИ baz :

 @foo {
заголовок Foo бар
заголовок Foo baz
}
 

Запросы на совпадение, которые вообще не имеют поля заголовка Foo :

 заголовок @not_foo !Foo
 

 header_regexp []  
выражение header_regexp('<имя>', '<поле>', '')
выражение header_regexp('<поле>', '')
 

Аналогично заголовку , но поддерживает регулярные выражения. Доступ к группам захвата можно получить с помощью заполнителя, такого как {re.name.capture_group} , где имя — это имя регулярного выражения (необязательно, но рекомендуется), а группа захвата — это либо имя, либо номер группы захвата в выражение. Группа захвата 0 — это полное соответствие регулярному выражению, 1 — первая группа захвата, 2 — вторая группа захвата и так далее.

Используемый язык регулярных выражений — RE2, включенный в Go. См. справочник по синтаксису RE2 и обзор синтаксиса регулярных выражений Go.

Для каждого поля заголовка поддерживается только одно регулярное выражение. Несколько разных полей будут объединены по И.

Пример:

Запросы соответствия, в которых заголовок Cookie содержит login_ , за которым следует шестнадцатеричная строка, с группой захвата, доступ к которой можно получить с помощью {re.login.1} .

 header_regexp логин Cookie login_([a-f0-9]+)
 

хост

 хост <хост...>
выражение host('')
 

Соответствует запросу по полю заголовка Host запроса. Это не принято использовать в Caddyfile, так как большинство блоков сайтов уже указывают хосты в адресе сайта. Этот сопоставитель в основном используется в блоках сайта, которые не определяют конкретные имена хостов (например, субдомены с подстановочными знаками), но где требуется логика, специфичная для имени хоста.

Несколько сопоставителей host будут объединены по ИЛИ.

Пример:

 хост sub.example.com
 

метод

 метод <глаголы...>
метод выражения('<глаголы...>')
 

По методу (глаголу) HTTP-запроса. Глаголы должны быть в верхнем регистре, например POST . Может соответствовать одному или нескольким методам.

Несколько сопоставителей метода будут объединены по ИЛИ.

Примеры:

Запросы соответствия с методом GET :

 метод ПОЛУЧИТЬ
 

Запросы соответствия с ПОСТАВИТЬ или УДАЛИТЬ методы:

 метод PUT DELETE
 

не

 не <любой другой сопоставитель>
 

или, чтобы отменить несколько сопоставлений, которые объединяются по И, откройте блок:

 не {
<любые другие сопоставители. ..>
}
 

Результаты вложенных сопоставителей будут инвертированы.

Примеры:

Сопоставлять запросы с путями, которые НЕ начинаются с /css/ ИЛИ /js/ .

 не путь /css/* /js/*
 

Запросы соответствия НИ ОДНОМУ:

• и префикс пути /api/ , NOR
• метод запроса POST

т.е. не должно быть ни одного из этих совпадений:

 не путь /api/*
не метод POST
 

Запросы соответствия БЕЗ ОБА:

• префикс пути /api/ И
• метод запроса POST

т.е. не должно быть ни одного, ни одного из этих совпадений:

 не {
путь /апи/*
метод POST
}
 

путь

 путь <пути...>
путь выражения('<пути...>')
 

По пути запроса (компонент пути URI запроса). Совпадения путей являются точными, но нечувствительны к регистру. Можно использовать подстановочные знаки * :

• Только в конце, для совпадения префикса ( /prefix/* )
• Только в начале, для совпадения суффикса ( *. suffix )
• Только с обеих сторон, для совпадения подстроки ( */contains/* )
• Только посередине, для шарового совпадения ( /accounts/*/info )

Косые черты имеют значение. Например, /foo* будет соответствовать /foo , /foobar , /foo/ и /foo/bar , но /foo/* будет соответствовать 6o /foo/*1 , а не 01 . или /foobar .

Пути запросов очищаются для разрешения точек обхода каталога перед сопоставлением. Кроме того, несколько косых черт объединяются, если шаблон соответствия не содержит несколько косых черт. Другими словами, /foo будет соответствовать /foo и //foo , но //foo будет соответствовать только //foo .

Поскольку существует несколько экранированных форм любого заданного URI, путь запроса нормализован (URL-декодированный, без экранирования), за исключением тех escape-последовательностей в позициях, где escape-последовательности также присутствуют в шаблоне соответствия. Например, /foo/bar соответствует как /foo/bar , так и /foo%2Fbar , но /foo%2Fbar будет соответствовать только /foo%2Fbar , потому что управляющая последовательность явно задана в конфигурации.

Специальный escape-символ %* также можно использовать вместо * , чтобы оставить соответствующий диапазон скрытым. Например, /bands/*/* не будет соответствовать /bands/AC%2FDC/T.N.T , потому что путь будет сравниваться в нормализованном пространстве, где он выглядит как /bands/AC/DC/T.N.T , что не соответствует не соответствовать рисунку; однако /bands/%*/* будет соответствовать /bands/AC%2FDC/T.N.T , поскольку диапазон, представленный %* , будет сравниваться без декодирования управляющих последовательностей.

Несколько путей будут объединены по ИЛИ.

path_regexp

 path_regexp [<имя>] 
выражение path_regexp('<имя>', '')
выражение path_regexp('')
 

Как путь , но поддерживает регулярные выражения. Запишите шаблон в декодированной/неэкранированной форме пути URI.

Используемый язык регулярных выражений — RE2, включенный в Go. См. справочник по синтаксису RE2 и обзор синтаксиса регулярных выражений Go.

Доступ к группам захвата можно получить с помощью заполнителя, такого как {re.name.capture_group} , где имя — это имя регулярного выражения (необязательно, но рекомендуется), а группа захвата — это либо имя, либо номер группы захвата в выражение. Группа захвата 0 — полное соответствие регулярному выражению, 1 — первая группа захвата, 2 — вторая группа захвата и так далее.

Для каждого именованного сопоставителя может быть только один шаблон path_regexp .

Пример:

Соответствие запросам, в которых путь заканчивается шестнадцатеричной строкой из 6 символов, за которой следует .css или .js в качестве расширения файла, с группами захвата, к которым можно получить доступ с помощью {re. static.1} и {re. static.2} для каждой части, заключенной в ( ) , соответственно:

 path_regexp статическое \.([a-f0-9]{6})\.(css|js)$
 

протокол

 http|https|grpc|http/<версия>[+]
протокол выражений('http|https|grpc')
 

 запрос =...
запрос выражения ({'': ''})
выражение запроса({'': ['']})
 

Сопоставление запросов с параметром запроса sort со значением asc :

 запрос sort=asc
 

удаленный_ip

 remote_ip [переадресовано] <диапазоны. ..>
выражение remote_ip('<диапазоны...>')
выражение remote_ip('forwarded', '<диапазоны...>')
 

По удаленному (клиентскому) IP-адресу. Принимает точные IP-адреса или диапазоны CIDR. Если первый аргумент forwarded , то первый IP-адрес в X-Forwarded-For 9Заголовок запроса 0062, если он присутствует, будет предпочтительнее в качестве эталонного IP-адреса, а не IP-адреса непосредственного партнера, который используется по умолчанию. Поддерживаются зоны IPv6.

В качестве ярлыка private_ranges можно использовать для сопоставления всех частных диапазонов IPv4 и IPv6. Это то же самое, что указать все эти диапазоны: 192.168.0.0/16 172.16.0.0/12 10.0.0.0/8 127.0.0.1/8 fd00::/8 ::1

Может быть несколько сопоставителей remote_ip для одного именованного сопоставителя, и их диапазоны будут объединены и объединены по ИЛИ.

Пример:

Сопоставление запросов с частных IPv4-адресов:

 удаленный_ip 192. 168.0.0/16 172.16.0.0/12 10.0.0.0/8 127.0.0.1/8
 

Этот сопоставитель обычно работает в паре с сопоставителем , а не , чтобы инвертировать совпадение. Например, чтобы прервать все подключения с общедоступных адресов IPv4 и IPv6 (что является инверсией всех частных диапазонов):

 @denied not remote_ip private_ranges
прервать @отказано
 

переменная

 vars <переменная> <значения...>
 

По значению переменной в контексте запроса или значению заполнителя. Можно указать несколько значений для соответствия любому из этих возможных значений (по ИЛИ).

Аргумент <переменная> может быть либо именем переменной, либо заполнителем в фигурных скобках { } . (Заполнители не раскрываются в первом параметре.)

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

Пример:

Сопоставить выходные данные директивы map с именем magic_number для значений 3 или 5 :

 переменных {magic_number} 3 5
 

vars_regexp

 vars_regexp [<имя>] <переменная> 
 

Аналогично vars , но поддерживает регулярные выражения. Доступ к группам захвата можно получить с помощью заполнителя, такого как {re.name.capture_group} , где имя — это имя регулярного выражения (необязательно, но рекомендуется) и группа захвата — это либо имя, либо номер группы захвата в выражении. Группа захвата 0 — это полное соответствие регулярному выражению, 1 — первая группа захвата, 2 — вторая группа захвата и так далее.

Используемый язык регулярных выражений — RE2, включенный в Go. См. справочник по синтаксису RE2 и обзор синтаксиса регулярных выражений Go.

Может быть только один сопоставитель vars_regexp на именованный сопоставитель.

Пример: 9(4.*)

Учебное пособие по регулярным выражениям — сопоставление URL-адреса · GitHub

В этом руководстве мы рассмотрим регулярное выражение для сопоставления с URL-адресом. Используя этот пример, мы можем приступить к базовому пониманию регулярных выражений, того, что представляет каждый компонент, как их можно реализовать в коде для определения шаблонов поиска и как их можно использовать для проверки того, что определенные строки соответствуют определенным критериям.

Резюме

Как указывалось ранее, следующее регулярное выражение можно использовать для проверки того, что строка на самом деле является URL-адресом 9(https?:\/\/)?([\da-z\.-]+)\.([a-z\.]{2,6})([\/\w \.-]*)*\ /?$/

Проще говоря, это выражение распадается на следующее:

• Строка должна начинаться с https://
• Строка может включать любое числовое значение 0-9 , любую строчную букву из a-z , . или -. Строка может соответствовать этому шаблону один или несколько раз
• . должен следовать предыдущему шаблону
• Следующая часть строки должна включать строчные буквы от до z , . и быть между 2-6 символов длиной
• Далее строка может включать / , за которыми следует любой буквенно-цифровой символ из основного латинского алфавита (включая _ ), . или -. Этот шаблон может повторяться 0 или более раз
• За предыдущим шаблоном может следовать / 0 или один раз

Содержание

• Анкеры
• Квантификаторы
• Группировка конструкций
• Скобочные выражения
• Классы символов
• Экранирование символов
• Автор

Компоненты регулярных выражений

Для создания регулярных выражений используется множество отдельных компонентов. Поскольку регулярное выражение считается литералом, важно помнить, что эти выражения должны быть заключены в символы косой черты /9.АВС . "ABC" и "ABCDEFG" будут совпадать.

Квантификаторы

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

• * — Соответствует предыдущему шаблону 0 или более раз. Пример: /fun*/ соответствует "fun" в "funny" и "un" в "thunder" , но нет совпадений в "bird"

• + — Соответствует предыдущему шаблону 1 или более раз. Пример: /k+/ соответствует каждому k в "kick"

• ? — Соответствует предыдущему шаблону 0 или 1 раз. Пример: /e?el?/ соответствует "el" в "gel" и "le" в "cradle" Важное примечание о ? заключается в том, что если он используется сразу после другого квантификатора ( * , + , ? , {} ), он делает квантификатор нежадным, то есть он будет соответствовать минимальному количеству раз, а не значение по умолчанию, которое соответствует максимальному количеству раз

• { n } — точно соответствует предыдущему шаблону n умножить на

• { n, } — Соответствует предыдущему шаблону как минимум n раза

• { n, x } — Соответствует предыдущему образцу минимум n раз и максимум x раза

Возвращаясь к нашему примеру регулярного выражения для сопоставления URL-адреса, мы можем изучить различные квантификаторы, присутствующие в выражении. 9(https?:\/\/)?([\da-z\.-]+)\.([a-z\.]{2,6})([\/\w \.-]*)*\ /?$/

• Мы видим ? использовался в нескольких разных местах. Во-первых, для обозначения того, что "https" может совпадать 0 или 1 раз, затем для обозначения того, что "https//" может совпадать 0 или 1 раз, и, наконец, в конце для обозначения того, что / может совпадать 0 или 1 раз. 1 раз

• Мы видим, что + используются один раз, чтобы показать, что шаблон [\da-z\.-] должен соответствовать 1 или более раз

• Мы видим, что {2, 6} используется для обозначения того, что шаблон [a-z\.] должен совпадать минимум 2 и максимум 6 раз.

• Мы видим, что * используется для обозначения того, что [\/\w \.-] может соответствовать 0 или более раз и что ([a-z\. ]{2,6})([\/\w \. -]*) может соответствовать 0 или более раз

Группирующие конструкции

Конструкции группировки используются в регулярных выражениях для проверки нескольких частей или разделов строки на соответствие различным требованиям. Используя круглые скобки ( 9(https?:\/\/)?([\da-z\.-]+)\.([a-z\.]{2,6})([\/\w \.-]*)*\ /?$/ мы видим следующие подвыражения:

• (https?:\/\/)

• ([\da-z\.-]+)

• ([a-z\.]{2,6})

• ([\/\w \.-]*)

Скобочные выражения

Скобочные выражения, также известные как группы положительных символов, представляют диапазон символов, которые мы хотим сопоставить в нашей строке. При написании выражений в квадратных скобках мы можем включать все символы, которые мы хотим сопоставить, но более распространенной практикой является использование дефиса для представления диапазона этих символов. Например 9(https?:\/\/)?([\da-z\.-]+)\.([a-z\.]{2,6})([\/\w \.-]*)*\ /?$/ мы видим следующие скобочные выражения:

• [\da-z\.-] — это выражение в квадратных скобках указывает, что любая числовая цифра, любая строчная буква a-z, косая черта, точка или дефис будут соответствовать

• [a-z\.] — это выражение в квадратных скобках указывает, что любая строчная буква a-z, косая черта или точка будут соответствовать

• [\/\ш \.-] — это выражение в квадратных скобках указывает, что любая косая черта, любой буквенно-цифровой символ, точка или дефис будут соответствовать

  .

Классы символов

Классы символов используются в регулярных выражениях для определения наборов символов, один из которых может встречаться в строке для получения совпадения. Скобочные выражения, рассмотренные в предыдущем разделе, являются одним из популярных типов классов символов. Вот некоторые другие распространенные классы персонажей.

• . — соответствует любому символу, кроме 9.0061 /n (новая строка)

• /d — соответствует любой цифре

• /w — соответствует любому буквенно-цифровому символу латинского алфавита, включая подчеркивание ( _ )

• /s — Соответствует одному символу пробела, включая символы табуляции и разрывы строк

Обратите внимание, что для /d , /w и /s можно изменить на обратное соответствие, набрав заглавную букву. 9(https?:\/\/)?([\da-z\.-]+)\.([a-z\.]{2,6})([\/\w \.-]*)*\ /?$/ мы видим, что классы символов применяются следующими способами:

• [\da-z\.-] — внутри этого выражения в квадратных скобках (класс символов сам по себе) мы видим, что /d используется для обозначения того, что любая числовая цифра будет соответствовать

• [\/\w \. -] — в этом выражении в квадратных скобках мы видим, что /w используется для обозначения того, что любой буквенно-цифровой символ из латинского алфавита будет соответствовать.

Экранирование символов

Экранированные символы обозначаются обратной косой чертой ( \ ) в регулярном выражении. Экранирование символа используется, когда символ не предназначен для буквального толкования. Например, { обычно указывает на начало квантификатора, но если поставить перед фигурной скобкой обратную косую черту ( \{ ), регулярное выражение будет искать открывающую фигурную скобку, а не начало квантификатора. Это может быть полезно при поиске строк, содержащих специальные символы. Одно предостережение относительно escape-символов (и всех других специальных символов) заключается в том, что они теряют свою функциональность при включении в выражения в квадратных скобках. 9(https?:\/\/)?([\da-z\.