Wiki помощь: Как настроить домен для localhost и проверить лицензию модуля

Чтобы открыть локальный сайт по доменному имени, добавьте соответствие имени и IP-адреса в файл hosts и настройте VirtualHost веб-сервера. Но локальный домен сам по себе не активирует лицензию модуля. Возможность использования тестовой копии и способ её активации нужно уточнить для конкретного продукта.

Ниже — пример для Apache 2.4, установленного непосредственно на вашем компьютере, и адреса http://project.test. Для Docker, WSL, виртуальной машины или другого веб-сервера сетевые настройки будут отличаться.

Localhost, локальный домен и лицензия: в чём разница?

Понятие Что оно означает Чего оно не делает
Localhost / 127.0.0.1 Обращение к текущему компьютеру через loopback Не открывает ваш сайт внешнему сервису
Локальный домен Имя, которое на вашем компьютере указывает на локальный сервер Не регистрирует публичный домен
Файл hosts Локальное соответствие имени и IP-адреса Не меняет публичный DNS и не настраивает Apache
VirtualHost Выбор сайта и каталога для запроса к определённому имени и порту Не выдаёт лицензию и не создаёт HTTPS-сертификат
Лицензия модуля Условия и механизм использования конкретного продукта Не исправляет конфигурацию веб-сервера

Практический порядок проверки: сначала убедитесь, что открывается нужная локальная копия, затем проверяйте сообщения модуля об активации.

Нужна ли отдельная лицензия для localhost или тестового домена?

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

Перед настройкой уточните у поставщика:

  • поддерживаются ли локальная разработка и staging;
  • нужно ли согласовать дополнительный домен или получить тестовый ключ;
  • учитываются ли www, поддомен, порт или другие параметры среды;
  • требуется ли соединение с сервером активации;
  • как переносить активацию после смены домена или сервера.

Если сайт открывается, но модуль показывает ошибку лицензии, зафиксируйте точный текст, название и версию модуля, а также адрес локальной копии. Этого достаточно для начала проверки; полный ключ в открытом сообщении не нужен.

Какой домен выбрать для локального сайта?

В примере используем project.test. Зона .test зарезервирована для тестирования в RFC 2606. Имя нужно настроить локально: само название project.test не запускает сервер.

Не используйте случайный домен в реальной зоне вроде .site: он может принадлежать другому владельцу. Не подменяйте адрес рабочего магазина без конкретной необходимости — так легче перепутать тестовую и рабочую среды.

Если для тестирования требуется определённое поставщиком имя, сначала согласуйте его и правила активации.

Шаг 1. Добавьте локальный домен в hosts

Сохраните копию файла перед редактированием. Откройте его с правами администратора, не удаляя существующие записи.

Система Типичный путь
Windows C:WindowsSystem32driversetchosts
Linux /etc/hosts
macOS /etc/hosts

В Windows системный каталог может отличаться; соответствующий путь — %WinDir%System32driversetchosts. Назначение файла описано в справке Microsoft.

Добавьте строку:

127.0.0.1 project.test

В hosts указывают только IP и имя: без http://, номера порта и пути к странице. Сохраните файл именно как hosts, без расширения .txt.

Изменение действует на компьютере, где отредактирован файл. На другом ноутбуке или внутри контейнера нужны собственные настройки.

Шаг 2. Настройте VirtualHost для Apache 2.4

Найдите активную конфигурацию Apache. В разных сборках это может быть httpd.conf, подключённый файл с виртуальными хостами или каталог sites-available. Важно, чтобы созданный файл действительно подключался к конфигурации сервера.

Пример для локального каталога /var/www/project/public:

<VirtualHost 127.0.0.1:80>     ServerName project.test     DocumentRoot "/var/www/project/public"      <Directory "/var/www/project/public">         Options -Indexes         AllowOverride None         Require local     </Directory> </VirtualHost>

Замените оба пути на фактический публичный каталог сайта. В Windows это может быть C:/sites/project/public. Каталог public есть не в каждом проекте: укажите тот, где находится точка входа сайта.

ServerName задаёт имя, а DocumentRoot — каталог. Подробнее: именные VirtualHost в Apache.

Require local предназначен для локального доступа; правила описаны в документации mod_authz_host. Этот пример не предназначен для публичного staging или доступа коллег из сети.

Проверьте Listen. VirtualHost не заставляет Apache слушать порт. Для отдельного локального экземпляра можно использовать:

Listen 127.0.0.1:80

Не добавляйте эту строку поверх существующего Listen 80: сначала проверьте активные директивы и устраните пересечения. Изменение Listen влияет на весь экземпляр сервера, поэтому не применяйте его без проверки к конфигурации с другими сайтами. См. настройку адресов и портов Apache.

Если сайт использует .htaccess

В минимальном примере выше AllowOverride None отключает обработку .htaccess. Для CMS с правилами маршрутизации нужно разрешить необходимые директивы или перенести их в конфигурацию VirtualHost.

Для правил RewriteEngine / RewriteRule обычно нужны mod_rewrite и разрешение класса FileInfo. Если .htaccess содержит другие директивы, проверьте их отдельно. Не заменяйте значение на All только ради того, чтобы скрыть ошибку. Подробнее: как Apache обрабатывает .htaccess.

Не смешивайте старые Order allow,deny и Allow from all с современным Require: Apache не рекомендует такую конфигурацию. Источник: переход с Apache 2.2 на 2.4.

Шаг 3. Проверьте конфигурацию и перезапустите сервер

Используйте команды именно того Apache, который обслуживает ваш сайт.

Для Debian/Ubuntu с установленным пакетом Apache:

sudo apache2ctl configtest sudo apache2ctl -S

Первая команда проверяет синтаксис, вторая показывает конфигурацию виртуальных хостов. Если проверка успешна, перезапустите локальный сервер:

sudo systemctl restart apache2

В Windows, в каталоге с httpd.exe вашей сборки:

httpd.exe -t httpd.exe -S

После успешной проверки перезапустите Apache через панель локальной среды или его службу. В macOS способ зависит от установленной сборки; systemctl не является универсальной командой для macOS.

Параметры -t и -S описаны в официальной справке httpd.

Шаг 4. Убедитесь, что открывается именно локальная копия

Откройте http://project.test и проверьте признак тестовой среды: например, заметную надпись «Локальная копия». Для работы с копией используйте отдельную базу данных и отключите задания отправки реальных сообщений, платежей и синхронизации с рабочими системами.

Для проверки HTTP-ответа можно выполнить:

curl -I http://project.test

Если нужно проверить VirtualHost независимо от hosts:

curl --noproxy "*" --resolve project.test:80:127.0.0.1 -I http://project.test

В Windows PowerShell при необходимости используйте curl.exe. Параметр --resolve задаёт адрес только для этого запроса, не изменяя hosts; --noproxy исключает влияние прокси на тест. См. справку curl.

Не каждое приложение поддерживает HEAD-запросы, которые отправляет -I. Если получили 405, проверьте обычный GET без -I. Ответ 200 сам по себе также не подтверждает активацию модуля.

Что делать, если локальный домен не работает?

Симптом Что проверить сначала
Имя не находится Правильность hosts, отсутствие .txt, сохранение файла, кеш и прокси
Connection refused Запущен ли Apache, слушает ли нужный адрес и порт
Открывается другой сайт ServerName, подключение файла VirtualHost, результат -S
403 Forbidden Directory, права чтения каталога, правила доступа, журнал Apache
Главная работает, внутренние страницы дают 404 Маршрутизацию CMS, mod_rewrite, правила .htaccess
Перенаправление на рабочий домен Базовый URL CMS, редиректы в конфигурации и плагинах
Ошибка сертификата Соответствие сертификата имени и доверие к его издателю
Сайт работает, модуль пишет «лицензия недействительна» Условия тестовой активации, домен и точный текст ошибки

При HTTP 500 изучите журналы веб-сервера и приложения. Это отдельный диагностический сценарий; см. что делать с ошибкой 500.

Как включить HTTPS для локального домена?

Запись в hosts не создаёт HTTPS. Нужны сертификат для project.test, доверие к нему на вашем компьютере и настроенный HTTPS-виртуальный хост.

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

Если браузер или приложение принудительно переводит сайт на HTTPS, сначала выясните источник редиректа или требования HTTPS. Игнорирование предупреждения браузера не заменяет правильную настройку сертификата.

Почему webhook не приходит на localhost?

Для внешнего сервиса localhost означает его собственную среду, а не ваш компьютер. Локальная запись hosts на вашем ПК не делает адрес доступным для CRM, платёжного сервиса или маркетплейса.

Для входящих запросов может понадобиться отдельная тестовая среда с доступным HTTPS-адресом или настроенный туннель. Проверяйте требования конкретного сервиса к callback URL, подписи запросов и тестовому режиму.

Исходящий API-запрос с локального сайта и входящий webhook — разные направления обмена. Работоспособность одного не подтверждает другого. Базовое объяснение: что такое API-интеграция.

CiFrame поможет проверить локальную копию и работу интеграции

Мы можем проверить, где возникает проблема: в локальном домене, конфигурации сервера, настройках сайта или активации модуля.

Для первого обращения отправьте:

  • название и версию CMS и модуля;
  • операционную систему и локальную среду;
  • адрес, по которому открываете копию;
  • точный текст ошибки или скриншот без секретных данных;
  • желаемый результат: локальное тестирование, staging или перенос.

Напишите на info@ciframe.com. После уточнения задачи согласуем объём проверки и дальнейшие действия. Условия лицензии стороннего продукта подтверждает его поставщик.

Проверить тестовую среду

Частые вопросы

Нужно ли покупать домен для localhost?

Для локального имени project.test, настроенного через hosts, публичная регистрация не нужна. Для внешней тестовой среды требования зависят от способа её размещения.

Достаточно ли изменить hosts, чтобы модуль принял лицензию?

Нет. Hosts меняет локальное соответствие имени и IP. Активация зависит от механизма и правил конкретного модуля.

Нужно ли менять DNS рабочего домена?

Для примера с project.test — нет. Изменения выполняются локально и не влияют на публичный DNS рабочего сайта.

Почему localhost работает, а project.test — нет?

Проверьте hosts, ServerName и подключение VirtualHost. Работоспособность стандартной страницы localhost не означает, что сервер уже настроен для другого имени.

Что делать, если порт 80 занят?

Выясните, какая программа его использует. Для локального сервера можно выбрать другой свободный порт, согласовать его в Listen и VirtualHost и открывать сайт, например, как http://project.test:8080. Порт не добавляют в hosts.

Почему пример не работает в Docker или WSL?

Там сервер может работать в другой сетевой среде. Нужно проверить публикацию портов и адреса: 127.0.0.1 внутри контейнера не означает хост-компьютер. Пример рассчитан на Apache непосредственно на ПК.

Можно ли работать полностью без интернета?

Локальные файлы и база могут работать без внешнего доступа, но активация лицензии и интеграции могут требовать интернет. Это проверяют отдельно для каждого модуля и сервиса.

CiFrame Contacts
Бесплатная консультация
Сделайте первый шаг

Не нашли нужной информации? Остались вопросы? Напишите нам. Ответим на ваши вопросы, оценим вашу интеграцию