- Что такое Open Server Panel
- Что удобно в шестой версии
- Требования к компьютеру
- Скачивание и установка
- Если появляется SmartScreen
- Пройдите мастер установки
- Сертификат для локального HTTPS
- Подготовка системы
- Первый запуск и создание проекта
- Как работают модули
- Если модуль не запускается
- Создаем новый проект
- Шаг 1. Откройте каталог программы
- Шаг 2. Создайте папки
- Шаг 3. Перезапустите OSPanel
- Шаг 4. Назначьте окружение
- Где хранятся настройки
- Выбор режима работы
- Apache и PHP
- Nginx и PHP
- Caddy и PHP
- Статический сайт
- Проверьте первый проект
- Можно ли копировать example.local
- Перенос из OSPanel 5
- Базы данных и phpMyAdmin
- Откройте комплектный phpMyAdmin
- Создайте базу и пользователя
- Альтернатива: консоль
- SQL для создания базы
- Реквизиты для CMS
- Если соединение не устанавливается
- Как использовать OSPanel для разработки
- Установка CMS
- Собственный PHP-код
- Laravel, Symfony и другие приложения
- Обновления и резервные копии
- Перед обновлением
- Экспорт базы через phpMyAdmin
- Чего не стоит делать
Open Server Panel (OSPanel) — программа для локальной разработки сайтов и веб-приложений на Windows. Она позволяет запускать веб-сервер, PHP и базы данных на своем компьютере, не загружая проект на хостинг.
В этом уроке установим программу, включим нужные компоненты, создадим первый проект и проверим его в браузере. Затем разберем создание базы через phpMyAdmin и консоль.
Основной пример рассчитан на OSPanel 6.5.1. В других выпусках интерфейс и набор компонентов могут отличаться, поэтому названия модулей сверяйте со своей установленной сборкой.
Что такое Open Server Panel
OSPanel объединяет компоненты локального веб-сервера и инструменты управления ими. В зависимости от выбранной комплектации доступны Apache, Nginx, Caddy, разные версии PHP, MySQL, MariaDB, PostgreSQL и другие компоненты.
Программа подходит для обучения, разработки и проверки изменений перед публикацией. Но локальное окружение не следует без дополнительной защиты открывать в интернет.
Что удобно в шестой версии
- Проектам можно назначать разные версии компонентов.
- Настройки доступны через меню и конфигурационные файлы.
- Есть инструменты для локального HTTPS.
- В комплект входят многочисленные расширения PHP, которые включаются по необходимости.
- Есть интерфейс командной строки и журналы для диагностики.
- Доступна бесплатная загрузка дистрибутива.
Совместимость с CMS или фреймворком зависит от конкретных версий PHP, базы и расширений. Не стоит считать любой набор компонентов подходящим для каждого проекта.
Подробные параметры описаны в документации OSPanel.
Требования к компьютеру
Перед загрузкой проверьте:
- Windows 10 / Windows Server 2016 или новее.
- 64-битную операционную систему.
- Процессор с поддержкой SSE4.2.
- Минимум 4 ГБ свободной RAM и 15 ГБ места на SSD.
- Файловую систему NTFS для каталога программы.
Сетевые диски не поддерживаются. USB-флешка и медленный внешний накопитель также не являются удачным выбором: работа с большим количеством файлов может заметно замедляться.
Актуальная ветка не рассчитана на Windows 7/8 и 32-битные системы. Совместимость архивных выпусков проверяйте отдельно, они больше не поддерживаются разработчиком.
Скачивание и установка
Откройте официальную страницу загрузки и скачайте актуальный дистрибутив.

На сайте есть бесплатная загрузка и платная услуга быстрой загрузки. Бесплатный вариант может потребовать ожидания, скорость зависит от условий загрузки.
Перед запуском убедитесь, что файл получен с официального сайта. Для проверки целостности сравните его SHA256 с опубликованным значением для этого выпуска.
Если появляется SmartScreen
Windows может показать предупреждение о неизвестном приложении. Не обходите его автоматически: сначала проверьте источник и файл.
Предупреждение о репутации приложения и обнаружение вредоносного содержимого — разные ситуации. Если защита сообщает об угрозе, остановитесь и проверьте ее причину, а не отключайте антивирус.

Пройдите мастер установки
После запуска проверенного установщика откроется мастер.

Нажмите «Далее» и последовательно выберите параметры.

- Для работы на одном компьютере выберите обычную установку. Портативная нужна для переносного окружения, но подходящий SSD предпочтительнее обычной USB-флешки.
- Прочитайте и примите лицензионные условия.
- Укажите каталог, например C:\OSPanel или D:\OSPanel. Для простого примера не используйте кириллицу и пробелы в пути.
- Выберите нужные компоненты. Необязательные старые версии можно не устанавливать, если они не требуются вашим проектам.
- Настройте создание ярлыков.
Я использую каталог в корне диска. Если выбираете другой путь, проверьте допустимые символы и требования в документации.
На экране дополнительных задач прочитайте выбранные пункты. Ярлыки настраивайте по своему усмотрению.

Запустите установку и дождитесь завершения. Время зависит от выбранных компонентов и скорости накопителя.

Сертификат для локального HTTPS
Установщик может предложить добавить корневой сертификат OSPanel. Подтверждайте это только для проверенного дистрибутива, понимая, что добавляете доверенный центр сертификации для локального окружения.

Доверие зависит от настроек Windows и браузера. Для браузера, который не использует системное хранилище сертификатов, может понадобиться отдельный импорт по инструкции OSPanel.
Подготовка системы
На завершающем экране запустите инструмент подготовки системы, если это первая установка.

Для System Preparation Tool нужны права администратора. Если Windows запрашивает разрешение, проверьте, что запрос относится к запущенному инструменту OSPanel.

Выполните подготовку по подсказкам. В комплект входит необходимое системное ПО, в том числе библиотеки Microsoft Visual C++. После завершения перезагрузите компьютер.
Саму OSPanel для обычной работы запускать от администратора не нужно: разработчик этого не рекомендует.
Первый запуск и создание проекта
Запустите программу через меню «Пуск» или ярлык, если выбрали его создание.

Также программу можно запустить из установленного каталога. Для портативного варианта документация указывает файл bin\ospanel.exe.
После запуска найдите значок в области уведомлений Windows рядом с часами. Если он скрыт, раскройте список дополнительных значков.

Как работают модули
В OSPanel 6 проекту назначаются нужные компоненты. Разные сайты могут использовать разные PHP-модули и другие доступные компоненты.
При запуске программа инициализирует модули: проверяет настройки и готовит служебные файлы. Но это не означает, что все модули включены. По умолчанию их нужно включить отдельно.
Если повторная инициализация требуется после изменения настроек, выполняйте ее для остановленного модуля. Активный модуль сначала нужно остановить.

Для своих проектов на MODX и WordPress я использую Apache и Nginx, PHP 7.4 для части старых проектов MODX 2, PHP 8.2 для отдельных проектов MODX 3, PHP 8.5 для WordPress и MySQL 8.4.
Это мое окружение, а не универсальная рекомендация. Старые версии PHP нужны здесь для совместимости конкретных проектов. Для нового сайта проверяйте требования CMS и выбирайте поддерживаемые компоненты.
Одновременно включать все установленные модули не нужно. Особенно на компьютере с ограниченной оперативной памятью.
Если модуль не запускается
В моей установке модули иногда не запускаются с первой попытки и начинают работать после отдельного перезапуска. Поэтому я проверяю их состояние.
Перезапуск может восстановить работу, но не объясняет причину. Если ошибка повторяется:
- Откройте журнал проблемного модуля.
- Проверьте выбранный профиль и конфигурацию.
- Убедитесь, что необходимые компоненты установлены.
- Проверьте возможный конфликт порта или ограничения доступа.
- Сохраните текст ошибки, если нужна дальнейшая диагностика.
В меню программы откройте «Интерфейс командной строки». Общее состояние и журнал можно посмотреть командами:
osp status
osp log general
Команды выполняйте в подготовленном интерфейсе OSPanel. Согласно документации, PowerShell для этой работы не поддерживается. В Windows Terminal выбирайте профиль командной строки, а не PowerShell.
Address already in use указывает на занятый адрес или порт. Permission denied означает отказ в доступе. Не пытайтесь исправить любую ошибку отключением защиты.
Если модули работают, но локальный домен не открывается, отдельно проверьте VPN, прокси и защищенный DNS. Настраивайте необходимые исключения для локального окружения, а не отключайте защиту всей системы.
Создаем новый проект
Для примера создадим wordpress.local. Этим же способом можно подготовить другую CMS или обычный PHP-проект.
Адрес используется локально. Покупать домен у регистратора не требуется.
Шаг 1. Откройте каталог программы
Через меню OSPanel откройте корневой каталог.

Найдите папку home. Здесь размещаются пользовательские проекты. В комплектной сборке также могут находиться example.local, phpmyadmin и другие стартовые проекты.
Не создавайте новый сайт внутри phpmyadmin или другого работающего проекта.
Шаг 2. Создайте папки
- Откройте home.
- Создайте папку wordpress.local.
- Внутри нее создайте пустую папку .osp.
В начале имени .osp обязательно стоит точка.

Если программа установлена в D:\OSPanel, путь получится таким:
D:\OSPanel\home\wordpress.local\.osp
В актуальной ветке для быстрого создания проекта достаточно пустого каталога .osp. После обнаружения программа добавит базовые файлы настроек.
Шаг 3. Перезапустите OSPanel
После создания структуры перезапустите программу, чтобы она обнаружила проект.

Найдите wordpress.local в меню проектов. Если его нет, проверьте расположение папки и имя .osp.
Имена .osp, osp и .osp.txt различаются. Не создавайте несколько похожих каталогов вместо одного правильного.
Шаг 4. Назначьте окружение
Откройте меню проекта и выберите компоненты.

В нашем примере:
- HTTP: Apache.
- PHP: PHP-8.5.

Затем выберите «Включить модули проекта». Используйте точные названия, которые показывает установленная сборка.
Для существующего сайта версии подбирайте с учетом рабочего хостинга и требований приложения.
Зеленая индикация показывает состояние проекта или компонентов, но не доказывает, что CMS установлена и все функции сайта работают. Проверку выполним отдельно.
Где хранятся настройки
Конфигурация проекта находится в .osp/project.ini. После изменения через меню программа записывает выбранные значения и дополнительные параметры.
В моем автоматически созданном файле много строк со значением auto. Это нормально: такие параметры не нужно менять только потому, что они выглядят незаполненными.
Ниже показан фрагмент, а не весь файл:
[wordpress.local]
http_engine = Apache
php_engine = PHP-8.5
Остальные строки существующей конфигурации оставьте на месте. Не заменяйте полный файл этим сокращенным примером.
| Параметр | Назначение |
|---|---|
| [wordpress.local] | Домен проекта. |
| http_engine | Выбранный веб-сервер. |
| php_engine | Модуль PHP. |
| environment | Дополнительные компоненты окружения проекта. |
| project_root | Корневой каталог проекта. |
| web_root | Публичный каталог, из которого выдаются файлы. |
Выбор HTTP и PHP не создает базу и пользователя. Их подготовим в следующем разделе.
Если в среде проекта нужны дополнительные модули, например MySQL, можно указать:
environment = MySQL-8.4
Если компоненты уже перечислены, сохраняйте нужные значения. Названия указываются через пробел. После изменения перезапустите OSPanel и заново откройте консоль проекта.
environment не заменяет имя базы, пароль и адрес подключения в CMS. Сам сервер базы также должен быть включен.
При ручном редактировании сохраняйте назначение остальных параметров. Проверьте расширение файла: нужен project.ini, а не project.ini.txt.
Выбор режима работы
Веб-сервер и PHP выбираются отдельно. Не переносите в актуальную сборку старые примеры с nginx_engine и отдельными PHP-FCGI-модулями.
Ниже приведены фрагменты настроек. Для первого проекта достаточно одного варианта.
Apache и PHP
[wordpress.local]
http_engine = Apache
php_engine = PHP-8.5
Это основной вариант нашего примера. Если приложение использует .htaccess, проверьте его требования к Apache и разрешенным директивам.
Nginx и PHP
[wordpress.local]
http_engine = Nginx
php_engine = PHP-8.5
Nginx не обрабатывает .htaccess. Правила маршрутизации и другие настройки нужно задавать подходящим для него способом.
Не переключайте сервер только ради предполагаемого ускорения. Важнее совместимость приложения и понятная конфигурация.
Caddy и PHP
[wordpress.local]
http_engine = Caddy
php_engine = PHP-8.5
Это еще один вариант окружения. При переходе с другого сервера проверьте правила и работу приложения.
Статический сайт
Если проект состоит из HTML, CSS, JavaScript и изображений, обработчик PHP ему не нужен.
Через меню выберите веб-сервер и вариант без обработки PHP. Сохраните настройки и проверьте обычный index.html.
Не считайте php_engine = auto отключением PHP. Для ручной настройки используйте значение, которое записывает ваша версия программы после выбора статического режима.
База данных такому простому примеру тоже не нужна. JavaScript, выполняющийся в браузере, не требует PHP-модуля.
Проверьте первый проект
Пустая папка еще не является сайтом. Добавим файл, который покажет, работает ли PHP.
Проверьте публичный каталог проекта. Если это корень wordpress.local, создайте index.php в нем. Если используется public, файл должен находиться внутри public.
Содержимое index.php:
<?php
echo 'Проект работает. PHP ' . PHP_VERSION;
Сохраните файл и убедитесь, что он не называется index.php.txt.
Откройте проект через меню OSPanel или введите в браузере:
http://wordpress.local/
Если появилась фраза «Проект работает» и версия PHP, запрос прошел через веб-сервер и выбранный PHP-модуль.

Если браузер показывает исходный PHP-код или предлагает скачать файл, проверьте способ открытия, назначение PHP и конфигурацию сервера. Не размещайте в таком проекте конфиденциальные PHP-файлы до исправления обработки.
Если открывается другая страница, проверьте публичный каталог и оставшиеся демонстрационные файлы.
Не открывайте index.php двойным щелчком в Проводнике. Так вы не проверите выполнение через сервер.
Можно ли копировать example.local
Можно, но для первого проекта проще создать отдельную папку и выбрать окружение через меню.
При копировании:
- Переименуйте папку.
- Проверьте домен в project.ini.
- Проверьте выбранные модули и публичный каталог.
- Удалите ненужные демонстрационные файлы.
- Перезапустите программу и откройте новый проект.
Не копируйте готовый сайт без проверки его реквизитов. Он может продолжить использовать прежнюю базу, ключи и другие ресурсы.
Перенос из OSPanel 5
Перенос не ограничивается копированием папки из domains в home. В новой ветке отличаются структура проектов и настройка компонентов.
Сохраните файлы и экспортируйте базу. Затем создайте новый проект, выберите совместимое окружение, разместите файлы и настройте подключение к импортированной базе.
Проверьте главную, внутренние страницы, вход в CMS и сохранение изменений. Старое окружение не удаляйте до завершения проверки.
Базы данных и phpMyAdmin
Для большинства CMS нужна база: в ней хранятся записи, страницы, пользователи и настройки. Файлы проекта и база — разные части сайта.
В первых выпусках OSPanel 6 комплектного phpMyAdmin не было. Начиная с 6.4.5 в сборку добавлен стартовый проект с предустановленным phpMyAdmin.
Сначала покажу браузерный интерфейс, затем консольную альтернативу. Выполнять оба способа создания одной базы не нужно.
Откройте комплектный phpMyAdmin
- Включите нужный сервер базы данных.
- Найдите проект phpmyadmin в меню проектов.
- Назначьте ему работающие HTTP и PHP, если они еще не выбраны.
- Включите модули проекта.
- Откройте phpMyAdmin в браузере.

На странице входа выберите сервер, с которым будет работать сайт.

Если сайт использует MySQL-8.4, создавайте базу именно на нем. База на другом MySQL или MariaDB не становится автоматически доступной выбранному серверу.
Войдите с административной учетной записью своей локальной конфигурации. В исходных настройках модулей пароль может отсутствовать. Если вы уже установили пароль, вводите его.
Не переносите пример root без пароля на публичный хостинг. Он относится к локальному окружению.
Создайте базу и пользователя
Для CMS лучше использовать отдельную учетную запись, а не root.
- Откройте «Учетные записи пользователей».
- Выберите добавление новой учетной записи.

Заполните поля:
- Имя пользователя: например, wr1.
- Хост: localhost для стандартного локального подключения в нашем примере.
- Пароль: ваш собственный надежный пароль.
- Подтверждение: тот же пароль.
Выберите создание базы с именем пользователя и предоставление прав на нее. Глобальные привилегии не отмечайте.

Сохраните учетную запись. В этом варианте и база, и пользователь называются wr1.
Проверьте наличие базы и запишите реквизиты. Если имя занято, не удаляйте существующую учетную запись или базу наугад: выберите другое имя либо выясните, для какого проекта они используются.
Альтернатива: консоль
Если предпочитаете команды, откройте консоль нужного модуля через меню OSPanel. Ниже сохранены снимки прежнего примера с MariaDB, названия модулей в текущей установке могут отличаться.

Для MySQL-8.4 используйте:
mysql -h MySQL-8.4 -u root -p
Команду выполняйте в подготовленной среде модуля, где доступен клиент mysql. Если имя модуля другое, замените его.
Параметр -p включает запрос пароля. Для учетной записи без пароля нажмите Enter, иначе введите установленный пароль.

После успешного подключения появится приглашение клиента. Теперь можно вводить SQL.

SQL для создания базы
Если базу и пользователя уже создали через phpMyAdmin, этот шаг пропустите.
В консольном варианте создадим базу wr1 и пользователя wr1_user. Замените REPLACE_WITH_YOUR_PASSWORD на свой пароль, сохранив одинарные кавычки.
CREATE DATABASE wr1
CHARACTER SET utf8mb4
COLLATE utf8mb4_unicode_ci;
CREATE USER 'wr1_user'@'localhost'
IDENTIFIED BY 'REPLACE_WITH_YOUR_PASSWORD';
GRANT ALL PRIVILEGES ON wr1.*
TO 'wr1_user'@'localhost';
SHOW GRANTS FOR 'wr1_user'@'localhost';
EXIT;
Команды создают базу и пользователя, выдают права только на wr1, показывают назначенные права и закрывают клиент.
Выполняйте их по очереди. Если появилась ошибка, сначала разберитесь с ней.
Не заменяйте wr1.* на *.*: одному сайту не нужны права на все базы сервера.
Для простого ручного примера не используйте в пароле одинарную кавычку и обратную косую черту: они требуют правильного экранирования в SQL. Это ограничение примера, а не самой базы.
Реквизиты для CMS
| Поле | Через phpMyAdmin | Через консоль |
|---|---|---|
| База данных | wr1 | wr1 |
| Пользователь | wr1 | wr1_user |
| Пароль | Пароль соответствующего пользователя. | |
| Сервер | MySQL-8.4, если база создана на этом модуле. | |
Для стандартного окружения OSPanel 6 адрес сервера базы задается именем модуля. Не копируйте localhost из инструкций пятой ветки.
При этом localhost в SQL-записи ‘wr1_user’@’localhost’ определяет учетную запись и источник подключения. Это не поле адреса сервера в CMS.

Для MariaDB используйте имя выбранного модуля MariaDB. Основные команды похожи, но это не означает полной взаимозаменяемости СУБД.
Если соединение не устанавливается
- Проверьте состояние сервера базы.
- Перепроверьте его имя в подключении.
- Убедитесь, что база создана именно на нем.
- Проверьте пользователя, пароль и права на нужную базу.
- Посмотрите точное сообщение об ошибке.
Access denied связан с отказом в доступе, а Unknown server host — с разрешением имени. Не исправляйте обе ситуации выдачей глобальных прав.
При Access denied проверьте также хост учетной записи, указанный в сообщении сервера. Не меняйте его на доступ отовсюду только ради быстрого обхода ошибки.
Для ранних выпусков OSPanel 6 или отдельной конфигурации может пригодиться урок по phpMyAdmin. В актуальной сборке сначала проверьте комплектный проект.
Как использовать OSPanel для разработки
Установка CMS
Общий порядок: выбрать совместимые компоненты, разместить файлы в публичном каталоге, подготовить базу и выполнить установку системы.
Для нового проекта проверяйте требования конкретной версии CMS и дополнений. Если система сообщает об отсутствующем расширении PHP, включите именно нужное расширение в соответствующем PHP-модуле и перезапустите его.
Не включайте все расширения подряд и не меняйте порядок их подключения без необходимости.
Подробный пример вынесен в инструкцию установки WordPress на OpenServer. Здесь его шаги не повторяем.
Собственный PHP-код
Редактируйте файлы удобным редактором или IDE, а результат открывайте по локальному адресу.
Проверяйте журнал и используемую версию PHP. Код в консоли может выполняться в другой среде, если ее не переключили на нужный проект.
Для активации среды нашего проекта в CLI можно использовать:
osp project wordpress.local
После этого проверьте нужные команды и компоненты окружения.
Laravel, Symfony и другие приложения
Для фреймворка сначала прочитайте требования выбранной версии. Простого копирования файлов может быть недостаточно: могут понадобиться зависимости Composer, настройки окружения и дополнительные команды.
Обратите внимание на публичный каталог. Часто это public, а не корень всего проекта. Конфигурация и секреты не должны случайно выдаваться браузеру.
Параметры задавайте предусмотренным приложением способом, например через .env. Не копируйте чужой файл с действующими ключами и паролями.
Обновления и резервные копии
Локальное окружение тоже требует сопровождения. Новая версия компонентов может исправить ошибки, но изменить совместимость проекта.
Перед обновлением
- Сохраните файлы и конфигурацию проектов.
- Экспортируйте важные базы.
- Запишите используемые версии компонентов.
- Прочитайте изменения выбранного выпуска.
- Проверьте обновление на копии важного проекта.
Не рассчитывайте, что каталог данных старой базы без подготовки заработает с любой новой версией MySQL или MariaDB.
Экспорт базы через phpMyAdmin
- Подключитесь к нужному серверу.
- Выберите базу проекта.
- Откройте «Экспорт».
- Выберите подходящие параметры и формат SQL.
- Сохраните выгрузку вне публичного каталога сайта.
Для простого проекта можно начать с быстрого экспорта. Для сложной базы проверьте включение необходимых объектов и параметры выгрузки.
Желательно проверить восстановление в отдельную тестовую базу. Наличие скачанного файла еще не доказывает, что резервная копия пригодна для восстановления.
Одна папка сайта без базы не сохраняет весь проект. Один SQL-файл без изображений, кода и настроек тоже не является полной копией.
Чего не стоит делать
- Отключать защиту Windows ради запуска неизвестного файла.
- Выдавать каждому сайту глобальные права базы.
- Удалять или блокировать root без проверки зависимостей.
- Открывать phpMyAdmin и базу в интернет для локального тестирования.
- Переключать веб-сервер без проверки конфигурации приложения.
- Рекомендовать архивную OSPanel 5 для нового окружения без учета ограничений.
Запускайте нужные компоненты, проверяйте журналы и меняйте настройки по конкретной причине. Для локальной разработки важнее понятное и воспроизводимое окружение, чем максимальное количество модулей.
Если выбираете другой инструмент, есть отдельный материал о XAMPP. Его настройка отличается от OSPanel, поэтому инструкции не следует смешивать.











