Dokumentacja

Przewodnik publikacji

Praktyczny przewodnik po publikacji stron statycznych, przygotowaniu buildów frameworków, podłączaniu domen i aktualizowaniu projektów w DeployPages.

Publikacja ReactEksport Next.jsDNS lookupSSL checkMeta generator

Szybki start

Publikacja oznacza zamianę lokalnych plików strony w URL, który inni mogą otworzyć. DeployPages jest zbudowane dla wyników statycznych, więc pierwsza publikacja może zacząć się od folderu, nie od konfiguracji serwera.

Opcja 1: publikacja przez przeciągnięcie

Najszybsza ścieżka dla projektów statycznych. Jeśli strona jest już HTML-em, CSS-em, JavaScriptem albo gotowym folderem builda, możesz przesłać ją bezpośrednio.

Dobre dopasowanie dla

Landing page, stron osobistych, CV, prototypów, dokumentacji statycznej i innych wyników frontendu działających w przeglądarce.
  • 1
    Przygotuj folder projektu

    Folder do publikacji powinien zawierać `index.html` w katalogu głównym oraz style, skrypty i obrazy, od których zależy strona.

    Przykładowa struktura folderu
    my-site/├── index.html├── styles.css├── script.js└── images/    ├── logo.png    └── hero.jpg

    Częsty błąd

    Jeśli brakuje `index.html` albo leży jeden folder za głęboko, strona nie rozwiąże się poprawnie po przesłaniu.
  • 2
    Otwórz obszar przesyłania

    Użyj obszaru przesyłania w DeployPages. Możesz najpierw opublikować projekt tymczasowy, a zalogować się później, jeśli chcesz go zachować.

  • 3
    Prześlij folder

    Przeciągnij pełny folder do obszaru przesyłania albo wybierz go z selektora plików. Dla frameworków przesyłaj folder wynikowy builda, nie drzewo źródłowe.

  • 4
    Otwórz wygenerowany URL

    Po zakończeniu przesyłania DeployPages zwraca publiczny URL, którego możesz od razu użyć do testów albo udostępnienia.

Opcja 2: proces CLI

Przydatne, gdy ten sam build wychodzi regularnie i publikacja powinna trafić do komendy, zadania CI albo checklisty wydania.

Użyj tego, gdy projekt stał się powtarzalny

Drag-and-drop jest lepsze dla jednorazowych podglądów. CLI ma sens, gdy zespół potrzebuje publikować ten sam folder wynikowy w ten sam sposób za każdym razem.

Zainstaluj CLI

Użyj wybranego package managera, aby zainstalować CLI globalnie.

npm install -g @deploypages/cli

Uwierzytelnij się

Uruchom komendę logowania i dokończ autoryzację w przeglądarce.

deploypages login

Opublikuj bieżący folder

Uruchom komendę publikacji z katalogu wynikowego builda.

deploypages deploy

Przewodnik po buildach frameworków

Nowoczesne frameworki potrzebują kroku build przed przesłaniem. Cel jest zawsze ten sam: wygenerować zwykłe pliki statyczne, które przeglądarka może otworzyć bezpośrednio.

Co oznacza build

Build zamienia pliki źródłowe frameworka w gotowe do publikacji HTML, CSS, JavaScript i zasoby.

React / Vue / Vite

Command:npm run build
Output:dist/

Prześlij sam folder `dist`, nie katalog główny projektu.

Next.js static export

Command:npm run build
Output:out/

Ustaw `output: 'export'` w `next.config.js` przed buildem.

Zwykły HTML

Command:Build nie jest potrzebny
Output:Twój istniejący folder

Trzymaj `index.html` w katalogu głównym.

Hugo / Hexo

Command:hugo albo hexo generate
Output:public/

Prześlij wygenerowany folder `public`.

Przykład eksportu Next.js

next.config.js
/** @type {import('next').NextConfig} */const nextConfig = {  output: 'export',  images: { unoptimized: true },};
module.exports = nextConfig;

Ograniczenia static export

Funkcje renderowane serwerowo, takie jak API routes, server-side props i middleware, nie są dostępne w statycznym eksporcie.

Własne domeny

DeployPages może podłączyć Twoją domenę po pierwszej publikacji, aby projekt przeszedł z URL-a systemowego na własny adres produkcyjny.

Co liczy się jako domena?

Każda domena zarządzana przez rejestratora może działać, jeśli możesz edytować jej rekordy DNS.

Krok 1: dodaj domenę w konsoli

Przejdź do ustawień projektu, otwórz zakładkę domen i dodaj hostname, który chcesz podłączyć.

Krok 2: skonfiguruj DNS

DeployPages poda cele DNS potrzebne do weryfikacji własności i routingu ruchu.

Krok 3: poczekaj na weryfikację

Gdy DNS się rozpropaguje, status domeny zmieni się na zdrowy, a przygotowanie HTTPS będzie mogło się zakończyć.

TypHostWartośćCel
CNAMEwwwcname.deploypages.siteSkierowanie ruchu na platformę
TXT_deploypages-challengedeploypages-verify=...Weryfikacja własności domeny

Wybór rekordu hosta

  • Użyj `www`, gdy podłączasz `www.example.com`.
  • Użyj `@`, gdy podłączasz domenę główną `example.com`.
  • Użyj etykiety subdomeny, na przykład `blog`, gdy podłączasz `blog.example.com`.

Aktualizowanie strony

Ten sam proces, nowa wersja

Aktualizacja projektu używa tej samej logiki co pierwsza publikacja: zbuduj najnowszy wynik, prześlij go i pozwól platformie zastąpić opublikowaną wersję.
  • 1
    Edytuj pliki źródłowe

    Zmień treść, style, media albo zasoby lokalnie.

  • 2
    Zbuduj ponownie, jeśli trzeba

    Jeśli projekt używa frameworka, najpierw wygeneruj świeży folder wynikowy builda.

  • 3
    Otwórz konsolę projektu

    Wróć do strony projektu w DeployPages.

  • 4
    Prześlij nową wersję

    Zastąp poprzedni build najnowszym folderem. Historia publikacji utrzymuje nowsze wydanie możliwe do prześledzenia.

Po zakończeniu przesyłania nowy build staje się opublikowaną wersją, a poprzednie wersje pozostają dostępne do przywrócenia.

Częste pytania

Czy osoby nietechniczne mogą używać DeployPages?
Tak. Jeśli strona jest już wyeksportowana jako pliki statyczne, wystarczy publikacja przez przeciągnięcie folderu.
Dlaczego widzę 404 po publikacji?
Najczęstszą przyczyną jest brakujący albo źle umieszczony `index.html`. Upewnij się, że punkt wejścia leży w katalogu głównym przesłanego folderu.
Co jeśli trasy React albo Vue psują się po odświeżeniu?
DeployPages obsługuje fallback SPA dla typowych statycznych konfiguracji frontendu, ale build nadal musi być poprawnie wyeksportowany.
Czy mogę przesyłać wideo albo większe zasoby?
Tak, ale wydajność jest lepsza, gdy bardzo duże media są zoptymalizowane albo hostowane przez właściwy wyspecjalizowany kanał dostawy.
Czy mogę zabezpieczyć stronę hasłem?
Tak w planach, które obejmują ochronę hasłem. Używaj jej do podglądów, dokumentacji wewnętrznej albo etapowych startów.
Przejdź do Explore