Поиск
Справочник

Пароль на сайт в nginx: auth_basic и файл .htpasswd

Пароль в nginx ставят двумя строками: auth_basic включает окно входа, а auth_basic_user_file указывает файл с именами и паролями. Где написать эти строки, решает, что закроется: весь сайт, одна папка или один файл.

≈ 7 мин чтения
Содержание 11

Что сделать прямо сейчас

  1. Команды вводятся на сервере: подключитесь к нему по SSH (как подключиться) и набирайте их в том же окне.
  2. Установите программу htpasswd: sudo apt install apache2-utils. sudo может спросить пароль вашего пользователя на сервере: символы при вводе не видны, наберите пароль и нажмите Enter.
  3. Создайте файл с паролем: sudo htpasswd -c /etc/nginx/.htpasswd admin. Вместо admin — имя для входа. Программа дважды спросит пароль, символы при вводе не видны.
  4. Откройте файл сайта: sudo nano /etc/nginx/sites-available/example.com. Вместо example.com — имя файла вашего сайта: список покажет ls /etc/nginx/sites-enabled/. Если система спросит пароль, введите пароль своего пользователя на сервере. Символы при вводе не видны — наберите пароль и нажмите Enter.
  5. Впишите две строки из раздела ниже в нужное место: где писать строки.
  6. Сохраните файл — Ctrl+O, Enter, затем Ctrl+X — и проверьте настройки: sudo nginx -t. В ответе должны быть слова syntax is ok и test is successful. Тогда примените их: sudo systemctl reload nginx. Если команда ничего не ответила, настройки применены.
  7. Проверьте: curl -I https://example.com/admin/ — в ответе должен быть код 401. В браузере по этому адресу появится окно для имени и пароля.

Если проверка нашла ошибку, nginx назовёт файл и номер строки, а сайт продолжит работать на старых настройках. Что значит сообщение — Все ошибки nginx.

Подробнее о каждом шаге, с ответами программ, — в разборе ошибки 401.

Как устроены строки

auth_basic "Закрытый раздел";
auth_basic_user_file /etc/nginx/.htpasswd;
ЧастьЧто значит
auth_basic "Закрытый раздел"включить пароль. Текст в кавычках — название закрытой области, nginx отправляет его в ответе 401
auth_basic offвыключить пароль в этом блоке, если он включён уровнем выше
auth_basic_user_fileпуть к файлу с именами и паролями

Строки пишут в блоках http, server и location. Блок location получает пароль из блока server, если в нём нет своей строки auth_basic.

Где писать строки

Весь сайт

Две строки — внутри блока server, например под строкой root. Так закрывают сайт, который ещё в разработке. Поисковые роботы пароля не знают и получат 401, поэтому на рабочем сайте закрывайте только служебные разделы.

Одна папка

location ^~ /admin/ {
    auth_basic "Закрытый раздел";
    auth_basic_user_file /etc/nginx/.htpasswd;

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.3-fpm.sock;
    }
}

Знак ^~ нужен, чтобы пароль спрашивался и для файлов .php из этой папки: без него их заберёт общий блок location ~ \.php$. Строки include и fastcgi_pass скопируйте из блока для PHP в вашем файле. Если на сайте нет PHP, вложенный блок не нужен.

Один файл

location = /wp-login.php {
    auth_basic "Закрытый раздел";
    auth_basic_user_file /etc/nginx/.htpasswd;
    include snippets/fastcgi-php.conf;
    fastcgi_pass unix:/run/php/php8.3-fpm.sock;
}

Блок со знаком = срабатывает только на этот адрес. Для файла .php в нём нужны строки include и fastcgi_pass, иначе nginx не передаст файл в PHP. Так ставят второй пароль на страницу входа WordPress — боты не дойдут до подбора пароля.

Весь сайт, кроме одной папки

Пароль — в блоке server, а в папке, которая должна открываться без него, — строка auth_basic off:

location ^~ /public/ {
    auth_basic off;
}

Файл с паролями

В файле по одной строке на человека: имя, двоеточие и зашифрованный пароль. Файл создаёт программа htpasswd. Ключ -c создаёт файл заново и стирает старые записи — нужен только в первый раз.

ЗадачаКоманда
добавить человека или сменить парольsudo htpasswd /etc/nginx/.htpasswd anna
удалить человекаsudo htpasswd -D /etc/nginx/.htpasswd anna
посмотреть, кто есть в файлеsudo cut -d: -f1 /etc/nginx/.htpasswd

nginx читает файл при каждом запросе, поэтому после этих команд перезагружать его не нужно.

Храните файл в /etc/nginx/, а не в папке сайта: файл из папки сайта nginx может отдать любому, кто наберёт его адрес.

Свой IP без пароля

Чтобы со своего адреса заходить без пароля, а с остальных — по паролю, добавьте строки satisfy, allow и deny:

location ^~ /admin/ {
    satisfy any;
    allow 203.0.113.10;
    deny all;
    auth_basic "Закрытый раздел";
    auth_basic_user_file /etc/nginx/.htpasswd;
}

Вместо 203.0.113.10 — ваш IP. Его покажет команда echo $SSH_CLIENT на сервере: первое число в ответе. satisfy any значит «хватит одного»: адрес из allow или верный пароль. Без этой строки нужно и то, и другое. Как работают allow и deny — Доступ по IP в nginx.

Только с HTTPS

Имя и пароль браузер отправляет в каждом запросе в кодировке Base64, которую легко расшифровать. Закрывайте паролем только сайт с HTTPS — Бесплатный SSL-сертификат.

Как убрать пароль

Удалите строки auth_basic и auth_basic_user_file или блок location, который вы добавляли. Затем проверьте и примените настройки: sudo nginx -t и sudo systemctl reload nginx.

Как проверить

curl -I https://example.com/admin/

Без пароля в ответе должны быть код 401 и строка WWW-Authenticate с названием из строки auth_basic. curl может показать имена заголовков маленькими буквами — это то же самое. Теперь с паролем:

curl -I -u admin https://example.com/admin/

curl спросит пароль. С верным паролем код будет 200, а для папки без индексного файла — 403 или 404.

Ошибки и как их исправить

Что видитеЧто делать
окна входа нет, страница открываетсястроки стоят не в том блоке. Для файлов .php проверьте знак ^~ — одна папка
верный пароль не подходитпосмотрите журнал ошибок: строки was not found и password mismatch — разбор
403, в журнале open() "/etc/nginx/.htpasswd" failed (2: No such file or directory)файла нет по пути из auth_basic_user_file: создайте его или исправьте путь
500, в журнале failed (13: Permission denied)nginx не может прочитать файл: sudo chmod 644 /etc/nginx/.htpasswd
пароль спрашивается на всём сайте, а не в папкестроки стоят в блоке server — перенесите их в location папки
сайт пропал из поискароботы получают 401: снимите пароль с рабочих страниц

Источники

Сверено 23 октября 2026 года.

Где попробовать. Команды из статьи безопаснее сначала повторить на отдельном тестовом сервере, а не на рабочем. Подойдёт VPS с Ubuntu, например Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше