Как да добавите домейн към cPanel: Пълно техническо ръководство

Добавянето на домейн към cPanel означава регистриране на допълнително домейн име в контролния панел на хостинга, така че сървърът да знае къде да насочва входящите заявки и откъде да обслужва файловете. В cPanel това се управлява чрез интерфейса Domains или Addon Domains, който създава специална директория за документи, конфигурира записа за виртуален хост и по желание настройва поддомейн за вътрешно управление — всичко в един работен процес.

Това ръководство обхваща всяка стъпка от този процес в техническа дълбочина: от DNS предпоставките и конфигурацията на домейна в cPanel, през разгръщането на файлове чрез File Manager, до осигуряването на MySQL база данни. То се прилага директно към всяка среда VPS с cPanel, включително AlexHost VPS инстанции, работещи с LiteSpeed и NVMe съхранение.

Предпоставки преди добавяне на домейн в cPanel

Пропускането на DNS стъпката е най-честата причина новодобавен домейн да не се резолвира. Преди да докосвате cPanel, потвърдете следното:

• DNS разпространението е в ход или завършено. A записът на вашия домейн трябва да сочи към публичния IP адрес на сървъра. Разпространението обикновено отнема между 15 минути и 48 часа в зависимост от регистратора и стойностите на TTL.
• Вашият cPanel акаунт разполага с налични слотове за addon домейни. На VPS с root достъп и WHM, това се контролира за всеки акаунт поотделно в „Modify an Account.” При споделени планове зависи от хостинг пакета.
• Притежавате или контролирате домейна. Ако сте го регистрирали другаде, трябва да имате достъп до DNS управляващия панел на регистратора. Ако имате нужда от нов домейн, регистрацията на домейн чрез AlexHost поддържа DNS управлението централизирано.
• SSL е планиран от самото начало. Правилният ред е първо да добавите домейна, след това да заявите сертификат. AutoSSL в cPanel ще се опита да издаде сертификат автоматично, след като домейнът се резолвира към сървъра.

Стъпка 1: Добавяне на домейна в cPanel

Влезте в своя cPanel акаунт (обикновено на yourdomain.com:2083 или чрез линка „Go to cPanel” в WHM).

Навигиране до интерфейса за управление на домейни

В модерната тема Jupiter на cPanel работният процес за управление на домейни е консолидиран:

1. От началния екран на cPanel намерете секцията Domains.
2. Кликнете върху Domains (унифицираният интерфейс, въведен в cPanel 76+, който замества по-старите отделни икони „Addon Domains,” „Subdomains” и „Aliases”).
3. Кликнете бутона Create A New Domain в горния десен ъгъл.

Конфигуриране на новия запис за домейн

Ще видите формуляр със следните полета:

• Domain: Въведете напълно квалифицираното домейн име, например example.com. Не включвайте www — cPanel обработва псевдонима на поддомейна www автоматично.
• Document Root: cPanel автоматично попълва това поле въз основа на домейн името, обикновено резолвирайки до /home/username/public_html/example.com. Можете да замените този път, но стойността по подразбиране е подходяща за повечето разгръщания.
• Отметка „Share document root with main domain”: Оставете я без отметка, освен ако умишлено не искате този домейн да обслужва същите файлове като основния ви домейн. Поставянето на отметка е честа грешка, която кара двата домейна да показват идентично съдържание.

Кликнете Submit (или Add Domain в зависимост от версията на cPanel). cPanel ще:

• Създаде директорията за документи.
• Запише нов конфигурационен блок за виртуален хост на Apache или LiteSpeed.
• Създаде запис за поддомейн (напр. example.com.yourmainaccount.com) за вътрешно маршрутизиране.
• Добави домейна в опашката за SSL/TLS, ако AutoSSL е активиран.

Проверка дали домейнът е добавен правилно

След подаването се върнете към списъка Domains. Новият запис трябва да се появи с пътя до директорията за документи и опция за управление на DNS. Ако използвате вградените nameserver-и на cPanel, кликнете Manage до домейна, за да прегледате DNS зоната и да потвърдите, че A записът сочи към правилния IP.

Стъпка 2: Качване на файловете на уебсайта чрез File Manager

След конфигурирането на домейна сървърът е готов да обслужва съдържание от директорията за документи. Следващата стъпка е разгръщането на файловете на вашия уебсайт.

Достъп до File Manager

1. От началния екран на cPanel отворете File Manager в секцията Files.
2. В дървото с директории вляво навигирайте до public_html/ и след това в папката, кръстена на вашия домейн (напр. example.com/).
3. Алтернативно, File Manager се отваря по подразбиране на public_html — можете да навигирате оттам.

Качване на файлове като архив

File Manager на cPanel налага метод на качване, който изисква файловете да бъдат пакетирани в архивен формат. Качването на отделни файлове един по един е бавно и при много сървърни конфигурации е ограничено по причини, свързани с производителността.

Поддържани архивни формати за извличане:

• .zip
• .tar.gz / .tgz
• .tar.bz2
• .gz

Правилната процедура за качване:

1. Компресирайте файловете на уебсайта си локално в архив .zip. За WordPress инсталация това означава компресиране на цялото съдържание на директорията на сайта (не самата папка, освен ако не искате допълнително ниво на поддиректория).
2. В File Manager навигирайте до папката с директорията за документи на вашия домейн.
3. Кликнете Upload в горната лента с инструменти.
4. Изберете архивния файл и изчакайте качването да завърши. File Manager показва индикатор за напредък.
5. След приключване на качването кликнете Go Back to директорията.
6. Кликнете с десния бутон върху качения архив и изберете Extract. Потвърдете, че пътят за извличане е текущата директория.
7. Изтрийте архива след извличането, за да поддържате директорията за документи чиста.

Критичен детайл: Ако архивът ви съдържа папка от най-горно ниво (напр. mysite/index.php вместо index.php в корена), сайтът ви ще се обслужва от example.com/mysite/ вместо от example.com/. Винаги проверявайте структурата на директориите след извличането. Преместете файловете едно ниво нагоре с функцията Move на File Manager, ако е необходимо.

Алтернатива: Разгръщане чрез SFTP

За по-големи сайтове или автоматизирани разгръщания, SFTP е значително по-ефективен от File Manager. Използвайте SFTP клиент (FileZilla, WinSCP или sftp от командния ред) със следните параметри:

• Host: IP адресът или хостнеймът на вашия сървър
• Port: 22 (SSH/SFTP)
• Username: Потребителското ви име за cPanel акаунта
• Authentication: Парола или SSH ключова двойка

Навигирайте директно до /home/username/public_html/example.com/ и прехвърлете файловете. Този метод заобикаля изискването за архив и поддържа възобновяеми прехвърляния.

Стъпка 3: Създаване на MySQL база данни за вашия уебсайт

Повечето CMS платформи — WordPress, Joomla, Drupal, Magento — изискват релационна база данни. cPanel предоставя два инструмента за това: MySQL Databases (ръчен, с детайлен контрол) и MySQL Database Wizard (с насоки, стъпка по стъпка). За прости настройки Wizard-ът е по-бърз.

Използване на MySQL Database Wizard

1. От началния екран на cPanel навигирайте до Databases > MySQL Database Wizard.
2. Стъпка 1 — Създаване на база данни: Въведете име за базата данни. cPanel автоматично добавя потребителското ви име като префикс (напр. username_dbname). Запомнете това пълно име — ще ви трябва по време на инсталацията на CMS.
3. Стъпка 2 — Създаване на потребител на базата данни: Въведете потребителско име и силна парола. Използвайте Password Generator на cPanel за създаване на криптографски силна парола. Пълното потребителско име също ще бъде с префикс (напр. username_dbuser).
4. Стъпка 3 — Добавяне на потребител към базата данни: Изберете потребителя, когото току-що създадохте, и задайте привилегии. За стандартен CMS предоставете All Privileges. Кликнете Next Step.
5. Wizard-ът потвърждава базата данни, потребителя и присвояването на привилегии. Запишете и трите стойности: име на базата данни, потребителско име и парола.

Използване на MySQL Databases (Разширено)

За среди, изискващи множество потребители с различни нива на привилегии, или при управление на няколко бази данни за един домейн:

1. Отидете на Databases > MySQL Databases.
2. Създайте базата данни в Create New Database.
3. Превъртете надолу до Add New User и създайте потребителя със силна парола.
4. В Add User to Database изберете потребителя и базата данни, след което дефинирайте детайлни привилегии (SELECT, INSERT, UPDATE, DELETE и др.) вместо общи ALL PRIVILEGES.

Бележка за сигурност: Никога не използвайте един и същ потребител на базата данни за множество сайтове в един и същ акаунт. Ако един сайт бъде компрометиран, изолираните идентификационни данни за базата данни ограничават странично движение към другите бази данни.

Стойност на хоста на базата данни

При конфигуриране на CMS инсталатора, хостът на базата данни почти винаги е localhost на стандартен cPanel VPS. Това е така, защото MySQL сървърът работи на същата машина и слуша на локалния сокет. Използването на 127.0.0.1 също работи, но принуждава TCP вместо Unix сокета, добавяйки незначително натоварване.

Стъпка 4: Конфигуриране на SSL за новия домейн

Домейн без HTTPS ще бъде маркиран от браузърите и наказан в класациите на търсачките. Функцията AutoSSL на cPanel (захранвана от Let’s Encrypt или Sectigo в зависимост от конфигурацията на сървъра) обработва издаването на сертификати автоматично, след като домейнът се резолвира правилно.

Проверка на покритието на AutoSSL

1. Навигирайте до Security > SSL/TLS Status.
2. Новият ви домейн трябва да се появи в списъка. Ако AutoSSL вече е изпълнен, ще покаже зелено катинарче и дата на изтичане.
3. Ако домейнът се показва като изчакващ или неуспешен, кликнете Run AutoSSL за незабавен опит.

Чести причини за неуспех на AutoSSL:

• A записът на домейна все още не сочи към сървъра (DNS не е разпространен).
• CAA DNS запис на домейна ограничава издаването до различен CA.
• Домейнът е зад прокси (напр. Cloudflare orange-cloud), който прихваща ACME HTTP-01 предизвикателството.

За домейни, изискващи разширена валидация или wildcard покритие извън това, което AutoSSL предоставя, можете да инсталирате SSL сертификат от трета страна ръчно чрез SSL/TLS Manager на cPanel.

Addon домейни срещу поддомейни срещу паркирани домейни: Ключови разлики

Разбирането кой тип домейн да добавите предотвратява неправилна конфигурация и загубено време за отстраняване на проблеми.

Модерният интерфейс Domains на cPanel консолидира тези в един екран, но основното поведение остава различно. Когато добавите домейн и оставите „Share document root” без отметка, създавате това, което исторически се е наричало Addon Domain.

Чести проблеми и как да ги разрешите

Домейнът показва „Index of /” (Списък на директорията)

Това означава, че директорията за документи е празна или липсва файл index.php / index.html. Или файловете ви не са качени, или са извлечени в поддиректория. Проверете файловата структура в File Manager.

500 Internal Server Error след качване

Обикновено се причинява от неправилни разрешения за файлове или неправилно форматиран файл .htaccess. Проверете дали директориите са зададени на 755 и файловете на 644. В File Manager кликнете с десния бутон върху файл или папка и изберете Change Permissions.

Грешка при свързване с базата данни по време на инсталация на CMS

Проверете отново дали използвате пълното префиксирано име на базата данни и потребителското име (напр. username_dbname, а не само dbname). Потвърдете, че паролата няма специални символи, които могат да бъдат погрешно интерпретирани от парсера на конфигурационния файл на CMS — или оградете стойността в кавички в конфигурационния файл.

Домейнът резолвира към грешен сайт

Ако два домейна в един и същ акаунт резолвират към едно и също съдържание, директорията за документи е споделена случайно по време на настройката. Отидете на Domains, редактирайте записа и коригирайте пътя до директорията за документи към специалната директория.

Мащабиране отвъд един cPanel акаунт

Когато надраснете един cPanel акаунт — по отношение на броя домейни, обема на трафика или изискванията за изолация на ресурсите — архитектурните опции се разминават:

• Множество cPanel акаунти на един VPS чрез WHM: Всеки акаунт има собствени ограничения на ресурсите, директории за документи и потребители на бази данни. Идеален за агенции, управляващи клиентски сайтове.
• Dedicated сървър с WHM/cPanel: Пълна хардуерна изолация, без ефекти на шумни съседи и възможност за персонализиране на конфигурацията на LiteSpeed или Apache на ниво сървър. AlexHost dedicated сървъри поддържат пълен WHM root достъп.
• Множество VPS инстанции: Всеки VPS изпълнява независима cPanel среда. Полезно, когато сайтовете имат различни изисквания за сигурност или съответствие.

За повечето малки до средни разгръщания, един акаунт VPS Hosting с cPanel, хостващ 5–20 домейна, е най-рентабилната архитектура. NVMe съхранението гарантира, че дори операции с висок I/O като заявки към бази данни и кеширане на PHP opcode остават бързи за всички хоствани домейни.

Контролен списък с технически ключови изводи

Преди да считате даден домейн за напълно функциониращ в cPanel, проверете всеки елемент:

• DNS A запис сочи към правилния IP на сървъра и е разпространен (проверете с dig example.com A или онлайн DNS проверка).
• Директорията за документи е специална директория, не споделена с основния домейн.
• Файловете са извлечени на правилното ниво на директорията — index.php трябва да бъде директно в директорията за документи, а не в поддиректория.
• Разрешенията за файлове са зададени на 755 за директории и 644 за файлове.
• Идентификационните данни за базата данни (пълно префиксирано име, потребителско име, парола, хост localhost) са записани и тествани.
• SSL сертификатът е активен и покрива и example.com, и www.example.com.
• Подновяването на AutoSSL или ръчния сертификат е потвърдено — Let’s Encrypt сертификатите изтичат на всеки 90 дни.
• .htaccess съдържа валидно правило за пренасочване към HTTPS, ако искате да наложите SSL.
• Email хостингът за новия домейн е конфигуриран, ако е необходимо — секцията Email Accounts на cPanel или специализирано решение за email хостинг, ако имате нужда от разширени функции за доставяемост.

ЧЗВ

Добавянето на домейн в cPanel автоматично конфигурира ли DNS?

Само ако вашият домейн използва nameserver-ите на cPanel. Ако домейнът е регистриран другаде и използва външни nameserver-и, трябва ръчно да добавите A записа при вашия регистратор или DNS доставчик, сочещ към IP адреса на вашия сървър. cPanel създава файла на зоната вътрешно, но външните резолвери няма да го използват, освен ако домейнът не делегира към nameserver-ите на cPanel.

Колко домейна мога да добавя към един cPanel акаунт?

Ограничението се задава в WHM в конфигурацията на акаунта. На VPS с root достъп можете да го зададете на неограничено. При управлявани споделени хостинг планове ограничението зависи от нивото на пакета. Няма твърд технически таван в самия cPanel — практическото ограничение е капацитетът на ресурсите на сървъра.

Каква е разликата между MySQL Database Wizard и MySQL Databases в cPanel?

Wizard-ът ви води през създаването на база данни, създаването на потребител и присвояването на привилегии в линеен тристъпков процес — най-подходящ за бързи настройки. Интерфейсът MySQL Databases ви дава детайлен контрол върху множество потребители, индивидуални присвоявания на привилегии и инструменти за поправка/оптимизация на бази данни. За производствени среди с изисквания за сигурност използвайте ръчния интерфейс.

Защо домейнът ми показва страница по подразбиране на cPanel след добавяне?

Страницата по подразбиране на cPanel (cgi-sys/defaultwebpage.cgi) се появява, когато директорията за документи е празна. Качете и извлечете файловете на сайта си или поставете файл index.html в директорията за документи, за да го замените незабавно.

Мога ли да добавя домейн към cPanel без root достъп до сървъра?

Да. Стандартните потребителски акаунти на cPanel (без root) могат да добавят домейни до ограничението, зададено от хостинг доставчика. Root достъпът е необходим само за промяна на ограниченията на ниво акаунт, инсталиране на общосървърен софтуер или промяна на конфигурации извън домашната директория на потребителя на cPanel.