Шаблон проверки DNS для LetsEncrypt с использованием Cloudflare

Всем привет

Мне потребовался метод DNS для подтверждения владения SSL-сертификатом в Let’s Encrypt.

Я скопировал существующий файл web.letsencrypt.ssl.template.yml, расположенный в /var/discourse/templates/, и изменил его для использования метода автоматической интеграции с DNS-API. Ниже представлен мой шаблон; буду рад любым предложениям по его улучшению.

Я назвал этот файл web.letsencrypt.ssl.dns.template.yml

env:
  LETSENCRYPT_DIR: "/shared/letsencrypt"
  DISCOURSE_FORCE_HTTPS: true

hooks:
  after_ssl:
    - exec:
       cmd:
         - if [ -z "$LETSENCRYPT_ACCOUNT_EMAIL" ]; then echo "LETSENCRYPT_ACCOUNT_EMAIL ENV variable is required and has not been set."; exit 1; fi
         - /bin/bash -c "if [[ ! \"$LETSENCRYPT_ACCOUNT_EMAIL\" =~ ([^@]+)@([^\.]+) ]]; then echo \"LETSENCRYPT_ACCOUNT_EMAIL is not a valid email address\"; exit 1; fi"

    - exec:
       cmd:
         - cd /root && git clone --branch 3.0.7 --depth 1 https://github.com/acmesh-official/acme.sh.git && cd /root/acme.sh
         - touch /var/spool/cron/crontabs/root
         - install -d -m 0755 -g root -o root $LETSENCRYPT_DIR
         - cd /root/acme.sh && LE_WORKING_DIR="${LETSENCRYPT_DIR}" ./acme.sh --install --log "${LETSENCRYPT_DIR}/acme.sh.log"
         - cd /root/acme.sh && LE_WORKING_DIR="${LETSENCRYPT_DIR}" ./acme.sh --upgrade --auto-upgrade
         - cd /root/acme.sh && LE_WORKING_DIR="${LETSENCRYPT_DIR}" ./acme.sh --set-default-ca  --server  letsencrypt 

    - file:
       path: /etc/runit/1.d/letsencrypt
       chmod: "+x"
       contents: |
        #!/bin/bash
        
        issue_cert() {
          export CF_Token="$$ENV_LETSENCRYPT_CF_TOKEN"
          export CF_Account_ID="$$ENV_LETSENCRYPT_CF_ACCOUNT_ID"
          export CF_Zone_ID="$$ENV_LETSENCRYPT_CF_ZONE_ID"
          LE_WORKING_DIR="${LETSENCRYPT_DIR}" $$ENV_LETSENCRYPT_DIR/acme.sh --issue --dns $$ENV_LETSENCRYPT_DNS_PROVIDER $2 -d $$ENV_DISCOURSE_HOSTNAME --keylength $1 -w /var/www/discourse/public
        }

        cert_exists() {
          [[ "$(cd $$ENV_LETSENCRYPT_DIR/$$ENV_DISCOURSE_HOSTNAME$1 && openssl verify -CAfile <(openssl x509 -in ca.cer) fullchain.cer | grep "OK")" ]]
        }

        ########################################################
        # RSA cert
        ########################################################
        issue_cert "4096"

        if ! cert_exists ""; then
          # Try to issue the cert again if something goes wrong
          issue_cert "4096" "--force"
        fi

        LE_WORKING_DIR="${LETSENCRYPT_DIR}" $$ENV_LETSENCRYPT_DIR/acme.sh \
          --installcert \
          -d $$ENV_DISCOURSE_HOSTNAME \
          --fullchainpath /shared/ssl/$$ENV_DISCOURSE_HOSTNAME.cer \
          --keypath /shared/ssl/$$ENV_DISCOURSE_HOSTNAME.key \
          --reloadcmd "sv reload nginx"

        ########################################################
        # ECDSA cert
        ########################################################
        issue_cert "ec-256"

        if ! cert_exists "_ecc"; then
          # Try to issue the cert again if something goes wrong
          issue_cert "ec-256" "--force"
        fi

        LE_WORKING_DIR="${LETSENCRYPT_DIR}" $$ENV_LETSENCRYPT_DIR/acme.sh \
          --installcert --ecc \
          -d $$ENV_DISCOURSE_HOSTNAME \
          --fullchainpath /shared/ssl/$$ENV_DISCOURSE_HOSTNAME_ecc.cer \
          --keypath /shared/ssl/$$ENV_DISCOURSE_HOSTNAME_ecc.key \
          --reloadcmd "sv reload nginx"

        if cert_exists "" || cert_exists "_ecc"; then
          grep -q 'force_https' "/var/www/discourse/config/discourse.conf" || echo "force_https = 'true'" >> "/var/www/discourse/config/discourse.conf"
        fi

    - replace:
       filename: "/etc/nginx/conf.d/discourse.conf"
       from: /ssl_certificate.+/
       to: |
         ssl_certificate /shared/ssl/$$ENV_DISCOURSE_HOSTNAME.cer;
         ssl_certificate /shared/ssl/$$ENV_DISCOURSE_HOSTNAME_ecc.cer;

    - replace:
       filename: /shared/letsencrypt/account.conf
       from: /#?ACCOUNT_EMAIL=.+/
       to: |
         ACCOUNT_EMAIL=$$ENV_LETSENCRYPT_ACCOUNT_EMAIL

    - replace:
       filename: "/etc/nginx/conf.d/discourse.conf"
       from: /ssl_certificate_key.+/
       to: |
         ssl_certificate_key /shared/ssl/$$ENV_DISCOURSE_HOSTNAME.key;
         ssl_certificate_key /shared/ssl/$$ENV_DISCOURSE_HOSTNAME_ecc.key;

    - replace:
       filename: "/etc/nginx/conf.d/discourse.conf"
       from: /add_header.+/
       to: |
         add_header Strict-Transport-Security 'max-age=63072000';

Вам потребуется добавить несколько дополнительных переменных окружения в файл app.yml и, возможно, внести изменения, если вы используете не Cloudflare в качестве DNS-провайдера. Все настройки API для различных провайдеров доступны здесь.

Вот что я добавил в свой файл app.yml в секцию templates:

templates:
  - "templates/postgres.template.yml"
  - "templates/redis.template.yml"
  - "templates/web.template.yml"
  ## Раскомментируйте следующую строку, чтобы включить прослушивание IPv6
  #- "templates/web.ipv6.template.yml"
  - "templates/web.ratelimited.template.yml"
  ## Раскомментируйте эти две строки, если хотите добавить Let's Encrypt (https)
  - "templates/web.ssl.template.yml"
  - "templates/web.letsencrypt.ssl.dns.template.yml"
  #- "templates/web.letsencrypt.ssl.template.yml"

А ниже, в секции env:

## Если вы добавили шаблон Let's Encrypt, раскомментируйте ниже, чтобы получить бесплатный SSL-сертификат
  LETSENCRYPT_ACCOUNT_EMAIL: me@mydomain.com
  LETSENCRYPT_CF_TOKEN: "YOUR_TOKEN"
  LETSENCRYPT_CF_ACCOUNT_ID: "YOUR_ACCOUNT_ID"
  LETSENCRYPT_CF_ZONE_ID: "YOUR_ZONE_ID"
  LETSENCRYPT_DNS_PROVIDER: "YOUR_DNS_PROVIDER" ## Например, dns_cf

После обновления этих файлов я просто выполнил команду пересборки Docker-приложения:

cd /var/discourse
./launcher rebuild app 

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

Надеюсь, это поможет кому-то.

РЕДАКТИРОВАНИЕ: Я только что достиг недельного лимита в 5 сертификатов Let’s Encrypt (на точное доменное имя).

У вас возникали проблемы с генерацией сертификата _ecc?

Согласно вашему посту, основной файл website.com.cer успешно генерируется, однако website.com_ecc.cer имеет размер 0 байт (файл _ecc.key в порядке).

Оба сертификата выдаются одним и тем же методом issue_cert, поэтому по какой-то причине основной работает, а _ecc — нет.

Актуально ли до сих пор переключить Let’s Encrypt на проверку через DNS вместо использования модели веб-сервера?

Привет, @LotusJeff,

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

  • Проверка cert_exists в нём не проходит с текущей цепочкой Let’s Encrypt, поэтому он принудительно запрашивает новые сертификаты при каждом запуске контейнера, что может привести к достижению лимита на дублирование сертификатов.
  • Шаги replace для nginx нацелены на строки, которые переместились, а шаг с add_header теперь перезаписывает несвязанный заголовок ETag.

Теперь вам не нужен пользовательский шаблон. Оставьте стандартный шаблон Let’s Encrypt и переключите его на валидацию через DNS в app.yml:

templates:
  # ...
  - "templates/web.ssl.template.yml"
  - "templates/web.letsencrypt.ssl.template.yml"

env:
  # ...
  CF_Token: "YOUR_TOKEN"        # API-токен Cloudflare с правами Zone > DNS > Edit для этой зоны
  CF_Zone_ID: "YOUR_ZONE_ID"

run:
  - exec:
      cmd:
        - mkdir -p /opt/dnsapi
        - curl -fsSL https://raw.githubusercontent.com/acmesh-official/acme.sh/3.0.6/dnsapi/dns_cf.sh -o /opt/dnsapi/dns_cf.sh
  - replace:
      filename: /usr/local/bin/letsencrypt
      from: "-w /var/www/discourse/public"
      to: "--dns dns_cf"

Что это делает:

  • Стандартный шаблон загружает только основной скрипт acme.sh без плагинов для DNS. Шаг exec добавляет плагин Cloudflare, а стандартный скрипт запуска копирует его в /shared/letsencrypt/dnsapi/. Убедитесь, что версия в URL совпадает с версией acme.sh, указанной в templates/web.letsencrypt.ssl.template.yml (на данный момент это 3.0.6).
  • Секция run: выполняется после применения шаблонов, поэтому replace переключает стандартный скрипт запуска с HTTP-валидации на DNS-валидацию.
  • При валидации acme.sh читает CF_Token и CF_Zone_ID из окружения и сохраняет их вместе с сертификатом. Ежедневная задача cron не видит окружение контейнера, поэтому при обновлении сертификатов используется эта сохраненная копия.

Если вы использовали мой старый шаблон, удалите его строку из секции templates: и переименуйте переменные LETSENCRYPT_CF_TOKEN и LETSENCRYPT_CF_ZONE_ID в CF_Token и CF_Zone_ID.

Если у вас уже есть сертификаты (полученные через HTTP-валидацию или с помощью моего старого шаблона), переместите старую папку acme.sh в сторону перед пересборкой:

cd /var/discourse
mv shared/standalone/letsencrypt shared/standalone/letsencrypt.old
./launcher rebuild app

Без этого acme.sh может пропустить шаг с DNS (он сохраняет старый метод до тех пор, пока не наступит срок обновления, а Let’s Encrypt может повторно использовать недавнюю валидацию). В таком случае токен никогда не сохраняется, и первое обновление по cron завершается ошибкой. При использовании чистой папки acme.sh регистрирует новый аккаунт и выполняет реальную DNS-валидацию, поэтому первый запуск займет примерно на минуту больше.

Не удаляйте папку .old, пока новые сертификаты не заработают корректно. Если шаг с DNS завершится ошибкой, скрипт запуска все равно перезапишет файлы в shared/ssl, и nginx не запустится.

acme.sh сохраняет токен в виде простого текста в папке shared/standalone/letsencrypt/, поэтому выдавайте токену только необходимые разрешения.

Протестировано с discourse_docker и Discourse latest по состоянию на ноябрь 2026 года.

Я выполнил эти шаги, в результате чего получил ошибку Cloudflare 521. Эта ошибка возникала как по адресу форума (forum.website.tld), так и по основному домену (website.tld). Я отменил изменения, выполнил пересборку, и всё снова заработало.

Есть ли способ принудительно обновить сертификат после пересборки?
Пытается ли это создать wildcard-сертификат вместо сертификата для конкретного URL?

Привет @LotusJeff,

Ошибка Cloudflare 521 означает, что Cloudflare не смог вообще подключиться к вашему серверу. Это не ошибка сертификата (неверный сертификат вызывает ошибку 525 или 526). Значит, nginx в контейнере Discourse не запущен. Я предполагаю, что ваш основной домен отображает ту же ошибку, поскольку он указывает на тот же сервер. Плагин DNS добавляет и удаляет только одну TXT-запись. Он не изменяет какие-либо A- или CNAME-записи.

Пытается ли он создать wildcard-сертификат? Нет. Стандартный скрипт запрашивает сертификат только для DISCOURSE_HOSTNAME, плюс любые имена в DISCOURSE_HOSTNAME_ALIASES. acme.sh добавляет TXT-запись _acme-challenge.forum.website.tld, ждет, пока Let’s Encrypt ее проверит, а затем удаляет ее. Если вы используете DISCOURSE_HOSTNAME_ALIASES, все эти имена должны находиться в зоне, на которую указывает CF_Zone_ID.

Как принудительно создать новый сертификат? Перемещение старой папки letsencrypt в сторону перед пересборкой — это и есть принудительное обновление. Если папка пуста, у acme.sh нет сертификата для сохранения, поэтому при следующем запуске он выполнит новую проверку DNS. Пожалуйста, не повторяйте запуски с флагом --force: каждый успешный запуск выпускает два сертификата (RSA и ECDSA), а Let’s Encrypt разрешает только 5 сертификатов для одного и того же имени хоста за 7 дней.

Почему nginx не запустился. Скрипт Let’s Encrypt выполняется при запуске контейнера, до запуска nginx. Если вы переместили папку в сторону, есть две вероятные причины:

  1. Он все еще ждал. При проверке DNS acme.sh ждет, пока TXT-запись станет видна в публичных DNS-серверах. С Cloudflare это обычно занимает менее минуты. Но если запись не появляется, acme.sh ждет до 20 минут для каждого сертификата, и Cloudflare показывает ошибку 521 все это время.
  2. Шаг DNS завершился ошибкой. Тогда стандартный скрипт все равно записывает пустые файлы в shared/ssl, и nginx не может запуститься.

Если вы не перемещали папку в сторону, acme.sh пропускает шаг DNS до тех пор, пока не наступит срок обновления, поэтому ошибка 521, скорее всего, возникла из-за самой пересборки. Проверьте, что вы добавили мои строки в существующие секции templates:, env: и run: в app.yml, а не создали новые. Стандартный app.yml уже содержит секцию run: внизу. Если ключ встречается в файле дважды, учитывается только последний.

Найдите причину. Лог acme.sh сохраняется в общей папке после пересборки, поэтому там остались ошибки из неудачного запуска:

cd /var/discourse
grep -a -i -E 'error|invalid|can not find|timed out|cert success' shared/standalone/letsencrypt*/acme.sh.log | tail -n 40

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

Протестируйте перед повторной попыткой. Это выполняет полную проверку DNS с тестовым сервером Let’s Encrypt из временной папки внутри работающего контейнера. Это не затрагивает ваши рабочие сертификаты или лимиты запросов к продакшн-серверу, поэтому ваш форум останется доступным:

cd /var/discourse
./launcher enter app

mkdir -p /tmp/acme-test/dnsapi
curl -fsSL https://raw.githubusercontent.com/acmesh-official/acme.sh/3.0.6/acme.sh -o /tmp/acme-test/acme.sh
curl -fsSL https://raw.githubusercontent.com/acmesh-official/acme.sh/3.0.6/dnsapi/dns_cf.sh -o /tmp/acme-test/dnsapi/dns_cf.sh
chmod +x /tmp/acme-test/acme.sh
CF_Token="YOUR_TOKEN" CF_Zone_ID="YOUR_ZONE_ID" /tmp/acme-test/acme.sh --home /tmp/acme-test \
  --server letsencrypt_test --issue --dns dns_cf -d forum.website.tld

rm -rf /tmp/acme-test
exit

Если процесс завершается сообщением Cert success., значит, ваш токен, ID зоны и настройки DNS в порядке, а проблема кроется в изменениях app.yml. Если он завершится ошибкой, сообщение об ошибке подскажет причину. Например, invalid domain обычно означает неверный ID зоны или токен, не имеющий доступа к этой зоне.

При следующей пересборке следите за запуском с помощью docker logs -f app и дайте несколько минут, прежде чем откатывать изменения. Вы должны дважды увидеть Cert success., а затем должен запуститься nginx.