цены сверены 17 ноября 2026 года

Как закрыть сайт или раздел паролем в nginx

Чтобы закрыть сайт паролем, создайте файл с логинами командой htpasswd и добавьте в location две строки: auth_basic и auth_basic_user_file. Проверьте конфиг через nginx -t и перезагрузите nginx.

Как закрыть сайт или раздел паролем в nginx
Содержание
  1. Чем создать файл с паролями?
  2. Почему второго пользователя нельзя добавлять с -c?
  3. Как включить пароль на весь сайт?
  4. Как проверить, что пароль работает?
  5. Откуда ошибка 500 после верного пароля?
  6. Как оставить пароль только на /admin/?
  7. Почему PHP-файлы в /admin/ открылись без пароля?
  8. Что делать с сертификатом, если пароль на весь сайт?
  9. Как сменить пароль или обойтись без htpasswd?
  10. Что делать дальше
Команды проверены 27 октября 2026 годачистая Ubuntu 24.04 · nginx 1.24.0, PHP 8.3Как мы проверяем

Вы переносите example.ru на новый движок и сделали копию сайта на VPS, чтобы спокойно её доделывать. Но адрес открыт всем: зайдёт поисковый робот, и недоделанные страницы могут попасть в поиск. Проще всего поставить на копию пароль прямо в nginx: браузер покажет окно с логином, а без него страницы не отдадутся. Потом, когда сайт уйдёт в работу, мы оставим пароль только на раздел /admin/. Всё покажем на этом примере.

Предполагаем, что nginx уже стоит (как его поставить). Этот способ называется basic auth: логины и пароли лежат в обычном файле на сервере.

Чем создать файл с паролями?

Команда htpasswd живёт в пакете apache2-utils. Без него система отвечает htpasswd: command not found. Ставим:

sudo apt install apache2-utils

В пакете есть команда htpasswd: она записывает логин и хеш пароля в файл. Создаём файл и первого пользователя:

sudo htpasswd -c /etc/nginx/.htpasswd anna

Ключ -c создаёт файл, anna это логин. Команда дважды спросит пароль (New password: и Re-type new password:) и ответит Adding password for user anna. В файле появится строка вида anna:$apr1$.... Сам пароль там не лежит, только его хеш, то есть необратимый отпечаток.

Почему второго пользователя нельзя добавлять с -c?

Потому что -c каждый раз создаёт файл заново. Мы добавили второго пользователя той же командой с -c, и в файле остался только он: первый пропал без предупреждения. Пользователей после первого добавляйте без ключа:

sudo htpasswd /etc/nginx/.htpasswd oleg
sudo htpasswd -D /etc/nginx/.htpasswd oleg

Первая строка добавляет oleg, вторая (-D) удаляет его: команда ответила Deleting password for user oleg. Когда в файле уже кто-то есть, ключ -c не нужен никогда.

Как включить пароль на весь сайт?

Откройте конфиг сайта. В Ubuntu у нас это /etc/nginx/sites-available/default, у вас файл может называться по домену. Внутри location / { добавьте две строки:

location / {
    auth_basic "Closed";
    auth_basic_user_file /etc/nginx/.htpasswd;
    try_files $uri $uri/ =404;
}

auth_basic включает запрос пароля, а текст в кавычках браузер покажет в окне входа. auth_basic_user_file указывает, где лежит файл. Теперь проверьте конфиг и перезагрузите nginx:

sudo nginx -t
sudo systemctl reload nginx

nginx -t ищет ошибки в конфиге и должен ответить syntax is ok и test is successful. reload применяет новый конфиг без обрыва соединений. Пока вы не сделали reload, nginx работает по старому конфигу, и сайт остаётся открытым.

Как проверить, что пароль работает?

Не открывайте сайт в браузере, где вы уже входили: он может помнить пароль. Проверьте через curl:

curl -s -o /dev/null -w "%{http_code}\n" http://127.0.0.1/
curl -s -o /dev/null -w "%{http_code}\n" -u anna:пароль http://127.0.0.1/

Первая команда печатает только код ответа. Вторая отправляет логин и пароль через -u. У нас вышло так:

Запрос Код
Без пароля 401
Неверный пароль 401
Несуществующий пользователь 401
Верный пароль 200

Код 401 значит «нужен вход». В ответе без пароля есть заголовок WWW-Authenticate: Basic realm="Closed". Если вход не удался и нужно понять почему, загляните в журналы nginx:

  • неверный пароль в /var/log/nginx/error.log выглядит как user "anna": password mismatch;
  • чужой логин там же: user "bob" was not found in "/etc/nginx/.htpasswd";
  • в access.log имя вошедшего стоит третьим полем: 127.0.0.1 - anna [...] "GET / HTTP/1.1" 200.

Откуда ошибка 500 после верного пароля?

Скорее всего, nginx не может прочитать файл. Рабочие процессы nginx в Ubuntu запускаются от пользователя www-data (строка user www-data; в /etc/nginx/nginx.conf). Если файл принадлежит root:root с правами 600, пароль введён верно, а в ответ приходит 500. В error.log у нас было: [crit] ... open() "/etc/nginx/.htpasswd" failed (13: Permission denied). Исправление:

sudo chown root:www-data /etc/nginx/.htpasswd
sudo chmod 640 /etc/nginx/.htpasswd

Первая команда отдаёт файл группе www-data, вторая разрешает группе чтение, а остальным закрывает файл целиком. После этого верный пароль снова давал 200. У файла, созданного htpasswd, права по умолчанию были 644, то есть читать его мог любой пользователь сервера. Права 640 это исправляют.

Как оставить пароль только на /admin/?

Сайт доделан и открыт, а вход в админку нужно закрыть. Уберите две строки из location / и добавьте отдельный блок:

location /admin/ {
    auth_basic "Closed";
    auth_basic_user_file /etc/nginx/.htpasswd;
}

После nginx -t и reload у нас главная отдавала 200, а /admin/ и /admin/index.html по 401. Адрес без слеша, /admin, дал 301: nginx переадресует на /admin/, и там уже просит пароль.

Почему PHP-файлы в /admin/ открылись без пароля?

Это главная ловушка, и мы на неё наступили. На сайте с PHP в конфиге есть блок location ~ \.php$. Мы положили в /admin/ файл panel.php. Адрес /admin/ по-прежнему отвечал 401, а panel.php открылся без пароля: secret php [200].

Причина в порядке выбора. nginx сначала находит самый длинный подходящий префикс, у нас это /admin/. Но если у префикса нет модификатора, nginx затем проверяет блоки с регулярными выражениями, и подошедший блок забирает запрос себе. Блок \.php$ подошёл к panel.php и забрал запрос, а пароля в нём нет.

Лечится модификатором ^~: он говорит «если префикс подошёл, регулярные выражения не проверять». PHP внутри раздела тогда обрабатывается вложенным блоком:

location ^~ /admin/ {
    auth_basic "Closed";
    auth_basic_user_file /etc/nginx/.htpasswd;

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

Вложенный location ~ \.php$ наследует пароль от внешнего блока. Путь к сокету php8.3-fpm.sock у вас может отличаться, смотрите свою версию PHP (про обновление PHP). У нас после этой правки panel.php без пароля дал 401, с паролем 200. Проверьте так каждый PHP-файл в закрытом разделе: красивый 401 на /admin/ ничего не гарантирует.

Что делать с сертификатом, если пароль на весь сайт?

Центр сертификации проверяет домен, открывая адрес /.well-known/acme-challenge/. Под паролем он тоже отдавал нам 401. Сам certbot с паролем мы не запускали, поэтому скажем осторожно: проверка домена может не пройти. Сделайте для этого адреса исключение:

location /.well-known/acme-challenge/ {
    auth_basic off;
}

auth_basic off снимает пароль только с этого пути. У нас адрес после правки отвечал 200, а главная осталась на 401. Подробнее про выпуск сертификата в статье про бесплатный SSL.

Пароль по HTTP уходит почти открытым текстом: Basic-вход кодирует его в base64, а это не шифрование. Кто перехватит такой запрос, тот прочитает пароль. Поэтому сначала настройте HTTPS, а потом ставьте пароль.

Как сменить пароль или обойтись без htpasswd?

Смена пароля делается той же командой без -c:

sudo htpasswd /etc/nginx/.htpasswd anna

Она ответила Updating password for user anna. Перезагружать nginx не нужно: файл читается при каждом запросе. У нас старый пароль сразу дал 401, новый 200.

Если пакет apache2-utils ставить не хочется, хеш делает openssl:

openssl passwd -apr1 пароль

Команда печатает хеш. В файл его пишут одной строкой: логин, двоеточие и хеш, без пробела. Проще сделать это сразу:

echo "masha:$(openssl passwd -apr1 пароль)" | sudo tee -a /etc/nginx/.htpasswd

Ключ -a у tee дописывает строку в конец и не стирает остальных. У нас вход под masha дал 200.

Что делать дальше

Копия example.ru закрыта, а когда сайт выйдет в люди, пароль останется только на /admin/. То же самое пригодится для панелей, которым нужна ещё одна защита: например, для Uptime Kuma. Для сайта на WordPress смотрите установку WordPress на VPS. Если сервера ещё нет, подберите его в каталоге VPS: там 768 тарифов от 129 ₽ в месяц, цены сверены 17 ноября 2026 года.

Команды прогнаны 27 октября 2026 года на чистой Ubuntu 24.04 с nginx 1.24.0 и PHP 8.3.