Вы переносите 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.
