FASTPANELWIKI

Funkce verze Extended

Přizpůsobení brandingu

Na této stránce

Sekce Branding v FASTPANEL® umožňuje přizpůsobit vizuální vzhled a styl ovládacího panelu. Tato nabídka se nachází v „Nastavení“ → „Hlavní“ → „Branding“.

Barevná schémata

Přejděte na kartu „Barevná schémata“, kde můžete změnit hlavní barevné téma panelu. Vyberte si z různých předdefinovaných barevných palet (např. modrá, oranžová, červená, zelená).

Upravte Téma:

  • Světlé: Použít světlé téma
  • Tmavé: Přepnout do tmavého režimu
  • Jako na zařízení: Automaticky se přizpůsobí nastavení zařízení uživatele

Přizpůsobení loga

Karta „Logo“ umožňuje nahrát vlastní logo pro různé části panelu.

Přihlašovací obrazovka
Pro světlé a tmavé téma lze nahrát samostatná loga.
Pomocí tlačítka Nahrát přidejte nové logo nebo pomocí Obnovit vraťte výchozí nastavení.

  • Podporované formáty: jpeg, png, svg, webp
  • Maximální rozlišení: 256x100 pixelů
  • Maximální velikost souboru: 5 MB

Logo záhlaví
Zobrazuje se v záhlaví ovládacího panelu.

  • Podporované formáty: jpeg, png, svg, webp
  • Maximální rozlišení: 200x22 pixelů
  • Maximální velikost souboru: 5 MB

Přizpůsobení favicony

Karta „Favicon“ umožňuje nahrát faviconu, která se zobrazuje na kartách prohlížeče a ve výsledcích vyhledávání.
Pomocí tlačítka Nahrát přidejte faviconu nebo pomocí Obnovit vraťte výchozí nastavení.

  • Podporovaný formát: ico
  • Maximální velikost souboru: 1 MB

Přizpůsobení odkazů

Karta „Odkazy“ obsahuje pole pro přizpůsobení odkazů v boční nabídce.

  • Znalostní báze: URL pro přístup ke znalostní bázi

Po úpravě odkazů klikněte na Uložit a použijte změny.

Node.js

Na této stránce
informace

FASTPANEL Extended je ve výchozím nastavení zapnutý pro všechny uživatele. Licenci není třeba aktivovat.

Úvod

Node.js je serverová platforma, která spouští aplikace napsané v JavaScriptu.

Nejprve musíte nainstalovat Node.js:

  • Přejděte do "Nastavení" -> "Aplikace"
  • Klikněte na tlačítko "Install" u požadované verze Node.js

Vytvořte webovou stránku:

  • Vyberte šablonu pro webovou stránku Node.js
  • Zadejte doménu a související parametry. Ve fázi konfigurace můžete změnit DB, FTP uživatele a Backend
  • Nahrajte soubory aplikace do adresáře webové stránky
  • Pro instalaci závislostí spusťte v Terminálu npm20.15.1 install (je potřeba nainstalovat aplikaci ttyd pro FASTPANEL®)
  • Restartujte Node.js tak, že přejdete na nástěnku webu a poté otevřete sekci "Services".

Framework Express

Na příkladu frameworku Express vytvořme jednoduchý webový server:

  • Připojte se k serveru přes SSH jako uživatel, který vlastní web (můžete použít aplikaci ttyd pro FASTPANEL®)
  • Vytvořte v adresáři webové stránky soubor app.js a vyplňte jej následujícím kódem:
const express = require('express');
const app = express();
const PORT = process.env.SERVICE_PORT;

app.get('/', (req, res) => {
  res.send('Hello! This is my first server on Node.js + Express 🚀');
});

app.listen(PORT, () => {
  console.log(`Server is running at http://localhost:${PORT}`);
});
  • V adresáři webové stránky spusťte příkaz pro instalaci express
npm20.15.1 install express
  • Přejděte na nástěnku webu a poté do sekce Services
  • Restartujte službu
  • Zkontrolujte webovou stránku

Docusaurus

Na příkladu webové aplikace Docusaurus nakonfigurujme nastavení:

  • Připojte se k serveru přes SSH jako uživatel, který vlastní web (můžete použít aplikaci ttyd pro FASTPANEL®)
  • V adresáři webové stránky spusťte instalaci Docusaurus
npx20.15.1 create-docusaurus -j ./docs
  • Když budete vyzváni k výběru šablony, odpovězte classic (recommended)

  • Po instalaci nahraďte jeden řádek v souboru docs/package.json

"start": "docusaurus start",
# replace with 
"start": "docusaurus start --port $SERVICE_PORT",

$SERVICE_PORT je systémová proměnná nastavená v FASTPANEL®

  • V ovládacím panelu přejděte do "nastavení webu" -> "Backend"

  • Vyberte obslužnou rutinu Standalone nebo PM2.

  • Vyberte požadovanou verzi Node.js.

  • Zadejte pracovní složku docs

  • Do pole Launch command zadejte: npm run start

  • Uložte. Počkejte, až se aplikace zkompiluje (informace se objeví v logách). Zkontrolujte webovou stránku

Next.js

Na příkladu Next.js s Node.js 20.19 vytvořme jednoduchý webový server:

  • Připojte se k serveru přes SSH jako uživatel, který vlastní webovou stránku (můžete také použít aplikaci ttyd ve FASTPANEL®).
  • V adresáři webové stránky spusťte příkaz pro inicializaci projektu:
yarn20.19.4 init -y
yarn20.19.4 add next react react-dom
  • Přidejte blok scripts do souboru package.json:
"scripts": {
  "dev": "next dev -p $SERVICE_PORT",
  "build": "next build",
  "start": "next start -p $SERVICE_PORT"
}
  • Vytvořte adresář pages a v něm přidejte soubor s názvem index.js:
mkdir pages
cat <<EOF > pages/index.js
export async function getServerSideProps() {
  return {
    props: {
      nodeVersion: process.version,
      port: process.env.SERVICE_PORT || 3000,
    },
  };
}

export default function Home({ nodeVersion, port }) {
  return (
    <div style={{
      fontFamily: 'sans-serif',
      textAlign: 'center',
      marginTop: '20vh'
    }}>
      <h1>✅ It works!</h1>
      <p>Next.js app running on Node.js {nodeVersion}</p>
      <p>Port: {port}</p>
    </div>
  );
}
EOF
  • Spusťte sestavení projektu.
yarn20.19.4 build
  • V ovládacím panelu přejděte do "nastavení webu" -> "Backend"
  • Vyberte obslužnou rutinu Standalone nebo PM2.
  • Vyberte požadovanou verzi Node.js.
  • Do pole Launch command zadejte: yarn run start.
  • Uložte. Počkejte, až se aplikace zkompiluje (informace se objeví v logách). Zkontrolujte webovou stránku

Další informace

V režimu Standalone se pro spouštění vašich skriptů spouští proces Node.js.

V režimu PM2 se pro správu procesů Node.js, logů a systémové zátěže používá správce procesů PM2.
Tento režim vám také umožňuje zadat počet workerů — tedy počet procesů Node.js zpracovávajících příchozí požadavky na server.
Tento režim navíc poskytuje možnost Enable file watch — PM2 automaticky restartuje vaši aplikaci při změně souboru v aktuálním adresáři nebo jeho podadresářích. Upozorňujeme, že tento režim přináší dodatečnou systémovou zátěž a není doporučen pro produkční prostředí.

Podobně můžete aplikaci nakonfigurovat, pokud vyžaduje YARN namísto NPM

Závislosti projektu uvedené v package.json můžete nainstalovat pomocí YARN nebo NPM přímo z FASTPANEL®. Za tímto účelem otevřete kartu webové stránky a přejděte do sekce Services:

Logy

Aplikace Node.js může generovat logy. Ve FASTPANEL® se nacházejí na nástěnce webu v sekci Logs na kartě "Backend log"

Příkazy konzole

Po instalaci Node.js ve FASTPANEL® mohou uživatelé se svými projekty pracovat pomocí příkazů konzole, jako jsou:

  • pm2
  • yarn20.15.1
  • npx20.15.1
  • npm20.15.1
  • node20.15.1

Příklad:

$ npm20.15.1 list
node-socket-port-server@1.0.0 /var/www/node_user/data/www/node.site
└── express@4.21.2
$ pm2 ls
┌────┬─────────────┬─────────────┬─────────┬─────────┬──────────┬────────┬──────┬───────────┬──────────┬──────────┬──────────┬──────────┐
│ id │ name        │ namespace   │ version │ mode    │ pid      │ uptime │ ↺    │ status    │ cpu      │ mem      │ user     │ watching │
├────┼─────────────┼─────────────┼─────────┼─────────┼──────────┼────────┼──────┼───────────┼──────────┼──────────┼──────────┼──────────┤
│ 0  │ amazing_site│ default     │ 1.0.0   │ cluster │ 9355     │ 2m     │ 0    │ online    │ 0%       │ 62.4mb   │ user     │ disabled │
│ 1  │ amazing_site│ default     │ 1.0.0   │ cluster │ 9362     │ 2m     │ 0    │ online    │ 0%       │ 62.5mb   │ user     │ disabled │
└────┴─────────────┴─────────────┴─────────┴─────────┴──────────┴────────┴──────┴───────────┴──────────┴──────────┴──────────┴──────────┘

Název každého příkazu obsahuje číslo verze nainstalovaného Node.js. V tomto příkladu je dostupná verze Node.js 20.15.1.

Oznámení serveru

Na této stránce
informace

FASTPANEL Extended je ve výchozím nastavení zapnutý pro všechny uživatele. Licenci není třeba aktivovat.

FASTPANEL® umožňuje sledovat klíčové metriky serveru: zatížení CPU, Load Average 5, využití disku a spotřebu RAM. Když metrika překročí svůj práh, upozornění se automaticky odešlou do Telegramu nebo Slacku. Konfigurace se nachází v části "Nastavení" → "Oznámení".

Tento článek vysvětluje, jak nastavit kanály doručování a nakonfigurovat parametry oznámení, včetně prahů a triggerů.

Nastavení kanálu

Telegram

  1. Vytvořte nového bota pomocí oficiálního bota Telegramu @BotFather. Přejděte na odkaz a klikněte na tlačítko "Start"
  1. Zadejte /newbot a stiskněte Enter.
  2. Zadejte požadovaný název svého bota a stiskněte Enter.
  3. Zadejte požadované uživatelské jméno svého bota. Musí končit na bot, poté stiskněte Enter.
  4. Obdržíte zprávu začínající takto:
    Done! Congratulations on your new bot.
  5. Kliknutím na modrý řádek za Use this token to access the HTTP API: (na snímku obrazovky rozmazaný) zkopírujete API token svého bota do schránky. Token uchovávejte v bezpečí, protože kdokoli, kdo jej má, může ovládat vašeho bota
poznámka

API token je uložen v @BotFather. Pokud ho zapomenete, odešlete příkaz /mybots, vyberte svého bota a klikněte na tlačítko "API Token".

  1. Otevřete FASTPANEL® a přejděte do části "Nastavení" → "Oznámení".
  2. Klikněte na tlačítko "Vytvořit kanál"
  1. Vyplňte následující pole:
  • Název — Zadejte název kanálu, abyste jej mohli vizuálně odlišit
  • Kanál — Zvolte "Telegram"
  • Bot token — Vložte token bota zkopírovaný v kroku 6
  • Období problému — Nastavte časový interval (v minutách), po kterém bude odesláno oznámení, pokud problém přetrvává. Minimální hodnota je 1 minuta
  • Interval opakování oznámení — Nastavte interval mezi po sobě jdoucími oznámeními pro stejný problém
  • Upozorňovat na vyřešené problémy — Povolte tuto možnost, pokud chcete dostat oznámení, když je problém vyřešen
  • Přidat základní triggery — Povolte tuto možnost, chcete-li automaticky vytvořit triggery pro všechny disky, RAM a CPU
  1. Klikněte na tlačítko "Uložit".
  2. Na další obrazovce klikněte na tlačítko "Pozvat" a pozvěte svého bota do chatu nebo skupinového chatu
  1. V nové kartě se otevře odkaz. Potvrďte přesměrování do aplikace Telegram Desktop
  1. Klikněte na tlačítko "Start" a aktivujte svého bota
  1. Chcete-li ověřit, že je nastavení správné, vraťte se na kartu FASTPANEL® a klikněte na tlačítko s papírovou vlaštovkou
  1. Pokud je vše správně nakonfigurováno, odešle se do chatu s vaším botem testovací oznámení
  1. Chcete-li později upravit nastavení kanálu, klikněte na ikonu tužky vedle kanálu
  1. Níže je uveden příklad oznámení vygenerovaného při aktivaci triggeru

Slack

  1. Přihlaste se ke svému účtu a vytvořte aplikaci Slack prostřednictvím stránky aplikací.
  2. Vyberte "From scratch".
  3. Zadejte App Name, vyberte workspace, ve kterém bude aplikace vytvořena, a klikněte na „Create app“.
  4. V části „Features“ otevřete „Incoming Webhooks“ a tuto funkci povolte
  1. Ve spodní části stejné stránky klikněte na „Add New Webhook“
  1. Na další obrazovce vyberte kanál, do kterého se budou oznámení odesílat. Doporučuje se vytvořit vyhrazený kanál pro upozornění. Poté klikněte na „Allow“.
  2. Budete přesměrováni zpět na stránku webhooků. Posuňte se dolů a kliknutím na „Copy“ zkopírujte URL webhooku
  1. Otevřete FASTPANEL® a přejděte do části "Nastavení" → "Oznámení".
  2. Klikněte na tlačítko "Vytvořit kanál"
  1. Vyplňte následující pole:
  • Název — Zadejte název kanálu, abyste jej mohli vizuálně odlišit
  • Kanál — Zvolte "Slack"
  • Webhook url — Vložte URL webhooku zkopírované v kroku 7
  • Období problému — Nastavte časový interval (v minutách), po kterém bude odesláno oznámení, pokud problém přetrvává. Minimální hodnota je 1 minuta
  • Interval opakování oznámení — Nastavte interval mezi po sobě jdoucími oznámeními pro stejný problém
  • Upozorňovat na vyřešené problémy — Povolte tuto možnost, pokud chcete dostat oznámení, když je problém vyřešen
  • Přidat základní triggery — Povolte tuto možnost, chcete-li automaticky vytvořit triggery pro všechny disky, RAM a CPU
  1. Klikněte na tlačítko "Uložit".
  2. Chcete-li ověřit, že je nastavení správné, klikněte na tlačítko s papírovou vlaštovkou
  1. Pokud je vše správně nakonfigurováno, odešle se testovací oznámení do kanálu vybraného v kroku 6
  1. Chcete-li později upravit nastavení kanálu, klikněte na ikonu tužky vedle kanálu
  1. Níže je uveden příklad oznámení vygenerovaného při aktivaci triggeru

Konfigurace triggerů

Chcete-li nakonfigurovat triggery, klikněte na ikonu ozubeného kola v řádku kanálu, který chcete upravit

V otevřené části můžete:

  1. Pomocí přepínače vlevo vypnout nepotřebné triggery.
  2. Vytvořit nový trigger jednoho z následujících typů: CPU, Disk (pro každý disk zvlášť), Load Average 5 (průměrné zatížení systému za posledních 5 minut), RAM.
  3. Upravit existující triggery

Prahy pro CPU, Disk a RAM se nastavují v procentech. Práh pro Load Average 5 se nastavuje v celých číslech.

poznámka

Obecně platí, že normální hodnota Load Average 5 se přibližně rovná počtu jader CPU na serveru nebo může být až dvojnásobná.

Prometheus

Na této stránce
informace

FASTPANEL Extended je ve výchozím nastavení zapnutý pro všechny uživatele. Licenci není třeba aktivovat.

Integrace FASTPANEL s Prometheus pro sběr metrik

FASTPANEL® nyní podporuje integraci s Prometheus pro sběr systémových metrik. Tato příručka vás provede kroky potřebnými k přidání vaší instance FASTPANEL® do Prometheus, což vám umožní shromažďovat a monitorovat systémové metriky v reálném čase.

Vytvoření tokenu

Aby mohl Prometheus shromažďovat metriky, musíte vytvořit speciální token s omezeným přístupem:

  1. Připojte se k serveru FASTPANEL® přes SSH.

  2. Spusťte následující příkaz pro vytvoření tokenu:

mogwai users tokens add -n metrics_test_token -s read_only -s metrics_only
  • metrics_test_token je vlastní název tokenu; můžete zvolit libovolný název
  • Tokenu budou uděleny následující rozsahy oprávnění:
    • read_only — přístup pouze pro čtení
    • metrics_only — přístup omezený pouze na metriky

Přidání úlohy do Prometheus

Jakmile je token vytvořen, musíte nakonfigurovat Prometheus, aby začal stahovat metriky z vaší instance FASTPANEL®.

Otevřete konfigurační soubor Prometheus a přidejte novou úlohu:

- job_name: "fastpanel2"
  scheme: https
  static_configs:
    - targets: ["$IP:8888"]
  metrics_path: /api/metrics
  tls_config:
    insecure_skip_verify: true
  bearer_token: I_AM_TOKEN
  scrape_interval: 60s
  • job_name — vlastní název úlohy
  • targets — IP adresa a port vašeho serveru FASTPANEL®. Nahraďte $IP IP adresou vašeho serveru
  • metrics_path — koncový bod API, ze kterého se načítají metriky
  • bearer_token — nahraďte tuto hodnotu vaším vygenerovaným tokenem (metrics_test_token)
  • scrape_interval — jak často má Prometheus stahovat metriky (v tomto případě nastaveno na 60 sekund)

Konfigurace monitorovacího panelu

Po úspěšném přidání vaší instance FASTPANEL® do Prometheus můžete nastavit svůj první panel pro vizualizaci shromážděných metrik.

Pro import panelu postupujte podle tohoto návodu.

Prometheus nyní začne shromažďovat metriky z vaší instance FASTPANEL®, což vám umožní monitorovat výkon systému v reálném čase.

Statistika využití disku

informace

FASTPANEL Extended je ve výchozím nastavení zapnutý pro všechny uživatele. Licenci není třeba aktivovat.

FASTPANEL® obsahuje funkci Statistika využití disku, která vám umožní rychle zjistit, které soubory a adresáře zabírají místo v uživatelských adresářích vašich webů.

Chcete-li tuto funkci použít, otevřete "Správa" → "Správce souborů" a klikněte na kulatou ikonu v pravém horním rohu

Na následující obrazovce uvidíte podrobnou statistiku využití disku, včetně Adresářů, Největších souborů a Statistiky přípon.

  1. Kliknutím na ikonu složky v pravém horním rohu se vrátíte do správce souborů.
  2. Kliknutím na ikonu obnovení (kruhové šipky) v pravém horním rohu znovu načtete data.
  3. Kliknutím na uživatelské jméno v levém horním rohu můžete přepínat mezi domovskými adresáři různých uživatelů; statistika se podle toho aktualizuje.

Statistiky pošty

Na této stránce
informace

FASTPANEL Extended je ve výchozím nastavení zapnutý pro všechny uživatele. Licenci není třeba aktivovat.

FASTPANEL® obsahuje funkci Statistiky pošty, která vám umožňuje snadno sledovat aktivitu odchozích e-mailů pro celou doménu nebo jednotlivé poštovní schránky. Můžete rychle zjistit, kolik zpráv bylo odesláno, doručeno nebo vráceno, a zobrazit podrobné chybové kódy SMTP s doporučeními vysvětlujícími, proč byly některé e-maily odmítnuty.

Konfigurace automatického shromažďování statistik

  1. Chcete-li povolit automatické shromažďování statistik pošty, přejděte do "Nastavení" → "Pošta" → "Statistiky" a přepněte možnost "Povolit shromažďování statistik".

Pokud nechcete data shromažďovat automaticky, tuto možnost zakažte. Poté budete muset pro obnovení dat ručně kliknout na tlačítko "Aktualizovat" v zobrazení statistik (viz další část).

  1. Můžete definovat, jak často se statistiky automaticky aktualizují — od každé 1 hodiny až po každých 24 hodin.

  2. Nezapomeňte kliknout na tlačítko "Uložit", aby se vaše nastavení uložilo.

Zobrazení statistik

Chcete-li zobrazit statistiky, přejděte do "Správa" → "Pošta" a klikněte na ikonu grafu vedle domény, kterou chcete analyzovat.

Zobrazení statistik je rozděleno do tří hlavních částí, které jsou podrobně popsány níže.

Graf statistik

Zobrazuje celkový počet odeslaných, doručených a vrácených zpráv za vybrané časové období. Graf vám pomůže na první pohled identifikovat trendy a problémy s doručováním.

Zobrazená data můžete přizpůsobit takto:

  1. Výběrem poštovní domény.

  2. Výběrem statistik pro celou doménu nebo konkrétní poštovní schránku.

  3. Volbou časového rozsahu reportu — od posledních 24 hodin až po poslední měsíc.

  4. Kliknutím na tlačítko "Aktualizovat" ručně obnovíte statistiky a načtete nejnovější data.

Nejčastější důvody vrácení

Uvádí nejčastější příčiny selhání doručení zpráv spolu s odpovídajícími chybovými kódy SMTP. To vám umožní porozumět opakujícím se problémům a řešit je.

Události odchozích chyb

Poskytuje podrobné informace o každé odmítnuté nebo nedoručené zprávě spolu s doporučenými kroky k vyřešení problémů.

U každého záznamu se zobrazují následující údaje:

  • Datum/čas — přesný čas, kdy došlo k pokusu o doručení

  • ID fronty — jedinečný identifikátor zprávy v poštovní frontě

  • Od / Doména odesílatele / Komu — adresy odesílatele a příjemce i původní doména

  • Kód SMTP — kód odpovědi vrácený poštovním serverem příjemce (například 550-5.7.26)

  • Doporučení — stručné vysvětlení problému a doporučený postup (např. „Zpráva odmítnuta službou Gmail: chybí nebo selhává ověření SPF/DKIM“)

  • Podrobnosti — úplný text odpovědi SMTP, který může obsahovat odkaz na externí dokumentaci serveru příjemce (například stránky podpory Gmailu)

  • Neznámý kód — označuje, zda odpověď SMTP nebylo možné klasifikovat

  • Bajty — velikost e-mailové zprávy

  • Počet opakování — počet pokusů o doručení předtím, než byla zpráva trvale odmítnuta

  • Poslední pokus — časové razítko posledního pokusu o doručení

  • Spamové skóre — výsledek vyhodnocení spamu, pokud je k dispozici

Tato data poskytují komplexní přehled problémů s odchozím doručováním a pomáhají vám diagnostikovat problémy s ověřováním, reputací nebo konfigurací.

FASTPANEL Extended

FASTPANEL Extended je ve výchozím nastavení zapnutý pro všechny uživatele. Licenci není třeba aktivovat.