FASTPANELWIKI

Быстрый старт

Задать адрес панели

На этой странице

Введение

Помимо стандартного доступа к 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 минут.

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

Чтобы задать один из ваших доменов или поддоменов в качестве адреса панели, перейдите в раздел «Настройки» -> «Основные» -> «Адреса панели» и нажмите синюю кнопку «Добавить адрес».

В следующем окне добавьте домен, который хотите использовать в качестве адреса панели, и нажмите "Сохранить".

После этого FASTPANEL® будет доступна по адресу:

example.com:8888

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

Чтобы настроить прямой доступ без указания порта 8888, нажмите на значок карандаша рядом с заданным адресом панели:

Затем установите флажок "Прямой доступ" и выберите IP-адреса, которые вы хотите использовать для этого доменного имени:

И нажмите "Сохранить".

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

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

Затем в открывшемся окне выберите тип сертификата:

И нажмите "Сохранить".

Возможные проблемы

Обратите внимание, что в качестве адреса FASTPANEL® лучше использовать домен, который не находится за Cloudflare, так как это может вызвать проблемы с FASTPANEL® при доступе по доменному имени из-за ограничений на стороне Cloudflare.

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

Настройка 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®

На этой странице

По умолчанию 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

После этого вы можете войти в панель, используя новый пароль

Как удалить FASTPANEL®

важно

Если вы хотите перейти с FASTPANEL® на другую панель управления, единственный способ сделать это — переустановить операционную систему (ОС). Перед этим крайне важно создать резервные копии всех важных данных на внешнем хранилище. Это позволит вам восстановить свои проекты после переустановки.

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 core, 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 включена по умолчанию для всех пользователей. Активировать лицензию не требуется.