Чтобы открыть локальный сайт по доменному имени, добавьте соответствие имени и IP-адреса в файл hosts и настройте VirtualHost веб-сервера. Но локальный домен сам по себе не активирует лицензию модуля. Возможность использования тестовой копии и способ её активации нужно уточнить для конкретного продукта.
Ниже — пример для Apache 2.4, установленного непосредственно на вашем компьютере, и адреса http://project.test. Для Docker, WSL, виртуальной машины или другого веб-сервера сетевые настройки будут отличаться.
| Понятие | Что оно означает | Чего оно не делает |
|---|---|---|
| Localhost / 127.0.0.1 | Обращение к текущему компьютеру через loopback | Не открывает ваш сайт внешнему сервису |
| Локальный домен | Имя, которое на вашем компьютере указывает на локальный сервер | Не регистрирует публичный домен |
| Файл hosts | Локальное соответствие имени и IP-адреса | Не меняет публичный DNS и не настраивает Apache |
| VirtualHost | Выбор сайта и каталога для запроса к определённому имени и порту | Не выдаёт лицензию и не создаёт HTTPS-сертификат |
| Лицензия модуля | Условия и механизм использования конкретного продукта | Не исправляет конфигурацию веб-сервера |
Практический порядок проверки: сначала убедитесь, что открывается нужная локальная копия, затем проверяйте сообщения модуля об активации.
Универсального ответа нет: нужно проверить правила конкретного модуля и параметры вашей лицензии. Не стоит считать, что купленная лицензия автоматически распространяется на любое количество локальных или тестовых копий.
Перед настройкой уточните у поставщика:
www, поддомен, порт или другие параметры среды;Если сайт открывается, но модуль показывает ошибку лицензии, зафиксируйте точный текст, название и версию модуля, а также адрес локальной копии. Этого достаточно для начала проверки; полный ключ в открытом сообщении не нужен.
В примере используем project.test. Зона .test зарезервирована для тестирования в RFC 2606. Имя нужно настроить локально: само название project.test не запускает сервер.
Не используйте случайный домен в реальной зоне вроде .site: он может принадлежать другому владельцу. Не подменяйте адрес рабочего магазина без конкретной необходимости — так легче перепутать тестовую и рабочую среды.
Если для тестирования требуется определённое поставщиком имя, сначала согласуйте его и правила активации.
Сохраните копию файла перед редактированием. Откройте его с правами администратора, не удаляя существующие записи.
| Система | Типичный путь |
|---|---|
| Windows | C:WindowsSystem32driversetchosts |
| Linux | /etc/hosts |
| macOS | /etc/hosts |
В Windows системный каталог может отличаться; соответствующий путь — %WinDir%System32driversetchosts. Назначение файла описано в справке Microsoft.
Добавьте строку:
127.0.0.1 project.test
В hosts указывают только IP и имя: без http://, номера порта и пути к странице. Сохраните файл именно как hosts, без расширения .txt.
Изменение действует на компьютере, где отредактирован файл. На другом ноутбуке или внутри контейнера нужны собственные настройки.
Найдите активную конфигурацию 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.
В минимальном примере выше 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.
Используйте команды именно того 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.
Откройте 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.
Запись в hosts не создаёт HTTPS. Нужны сертификат для project.test, доверие к нему на вашем компьютере и настроенный HTTPS-виртуальный хост.
Для разработки можно использовать mkcert: он создаёт локально доверенные сертификаты, но не настраивает веб-сервер вместо вас. Приватный ключ локального центра сертификации rootCA-key.pem нельзя передавать другим или добавлять в репозиторий.
Если браузер или приложение принудительно переводит сайт на HTTPS, сначала выясните источник редиректа или требования HTTPS. Игнорирование предупреждения браузера не заменяет правильную настройку сертификата.
Для внешнего сервиса localhost означает его собственную среду, а не ваш компьютер. Локальная запись hosts на вашем ПК не делает адрес доступным для CRM, платёжного сервиса или маркетплейса.
Для входящих запросов может понадобиться отдельная тестовая среда с доступным HTTPS-адресом или настроенный туннель. Проверяйте требования конкретного сервиса к callback URL, подписи запросов и тестовому режиму.
Исходящий API-запрос с локального сайта и входящий webhook — разные направления обмена. Работоспособность одного не подтверждает другого. Базовое объяснение: что такое API-интеграция.
Мы можем проверить, где возникает проблема: в локальном домене, конфигурации сервера, настройках сайта или активации модуля.
Для первого обращения отправьте:
Напишите на info@ciframe.com. После уточнения задачи согласуем объём проверки и дальнейшие действия. Условия лицензии стороннего продукта подтверждает его поставщик.
Для локального имени project.test, настроенного через hosts, публичная регистрация не нужна. Для внешней тестовой среды требования зависят от способа её размещения.
Нет. Hosts меняет локальное соответствие имени и IP. Активация зависит от механизма и правил конкретного модуля.
Для примера с project.test — нет. Изменения выполняются локально и не влияют на публичный DNS рабочего сайта.
Проверьте hosts, ServerName и подключение VirtualHost. Работоспособность стандартной страницы localhost не означает, что сервер уже настроен для другого имени.
Выясните, какая программа его использует. Для локального сервера можно выбрать другой свободный порт, согласовать его в Listen и VirtualHost и открывать сайт, например, как http://project.test:8080. Порт не добавляют в hosts.
Там сервер может работать в другой сетевой среде. Нужно проверить публикацию портов и адреса: 127.0.0.1 внутри контейнера не означает хост-компьютер. Пример рассчитан на Apache непосредственно на ПК.
Локальные файлы и база могут работать без внешнего доступа, но активация лицензии и интеграции могут требовать интернет. Это проверяют отдельно для каждого модуля и сервиса.
