🔐
blog.cat.ssl

acme.sh: получение и продление SSL-сертификата на VPS

17.11.2026
← Все статьи

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 включает автообновление и помогает не отставать от изменений протокола.

Похожие статьи

🔐 ERR_CERT_COMMON_NAME_INVALID: имя в SSL-сертификате не совпадает с доменом 🔒 Срок SSL-сертификатов сократится до 47 дней: что изменится 🚨 Ошибки SSL: ERR_CERT_AUTHORITY_INVALID и другие — как исправить 🔐 HSTS Strict-Transport-Security и preload list — полное руководство для Chrome и Firefox
🌐 Язык
🇺🇿 O'zbek 🇺🇿 Ўзбек 🇷🇺 Русский ✓ 🇬🇧 English