Пароль на сайт в nginx: auth_basic и файл .htpasswd
Пароль в nginx ставят двумя строками: auth_basic включает окно входа, а auth_basic_user_file указывает файл с именами и паролями. Где написать эти строки, решает, что закроется: весь сайт, одна папка или один файл.
Содержание 11
Что сделать прямо сейчас
- Команды вводятся на сервере: подключитесь к нему по SSH (как подключиться) и набирайте их в том же окне.
- Установите программу htpasswd:
sudo apt install apache2-utils. sudo может спросить пароль вашего пользователя на сервере: символы при вводе не видны, наберите пароль и нажмите Enter. - Создайте файл с паролем:
sudo htpasswd -c /etc/nginx/.htpasswd admin. Вместо admin — имя для входа. Программа дважды спросит пароль, символы при вводе не видны. - Откройте файл сайта:
sudo nano /etc/nginx/sites-available/example.com. Вместо example.com — имя файла вашего сайта: список покажетls /etc/nginx/sites-enabled/. Если система спросит пароль, введите пароль своего пользователя на сервере. Символы при вводе не видны — наберите пароль и нажмите Enter. - Впишите две строки из раздела ниже в нужное место: где писать строки.
- Сохраните файл — Ctrl+O, Enter, затем Ctrl+X — и проверьте настройки:
sudo nginx -t. В ответе должны быть слова syntax is ok и test is successful. Тогда примените их:sudo systemctl reload nginx. Если команда ничего не ответила, настройки применены. - Проверьте:
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: снимите пароль с рабочих страниц |
Источники
- Документация nginx: модуль ngx_http_auth_basic_module — auth_basic, auth_basic_user_file, формат файла с паролями и способы шифрования.
- Исходный код nginx 1.24.0: ngx_http_auth_basic_module.c — записи no user/password was provided, was not found in и password mismatch, ответ 401; без файла с паролями — 403.
- Документация nginx: директива satisfy — all — нужны и адрес, и пароль, any — хватит одного из них.
- Документация Apache: htpasswd — ключи -c и -D, формат файла с паролями.
Сверено 23 октября 2026 года.
Что почитать дальше
- Настройки nginxкак устроены файлы и блоки, главные директивы.
- Ошибка 401 Unauthorizedпароль в nginx по шагам и записи в журнале.
- Доступ по IP в nginxоткрыть раздел только своим адресам.
- limit_req в nginxограничить число попыток входа.
- Пароль на папку через .htaccessто же для Apache и виртуального хостинга.
- fail2ban для nginxблокировать ботов и подбор пароля к сайту.