2HUBS
  • DevOps

    • Полный гайд по Open Server Panel 6

    Введение

    Open Server Panel - это локальная серверная среда для разработки под Windows.

    В этой инструкции мы разберем:

    • установку Open Server Panel 6 и базовую настройку;
    • создание локального сайта;
    • установку дополнительных модулей после первоначальной установки;
    • обновление Open Server Panel до последней версии без потери проектов и баз данных.

    На момент написания статьи, версия - 6.5.1.

    1. Установка

    Скачайте дистрибутив с официального сайта: https://ospanel.io/download/

    Режим установки

    Выберите обычную установку.

    Портативную установку используйте только если планируете переносить Open Server Panel между компьютерами. После переноса всё равно нужно будет заново выполнить подготовку системы на новом ПК.

    Выбор папки установки

    Рекомендуется устанавливать Open Server Panel в корень диска (например, D:\OSPanel).

    Выбор компонентов

    Рекомендую устанавливать только базовые модули.
    Дополнительные модули при необходимости можно добавить позже — см. раздел Установка дополнительных модулей.

    Выберите «Выборочная установка» и отметьте следующие модули:

    • Панель управления
    • HTTP — Apache
    • MariaDB (последняя доступная версия)
    • PHP (версию выбирайте в зависимости от ваших требований)

    Подготовка системы

    После установки запустите System Preparation Tool.

    После завершения подготовки системы обязательно перезагрузите компьютер.

    Первый запуск

    Запустите Open Server Panel:

     1D:\OSPanel\bin\ospanel.exe

    Иконка программы должна появиться в трее Windows.

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

    2. Настройка

    Включение модулей

    Откройте контекстное меню Open Server Panel в системном трее и включите необходимые модули:

    • Модули → HTTP → Apache → Включить
    • Модули → MariaDB-<версия> → Включить
    • Модули → PHP → PHP-<версия> → Включить

    Настройка директорий проектов

    Откройте «Настройки» через контекстное меню Open Server Panel.

    Во вкладке «Программа» в поле «Каталоги для поиска проектов» укажите:

     1{root_dir}\home;D:\projects

    D:\projects - директория для хранения проектов вне OSPanel. Если она отсутствует — создайте её вручную.
    Хранение проектов вне директории OSPanel упрощает обновление программы и снижает риск потери данных.

    Глобальные настройки проектов

    Откройте «Настройки» через контекстное меню Open Server Panel.

    Во вкладке «Проекты» укажите используемые модули:

    • HTTP — выберите используемый веб-сервер (например, Apache)
    • PHP — выберите установленную версию PHP (например, PHP-8.5)

    Во вкладке «Проекты» в поле «Публичный каталог» укажите:

     1{base_dir}\www

    www - директория, в которой размещаются публичные файлы сайта. Вы можете указать любое имя папки.

    3. Создание сайта

    Проекты создаются в директории, которую мы указали ранее: D:\projects

    Создайте папку с именем сайта:

     1D:\projects\site1

    Структура проекта:

     1site1/
 2├── .osp/
 3│   └── project.ini
 4└── www/
 5    └── index.php

    ⚠️ Директория www должна совпадать с настройкой «Публичный каталог» в Open Server Panel.

    Настройка project.ini:

     1[site1.loc]

    Если Open Server Panel настроен согласно данному руководству, достаточно указать только домен (URL), по которому сайт будет доступен в браузере.

    После изменения конфигурации не забудьте перезапустить Open Server Panel.

    Установка дополнительных модулей

    Для установки дополнительных модулей запустите инсталлятор Open Server Panel повторно, снимите галочки со всех компонентов и выберите только необходимые модули.

    ⚠️ Версия установщика должна совпадать с установленной версией Open Server Panel.

    Обновление OSPanel до последней версии

    Безопасное обновление Open Server Panel без потери проектов и баз данных.

    1. Создание дампа всех баз данных

    Откройте Интерфейс командной строки через контекстное меню Open Server Panel в системном трее.

    Выберите используемую СУБД:

     1osp use MariaDB-11.8

    ⚠️ Укажите версию СУБД, установленную в Open Server Panel.
    MariaDB-<версия> или MySQL-<версия>.

    Для создания дампа всех баз данных выполните команду:

     1mysqldump -u root -p --all-databases --single-transaction --routines --triggers --events > D:\osp_db.sql

    Файл D:\osp_db.sql будет создан в корне диска D. При необходимости укажите другой путь.
    Команда работает как для MySQL, так и для MariaDB.

    2. Перенос проектов

    Закройте Open Server Panel через контекстное меню в системном трее.

    Если ваши проекты находятся в директории D:\OSPanel\home, перенесите их за пределы папки OSPanel, например в D:\projects.

    Старую версию OSPanel не удаляйте. Переименуйте папку, например: D:\OSPanel → D:\OSPanel-old.
    Это позволит сохранить рабочее окружение на случай проблем при восстановлении данных.
    При необходимости вы сможете запустить старую версию напрямую: D:\OSPanel-old\bin\ospanel.exe

    3. Установка новой версии OSPanel

    Выполните установку новой версии Open Server Panel, следуя инструкциям из разделов 1. Установка и 2. Настройка.

    4. Разворот дампа

    Откройте Интерфейс командной строки через контекстное меню Open Server Panel в системном трее.

    Выберите используемую СУБД:

     1osp use MariaDB-11.8

    ⚠️ Укажите версию СУБД, установленную в Open Server Panel.

    Импортируйте дамп:

     1mysql -u root -p < D:\osp_db.sql

    Моменты при работе с OSPanel

    Подключение базы данных

    По умолчанию для подключения к локальной базе данных используются следующие параметры:

     1Host: `MariaDB-<версия>` или `MySQL-<версия>`
 2Port: 3306
 3User: root
 4Password:

    Например, для WordPress обычно используются следующие настройки:

     1Username: root
 2Password:
 3Database Host: MariaDB-11.8:3306

    Доступ к Composer

    Open Server Panel поставляется со встроенным Composer.

    Откройте «Интерфейс командной строки» через контекстное меню в трее и выполните:

     1composer --version

    Правильный путь для Laravel

    Пример структуры проекта:

     1laravel.loc/
 2├── .osp/
 3│   └── project.ini
 4└── laravel/
 5    ├── app/
 6    ├── bootstrap/
 7    ├── config/
 8    ├── database/
 9    ├── public/
10    └── ...

    Тогда файл project.ini будет выглядеть следующим образом:

     1[laravel.loc]
 2
 3web_root        = {base_dir}\laravel\public

    Итог

    Теперь вы умеете:

    • устанавливать Open Server Panel 6 и выполнять первоначальную настройку;
    • подключать и настраивать необходимые модули PHP, MariaDB, MySQL, Apache и Nginx;
    • создавать локальные сайты и настраивать домены через project.ini;
    • работать с базами данных и подключать к ним приложения;
    • использовать Composer из встроенной командной строки OSPanel;
    • правильно настраивать Laravel-проекты и указывать публичную директорию;
    • устанавливать дополнительные модули после первоначальной установки;
    • безопасно обновлять Open Server Panel без потери проектов и баз данных.

    После выполнения всех шагов у вас будет полностью готовая локальная среда разработки для работы с PHP-проектами, WordPress, Laravel и другими веб-приложениями.