FASTPANELWIKI

Швидкий старт

Як видалити FASTPANEL®

важливо

Якщо ви хочете перейти з FASTPANEL® на іншу панель керування, єдиний спосіб зробити це — перевстановити операційну систему (OS). Перед цим вкрай важливо створити резервну копію всіх важливих даних на зовнішньому сховищі. Це забезпечить можливість відновити ваші проєкти після перевстановлення.

FASTPANEL® можна видалити без порушення роботи сайтів. Однак це призведе до таких наслідків:

  • Припиниться автоматичне поновлення SSL-сертифікатів від Let's Encrypt, виданих через FASTPANEL®.
  • Буде вимкнено завдання резервного копіювання, раніше налаштовані в FASTPANEL®.
  • Ви зможете змінювати налаштування сайтів, створювати й редагувати користувачів, поштові скриньки, облікові записи FTP/SFTP тощо лише через ручне налаштування.

Якщо ви впевнені, що хочете видалити FASTPANEL® і повністю розумієте наслідки, ви можете зробити це, виконавши такі команди в консолі сервера від імені root:

Debian/Ubuntu:

apt-get remove fastpanel2 fastpanel2-nginx

CentOS/AlmaLinux/RockyLinux:

yum remove fastpanel2 fastpanel2-nginx

Якщо в майбутньому вам знадобиться відновити роботу FASTPANEL®, ви зможете повторно встановити раніше видалені пакети. Однак немає жодних гарантій, що після цього панель керування відновить коректну роботу.
Щоб установити пакети FASTPANEL®, використовуйте команди:

Debian/Ubuntu:

apt-get update
apt-get install fastpanel2 fastpanel2-nginx
/usr/local/fastpanel2/updater

CentOS/AlmaLinux/RockyLinux:

yum makecache
yum install fastpanel2 fastpanel2-nginx
/usr/local/fastpanel2/updater

Як встановити FASTPANEL®

важливо

Панель можна встановити лише на чисту операційну систему без попередньо встановленого програмного забезпечення. Встановлення на сервер із попередньо налаштованим програмним забезпеченням неможливе!

Для встановлення FASTPANEL® потрібен віртуальний (VPS) або виділений сервер із root-доступом.

Апаратне забезпечення сервера має відповідати мінімальним системним вимогам:

RAM: 1G
Вільне місце: 5Gb
CPU: 1 ядро, 1 Ghz

Підтримуються такі операційні системи (лише 64-бітна архітектура):

Debian: 9, 10, 11, 12

Ubuntu: 18.04, 20.04, 22.04, 24.04

CentOS: 7

AlmaLinux: 8

Rocky Linux: 8


Після встановлення однієї з підтримуваних ОС необхідно виконати такі дії:

  1. Підключіться до сервера через SSH, використовуючи пароль root:

    ssh root@your.server
  2. Встановіть останні оновлення ОС і утиліту wget, яка потрібна для запуску скрипта встановлення панелі керування. Після цього перезавантажте сервер:

    Debian / Ubuntu:

    apt-get update && apt-get upgrade && apt-get install ca-certificates wget && reboot

    CentOS / AlmaLinux / Rocky Linux:

    yum makecache && yum update && yum install ca-certificates wget && reboot
  3. Після перезавантаження сервера запустіть процес встановлення FASTPANEL®, виконавши таку команду:

    порада

    Під час встановлення панелі ви можете вибрати версію MySQL. Детальніше можна дізнатися в цій статті.

    wget https://repo.fastpanel.direct/install_fastpanel.sh -O - | bash -
  4. Після встановлення FASTPANEL® ви отримаєте повідомлення з даними доступу:

    Вітаємо! FASTPANEL успішно встановлено і доступний для вас за адресою https://1.2.3.4:8888
    Логін: fastuser
    Пароль: password

FASTPANEL Extended доступна всім користувачам за замовчуванням. Активувати ліцензію не потрібно.

Налаштування NAT

На цій сторінці

NAT — це механізм трансляції мережевих адрес, який перетворює IP-адреси пакетів. NAT дає змогу серверам у локальній мережі працювати із серверами в зовнішній мережі.

Якщо сервер із FASTPANEL® має приватну IP-адресу, а в локальній мережі налаштовано NAT, для забезпечення коректної роботи з DNS-доменами, вебсайтами та поштовими сервісами необхідно налаштувати зіставлення приватної та публічної IP-адрес сервера.

Щоб налаштувати зіставлення IP-адрес:

  1. Відкрийте ліве меню → "Керування IP" → "Зіставлення IP"

  2. Натисніть "Додати"

  3. Для локальних IP-адрес введіть відповідну публічну IP-адресу

  4. Натисніть "Зберегти"

Після налаштування зіставлення адрес внутрішні IP-адреси будуть перетворюватися на зовнішні IP-адреси під час створення DNS-доменів.

Список портів для переадресації

Для коректної роботи основних сервісів потрібно налаштувати переадресацію таких портів:

  • FASTPANEL: 8888, 7777

  • FTP: 21, 65000-65500

  • SSH: 22

  • SFTP: 2222

  • HTTP, HTTPS: 80, 443

  • IMAP, IMAPS: 143, 993

  • POP3, POP3S: 110, 995

  • SMTP, SMTPS: 25, 587, 465

  • DNS(якщо використовується bind9): 53

Інші сервіси, такі як MySQL, зазвичай працюють лише на локальних IP-адресах і не потребують публічного доступу.

Налаштування SSH-ключів

На цій сторінці

У FASTPANEL® ви можете додавати SSH-ключі для користувачів, щоб спростити та захистити доступ до сервера.

SSH-ключі (автентифікація за відкритим ключем) забезпечують безпечний і зручний спосіб доступу до сервера без використання паролів на основі пари приватного та публічного ключів. Замість введення пароля щоразу клієнт використовує приватний ключ, а сервер перевіряє його за публічним ключем, покращуючи як безпеку, так і зручність використання.

Створення пари ключів

попередження

Зберігайте свій приватний ключ у безпеці та ніколи нікому його не передавайте.

Спочатку вам потрібно згенерувати пару приватного та публічного ключів.

macOS / Linux

Відкрийте термінал і виконайте:

ssh-keygen

Натисніть Enter, щоб прийняти стандартне розташування файлу, і за потреби задайте парольну фразу.
Ваші ключі буде збережено в ~/.ssh/id_ed25519 (приватний) і ~/.ssh/id_ed25519.pub (публічний).

Windows

OpenSSH

Відкрийте PowerShell і виконайте:

ssh-keygen

Натисніть Enter, щоб прийняти стандартне розташування файлу, і за потреби задайте парольну фразу.
Ваші ключі буде збережено в C:\Users\YourUser\.ssh\id_ed25519 (приватний) і C:\Users\YourUser\.ssh\id_ed25519.pub (публічний).

PuTTYgen
  1. Завантажте та встановіть PuTTYgen.
  2. Запустіть PuTTYgen і натисніть "Generate".
  1. Переміщуйте курсор миші випадковим чином у вікні PuTTYgen, доки процес генерації не завершиться.
  2. Збережіть приватний ключ (.ppk) і скопіюйте текст публічного ключа.

Додайте публічний ключ до панелі

Відкрийте FASTPANEL® і натисніть на своє ім’я користувача у правому верхньому куті екрана. Потім виберіть "SSH Keys".

Натисніть кнопку "Add SSH key".

  • У перше поле вставте свій публічний ключ (зазвичай він починається з ssh-ed25519 або ssh-rsa залежно від вибраного алгоритму) з попереднього розділу.

  • У друге поле ви можете додати опис, щоб легше розрізняти ключ.

Після цього ви зможете підключатися до свого сервера через SSH, використовуючи облікові дані власника сайту, без введення пароля.

Увімкнення доступу SSH та керування наявними ключами

Якщо вам потрібно керувати ключами інших користувачів або видалити ключі поточного користувача, перейдіть до "Management" → "Users". Натисніть три крапки поруч із користувачем, ключами якого ви хочете керувати.

У відкритому розділі ви можете:

  1. Додати новий ключ.
  2. Видалити наявний ключ.
  3. Увімкнути або вимкнути доступ SSH для користувача.

Налаштування адреси панелі

На цій сторінці

Вступ

Окрім стандартного доступу до FASTPANEL® за IP-адресою, ви також можете вказати будь-який домен або піддомен, спрямований на ваш сервер із встановленим FASTPANEL®, як адресу панелі.

Для початку переконайтеся, що для доменного імені, яке ви хочете використовувати як адресу панелі, існує коректний A-запис. Ви можете перевірити це за допомогою команд:

Windows:

nslookup example.com

Linux/MacOS:

host example.com

Якщо A-запис правильний, ви побачите такий результат:

example.com has address $IP_ADDRESS

Де замість $IP_ADDRESS слід вказати IP-адресу вашого сервера. Якщо вказано іншу адресу, виправте її в обліковому записі вашого DNS-провайдера та дочекайтеся оновлення кешу DNS. Зазвичай цей процес займає від 20 до 60 хвилин.

Налаштування адреси панелі

Щоб вказати один із ваших доменів або піддоменів як адресу панелі, перейдіть до “Settings” -> “Main” -> “Panel addresses” і натисніть синю кнопку “Add address”.

У наступному вікні додайте домен, який ви хочете використовувати як адресу панелі, і натисніть "Save".

Після цього FASTPANEL® буде доступний за адресою:

example.com:8888

Прямий доступ

Щоб налаштувати прямий доступ без вказання порту 8888, натисніть на значок олівця поруч із налаштованою адресою панелі:

Потім увімкніть прапорець "Direct access" і виберіть IP-адреси, які ви хочете використовувати для цього доменного імені:

І натисніть "Save".

SSL-сертифікат для адреси панелі

Для адреси панелі ви можете випустити безкоштовний SSL-сертифікат від Let's Encrypt, використати наявний платний сертифікат або самопідписаний сертифікат. Для цього натисніть на синій текст "SSL" поруч з адресою панелі:

Потім у вікні, що відкриється, виберіть тип сертифіката:

І натисніть "Save".

Можливі проблеми

Зверніть увагу, що як адресу FASTPANEL® краще використовувати домен, який не знаходиться за Cloudflare, оскільки це може спричинити проблеми з FASTPANEL® при доступі за доменним іменем через обмеження на боці Cloudflare.

Якщо при використанні такого домену виникають проблеми, перевірте, чи відтворюються вони при доступі до панелі за IP-адресою. Якщо ні, вимкніть проксіювання для доменного імені, яке використовується як ваша адреса FASTPANEL®, у розділі Cloudflare DNS.

Як оновити FASTPANEL®

На цій сторінці

За замовчуванням FASTPANEL® оновлюється автоматично відповідно до розкладу, встановленого планувальником Cron. Вам не потрібно виконувати жодних додаткових дій, щоб панель оновилася.

Ручне оновлення

Якщо з певної причини необхідно примусово виконати оновлення, виконайте таку консольну команду через SSH:

/usr/local/fastpanel2/app/updater

Буде запущено виконуваний файл, який оновить FASTPANEL® до останньої версії.

Як скинути пароль

На цій сторінці

Вступ

FASTPANEL® надає два різні способи змінити пароль будь-якого користувача:

Зміна пароля через сам FASTPANEL

Цей спосіб підходить, якщо попередній пароль відомий (доступ до панелі не втрачено).

Щоб скористатися цим варіантом, потрібно увійти в FASTPANEL® і перейти в меню "Management" → "Users", потім натиснути "Change Password"

У модальному вікні, що відкриється, введіть свій старий пароль, потім двічі введіть новий пароль, а після цього натисніть кнопку "Save"

Зміна пароля через SSH

Цей спосіб підходить, якщо попередній пароль невідомий (доступ до панелі втрачено). Для зміни пароля через SSH старий пароль не потрібен.

Щоб скористатися цим варіантом, потрібно:

  1. Підключіться до свого сервера через SSH, використовуючи root-password:

    ssh root@your.server
  2. Використайте команду passwd user_name

    Наприклад, щоб змінити пароль користувача з ім’ям fastuser, команда має виглядати так:

    passwd fastuser

    Після запуску команди потрібно буде ввести та підтвердити новий пароль

    примітка

    під час введення та підтвердження нового пароля на екрані не відображатимуться жодні символи.

  3. Якщо пароль було успішно змінено, ви побачите таке повідомлення:

    passwd: password updated successfully

Після цього ви зможете увійти в панель, використовуючи свій новий пароль