acme.sh — это клиент для получения бесплатных SSL-сертификатов у Let's Encrypt и других удостоверяющих центров, поддерживающих протокол ACME. Его главное преимущество в том, что он целиком написан на shell: не нужны Python, дополнительные библиотеки или пакетный менеджер. Поэтому acme.sh спокойно работает на старых серверах, в минимальных контейнерах и даже под пользователем без прав root. По сравнению с Certbot он легче, а поддержка DNS-провайдеров у него заметно шире.
Если ваш сайт размещён на обычном виртуальном хостинге, acme.sh вам, скорее всего, не понадобится: на хостинге sayt.uz сертификат Let's Encrypt выпускается через панель и продлевается сам. Это руководство рассчитано на VPS или собственный сервер, где вы вручную управляете Nginx или Apache.
Установка acme.sh и выбор Let's Encrypt
Установка выполняется одной командой. Скрипт копирует файлы в каталог ~/.acme.sh/ в домашней папке пользователя, добавляет короткий алиас и создаёт ежедневное задание cron. Адрес электронной почты используется для регистрации аккаунта в удостоверяющем центре, поэтому указывайте настоящий ящик, который вы читаете.
curl https://get.acme.sh | sh -s email=admin@example.uz
source ~/.bashrc
acme.sh --version
Важный момент: начиная с версии 3.0 удостоверяющим центром по умолчанию в acme.sh является не Let's Encrypt, а ZeroSSL. Оба бесплатны, но многие предпочитают Let's Encrypt из-за привычности и обилия документации. Достаточно один раз сменить центр по умолчанию, и все последующие команды будут обращаться к нему.
acme.sh --set-default-ca --server letsencrypt
Режим webroot: самый удобный вариант для работающего сайта
В режиме webroot acme.sh записывает временный файл в корень сайта, в папку .well-known/acme-challenge/, а Let's Encrypt читает его по HTTP через порт 80 и так убеждается, что домен принадлежит вам. Останавливать веб-сервер при этом не нужно, поэтому для работающего сайта это самый безопасный выбор. Требуется лишь, чтобы A-запись домена указывала именно на этот сервер, а порт 80 был открыт снаружи.
Например, мебельный магазин из Ташкента держит сайт на домене misol.uz на VPS с Nginx, файлы лежат в /var/www/misol.uz. Выпуск сертификата сразу для основного домена и варианта с www выглядит так:
acme.sh --issue -d misol.uz -d www.misol.uz -w /var/www/misol.uz
Если в конфигурации Nginx все запросы проксируются в приложение (например, на Node.js), путь .well-known тоже уйдёт туда, и проверка завершится ошибкой 404. В таком случае в блок server нужно добавить отдельный location, который отдаёт challenge-файлы с диска:
location ^~ /.well-known/acme-challenge/ {
root /var/www/misol.uz;
default_type "text/plain";
}
Режимы standalone и nginx
Если веб-сервера на машине ещё нет, удобен режим standalone: acme.sh поднимает собственный временный сервер на порту 80 и закрывает его после проверки. Для этого порт должен быть свободен, а на сервере должен быть установлен socat. Если порт 80 уже занят Nginx, команда завершится ошибкой, поэтому этот режим подходит для нового сервера или ситуации, когда допустима короткая остановка.
acme.sh --issue --standalone -d misol.uz
Ещё один вариант — режим --nginx. В нём acme.sh временно добавляет правило для challenge в конфигурацию Nginx, а после проверки возвращает её в исходное состояние. Это удобно, но на сложных конфигурациях, разбитых на множество файлов, может дать неожиданный результат, поэтому многие администраторы выбирают простой и предсказуемый webroot.
Сертификат через DNS API и wildcard
Wildcard-сертификат (например, *.misol.uz) выдаётся только с проверкой DNS-01. acme.sh добавляет в зону домена TXT-запись _acme-challenge, Let's Encrypt её читает, после чего запись удаляется. У acme.sh есть готовые модули для сотен DNS-провайдеров, например dns_cf для Cloudflare. API-токен стоит создавать только с правом редактирования DNS нужной зоны, а не отдавать глобальный ключ аккаунта.
export CF_Token="cloudflare-api-token"
acme.sh --issue --dns dns_cf -d misol.uz -d '*.misol.uz'
После первого использования токен сохраняется в ~/.acme.sh/account.conf и при продлении больше не запрашивается. Если у вашего DNS-провайдера нет API, существует ручной режим, но тогда TXT-запись придётся добавлять самостоятельно при каждом продлении, что фактически сводит на нет автоматизацию.
Правильная установка сертификата в Nginx
Самая частая ошибка — указывать в конфигурации веб-сервера пути прямо к файлам внутри ~/.acme.sh/. Структура этой папки считается внутренней и может меняться. Правильный путь — скопировать файлы в постоянное место командой --install-cert и указать команду перезагрузки. acme.sh запоминает эти настройки и после каждого продления сам копирует файлы и перезагружает Nginx.
mkdir -p /etc/nginx/ssl
acme.sh --install-cert -d misol.uz \
--key-file /etc/nginx/ssl/misol.uz.key \
--fullchain-file /etc/nginx/ssl/misol.uz.fullchain.pem \
--reloadcmd "systemctl reload nginx"
В блоке server Nginx используются именно эти файлы. Важно указывать fullchain: если отдать только сертификат домена, некоторые мобильные устройства и старые браузеры не найдут промежуточный сертификат и покажут предупреждение о небезопасном соединении.
ssl_certificate /etc/nginx/ssl/misol.uz.fullchain.pem;
ssl_certificate_key /etc/nginx/ssl/misol.uz.key;
Как работает автоматическое продление
При установке acme.sh добавляет в crontab задание, которое запускается раз в сутки. Оно проверяет все сертификаты и по умолчанию продлевает те, которым больше 60 дней, то есть 90-дневный сертификат заменяется примерно за месяц до окончания. Наличие задания и список сертификатов можно проверить так:
crontab -l | grep acme
acme.sh --list
Чтобы убедиться, что продление действительно работает, выполните его принудительно заранее. В новых версиях acme.sh тип ключа по умолчанию — ECC, поэтому иногда к команде нужно добавить --ecc: посмотрите тип ключа в выводе --list.
acme.sh --renew -d misol.uz --force --ecc
Разбор ошибок
Если сертификат не выпускается, сначала повторите попытку с подробным журналом. Параметр --debug 2 показывает каждый запрос и ответ, а общий журнал хранится в файле ~/.acme.sh/acme.sh.log. Чаще всего причина банальна: DNS ещё не обновился на новый IP, порт 80 закрыт файрволом или домен указывает на другой сервер.
acme.sh --issue -d misol.uz -w /var/www/misol.uz --debug 2
dig +short misol.uz A
curl -I http://misol.uz/.well-known/acme-challenge/test
Многократные попытки для одного домена во время экспериментов могут упереться в лимиты Let's Encrypt. Поэтому настройку лучше сначала отладить на тестовом сервере с параметром --staging, а реальный сертификат получать, когда всё заработает. И не забывайте обновлять сам acme.sh: команда acme.sh --upgrade --auto-upgrade включает автообновление и помогает не отставать от изменений протокола.