Οδηγοί εγκατάστασης

Εγκατάσταση Next.js και δημοσίευση

Οδηγός βήμα προς βήμα για τη δημιουργία ενός έργου Next.js με το create-next-app, την κατανόηση της δομής φακέλων του App Router και την ανάπτυξη του έργου στο Vercel ή στον δικό σας διακομιστή.

Aurora YazılımΣυντακτική ομάδα 6 λεπτά ανάγνωσης
Installing Next.js and Going Live
Πώς εγκαθίσταται το Next.js;

Για να εγκαταστήσετε το Next.js, εγκαταστήστε την τρέχουσα έκδοση LTS του Node.js και στη συνέχεια εκτελέστε στο τερματικό την εντολή npx create-next-app@latest. Ο οδηγός σάς ρωτά για TypeScript, ESLint, Tailwind CSS και τον App Router. Μπείτε στον φάκελο του έργου και ξεκινήστε τον διακομιστή ανάπτυξης με npm run dev· ο ιστότοπος ανοίγει στο localhost:3000, ενώ το npm run build χρησιμοποιείται για την παραγωγή.

Τι είναι το Next.js και ποιοι πρέπει να το χρησιμοποιούν;

Το Next.js είναι ένα πλαίσιο web εφαρμογών χτισμένο πάνω στο React. Ενώ το React αποδίδει μόνο στοιχεία διεπαφής, το Next.js προσφέρει έτοιμα δρομολόγηση, απόδοση σελίδων στον διακομιστή, στατική παραγωγή σελίδων, βελτιστοποίηση εικόνων και API endpoints.

Η μεγαλύτερη διαφορά του είναι ότι μπορεί να παράγει σελίδες ως HTML στον διακομιστή. Οι μηχανές αναζήτησης και οι προεπισκοπήσεις στα μέσα κοινωνικής δικτύωσης βλέπουν απευθείας το περιεχόμενο και η πρώτη φόρτωση γίνεται ταχύτερη. Έτσι ταιριάζει καλύτερα από τις εφαρμογές μίας σελίδας σε επαγγελματικούς ιστότοπους με πολύ περιεχόμενο, σελίδες καταλόγου και blogs.

Αν φτιάχνετε μόνο έναν πίνακα διαχείρισης που απαιτεί σύνδεση, μπορεί να αρκεί μια απλούστερη διάταξη· για αυτό το σενάριο δείτε τον οδηγό μας εγκατάσταση React με Vite.

Προαπαιτούμενα

Το Next.js είναι αυστηρό ως προς τις εκδόσεις του Node.js που υποστηρίζει και σταματά να υποστηρίζει παλαιότερες εκδόσεις σε νέες μείζονες εκδόσεις. Γι' αυτό η εγκατάσταση της τρέχουσας έκδοσης LTS από το nodejs.org είναι ο πιο ομαλός δρόμος.

  • Η τρέχουσα έκδοση LTS του Node.js και το npm (που έρχεται μαζί με το Node)· μπορούν να χρησιμοποιηθούν και τα pnpm, yarn ή bun.
  • Ένας επεξεργαστής κώδικα· για μια ρύθμιση με προτεινόμενες επεκτάσεις, δείτε το άρθρο για την εγκατάσταση του VS Code.
  • Git και ένα απομακρυσμένο αποθετήριο (GitHub, GitLab): οι διαδικασίες ανάπτυξης τροφοδοτούνται συνήθως από το αποθετήριο.
  • Αν θα κάνετε ανάπτυξη στον δικό σας διακομιστή, ένας διακομιστής Linux με πρόσβαση SSH.

Εγκατάσταση και επαλήθευση του Node.js

Η εγκατάσταση του Node.js διαφέρει ελαφρώς ανά λειτουργικό σύστημα· οι εντολές του Next.js είναι ίδιες παντού μετά την εγκατάσταση.

Windows

Κατεβάστε το πρόγραμμα εγκατάστασης LTS από το nodejs.org ή χρησιμοποιήστε το winget· στη συνέχεια ανοίξτε ξανά το τερματικό.

powershell
winget install OpenJS.NodeJS.LTS node -v

macOS

Μπορείτε να το εγκαταστήσετε με το επίσημο πακέτο ή με το Homebrew.

bash
brew install node node -v

Linux

Η έκδοση στα αποθετήρια των διανομών μπορεί να είναι παλιά· η εγκατάσταση με το nvm είναι ασφαλέστερη.

bash
nvm install --lts nvm use --lts node -v

Δημιουργία έργου με το create-next-app

Ο οδηγός create next app είναι το επίσημο εργαλείο εκκίνησης και εγκαθιστά όλα τα απαραίτητα πακέτα με τη μία. Όταν εκτελέσετε την εντολή, ζητά όνομα έργου και μερικές επιλογές· αν δεν είστε σίγουροι, η αποδοχή των προτεινόμενων προεπιλογών είναι μια καλή αρχή.

ΕρώτησηΣύσταση
TypeScriptΝαι· εντοπίζει σφάλματα καθώς γράφετε
ESLintΝαι· για ποιότητα κώδικα
Tailwind CSSΠροαιρετικό· επιλέξτε ανάλογα με το σύστημα σχεδίασής σας
Φάκελος src/Προαιρετικό· διαχωρίζει τα αρχεία ρυθμίσεων από τον κώδικα
App RouterΝαι· η προτεινόμενη δομή για νέα έργα
Import aliasΑρκεί το προεπιλεγμένο @/*
bashΕγκατάσταση και διακομιστής ανάπτυξης
npx create-next-app@latest benim-sitem cd benim-sitem npm run dev

Κατανόηση της δομής του App Router

Ο App Router του Next.js δημιουργεί τη δρομολόγηση από τη δομή φακέλων. Κάθε φάκελος κάτω από τον φάκελο app είναι ένα τμήμα URL· το αρχείο page.tsx σε αυτόν τον φάκελο ορίζει τη σελίδα και το layout.tsx ορίζει τον κοινό σκελετό αυτής της ενότητας.

Στον App Router, τα στοιχεία είναι από προεπιλογή server components: εκτελούνται στον διακομιστή, μπορούν να ανακτούν δεδομένα απευθείας και δεν στέλνουν JavaScript στο πρόγραμμα περιήγησης. Για στοιχεία που χρειάζονται αλληλεπίδραση, όπως κλικ ή κατάσταση φόρμας, προσθέτετε την οδηγία use client στην πρώτη γραμμή, ώστε να γίνουν client components.

ΑρχείοURL / σκοπός
app/layout.tsxΡιζικός σκελετός ολόκληρου του ιστότοπου: html, body, κοινή κεφαλίδα και υποσέλιδο
app/page.tsxΑρχική σελίδα (/)
app/hakkimizda/page.tsxΗ διεύθυνση /hakkimizda
app/blog/[slug]/page.tsxΔυναμική διεύθυνση: /blog/οποιοδήποτε-άρθρο
app/not-found.tsxΣελίδα 404
app/api/iletisim/route.tsAPI endpoint (χειριστές POST και GET)

Μεταδεδομένα για SEO

Κάθε αρχείο σελίδας ή layout μπορεί να εξάγει ένα αντικείμενο metadata για να ορίσει τον τίτλο, την περιγραφή και τις ετικέτες Open Graph. Για δυναμικές σελίδες χρησιμοποιείται η συνάρτηση generateMetadata. Αυτή η δομή διευκολύνει τη διαχείριση, σε επίπεδο σελίδας, των ετικετών που χρειάζονται για τον σχεδιασμό ιστοσελίδων φιλικό προς το SEO.

Build και μεταβλητές περιβάλλοντος

Πριν δημοσιεύσετε, δημιουργήστε ένα build παραγωγής με το npm run build. Η έξοδος του build απαριθμεί αν κάθε σελίδα παράγεται στατικά ή δυναμικά· μια σελίδα που βγαίνει απρόσμενα δυναμική είναι πρώιμο σημάδι περιττού φόρτου στον διακομιστή.

Οι μεταβλητές περιβάλλοντος φυλάσσονται στο αρχείο .env.local. Μόνο οι μεταβλητές με το πρόθεμα NEXT_PUBLIC_ στέλνονται στο πρόγραμμα περιήγησης· οι κωδικοί βάσης δεδομένων και τα μυστικά κλειδιά API πρέπει να μένουν χωρίς πρόθεμα και να χρησιμοποιούνται μόνο σε κώδικα διακομιστή.

bash
npm run build npm run start

Πώς πρέπει να αποδίδεται κάθε σελίδα;

Η δύναμη του Next.js προέρχεται από τη δυνατότητα να επιλέγετε διαφορετική στρατηγική απόδοσης για κάθε σελίδα. Μια λάθος επιλογή σημαίνει είτε περιττό κόστος διακομιστή είτε παλιό περιεχόμενο, γι' αυτό ταξινομήστε τις σελίδες σας ανά τύπο αμέσως μετά την εγκατάσταση.

Σελίδες που αλλάζουν σπάνια, όπως οι σελίδες «σχετικά με εμάς», υπηρεσιών και επικοινωνίας, ταιριάζουν ιδανικά στη στατική παραγωγή: δημιουργούνται μία φορά κατά το build και σερβίρονται από το CDN σε κλάσμα του δευτερολέπτου. Σχεδόν όλες οι σελίδες ενός εταιρικού ιστότοπου ανήκουν σε αυτή την ομάδα.

Για σελίδες που ενημερώνονται περιστασιακά, όπως το blog και οι λίστες προϊόντων, η αναδημιουργία ανά τακτά διαστήματα (revalidate) είναι μια καλή ισορροπία. Πίνακες ελέγχου ανά χρήστη, καλάθια ή οθόνες κρατήσεων με ζωντανή διαθεσιμότητα πρέπει να παράγονται στον διακομιστή σε κάθε αίτημα. Αυτή η τελευταία ομάδα είναι συνηθισμένο σενάριο σε κλαδικό λογισμικό, όπως συστήματα ξενοδοχείων και πρακτορείων, και απαιτεί να σκεφτείτε μαζί τον σχεδιασμό βάσης δεδομένων, cache και εξουσιοδότησης.

Επιλογές ανάπτυξης του Next.js

Υπάρχουν τρεις συνηθισμένοι δρόμοι για την ανάπτυξη του Next.js. Ποιον θα επιλέξετε εξαρτάται από την επισκεψιμότητα, τον προϋπολογισμό, την τοποθεσία των δεδομένων και την εμπειρία της ομάδας σας στη διαχείριση διακομιστών.

  • Vercel: η πλατφόρμα της εταιρείας που αναπτύσσει το Next.js. Συνδέετε το αποθετήριο και κάθε push παράγει αυτόματο build και ένα URL προεπισκόπησης.
  • Ο δικός σας διακομιστής Node.js: ένας διαχειριστής διεργασιών όπως το PM2 κρατά την εφαρμογή σε λειτουργία με το npm run start, με το Nginx τοποθετημένο μπροστά. Προσφέρει πλήρη έλεγχο, αλλά η συντήρηση είναι δική σας ευθύνη.
  • Στατική εξαγωγή: με τη ρύθμιση output: 'export' στο αρχείο next.config, ο ιστότοπος μετατρέπεται σε απλά αρχεία HTML. Δυναμικές λειτουργίες που απαιτούν server components δεν λειτουργούν σε αυτή τη λειτουργία.

Δημοσίευση με PM2 και Nginx

Σε διακομιστή βασισμένο στο Ubuntu, αφού εγκαταστήσετε το Node.js, κατεβάστε το έργο από το αποθετήριο, κάντε build και ξεκινήστε το με το PM2. Η εντολή startup του PM2 σας ζητά να εκτελέσετε με sudo τη γραμμή που εμφανίζει στην οθόνη· αυτή η γραμμή κάνει την εφαρμογή να ξεκινά αυτόματα όταν επανεκκινείται ο διακομιστής.

bash
git clone https://github.com/kullanici/benim-sitem.git cd benim-sitem npm ci npm run build sudo npm install -g pm2 pm2 start npm --name benim-sitem -- start pm2 save pm2 startup
nginxΡύθμιση reverse proxy του Nginx
server { listen 80; server_name ornek.com www.ornek.com; location / { proxy_pass http://127.0.0.1:3000; proxy_set_header Host $host; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } }

Συνήθη σφάλματα και λύσεις

Τα περισσότερα σφάλματα στα έργα Next.js προέρχονται από ασυμβατότητα εκδόσεων ή από ανάμειξη κώδικα διακομιστή και πελάτη. Για προβλήματα διαχείρισης πακέτων μπορεί να βοηθήσει και ο οδηγός μας για τις εντολές npm.

ΣύμπτωμαΛύση
Προειδοποίηση ότι η έκδοση Node δεν υποστηρίζεταιΜεταβείτε στην τρέχουσα έκδοση LTS· αν χρησιμοποιείτε nvm, εκτελέστε nvm use --lts
Η θύρα 3000 είναι σε χρήσηΕπιλέξτε άλλη θύρα με npm run dev -- -p 3001
Σφάλμα Hydration failedΜετακινήστε τον κώδικα που παράγει διαφορετικό αποτέλεσμα στον διακομιστή και στο πρόγραμμα περιήγησης (ημερομηνίες, τυχαίοι αριθμοί, χρήση του window) σε ένα client component ή μέσα σε useEffect
Δεν μπορεί να χρησιμοποιηθεί το useState σε server componentΠροσθέστε την οδηγία use client στην πρώτη γραμμή του αρχείου
Η μεταβλητή περιβάλλοντος είναι κενή στην παραγωγήΟρίστε τη μεταβλητή και στον διακομιστή· αν τη χρειάζεστε στο πρόγραμμα περιήγησης, χρησιμοποιήστε το πρόθεμα NEXT_PUBLIC_ και κάντε ξανά build

Συχνές ερωτήσεις

01Να χρησιμοποιήσω Pages Router ή App Router;

Για νέα έργα, η επίσημη σύσταση είναι ο App Router· λειτουργίες όπως τα server components, τα ένθετα layouts και η streaming απόδοση υπάρχουν μόνο σε αυτή τη δομή. Ο Pages Router εξακολουθεί να υποστηρίζεται, επομένως δεν χρειάζεται να βιαστείτε να μεταφέρετε ένα παλιό έργο.

02Είναι απαραίτητο το Vercel για το Next.js;

Όχι. Το Next.js είναι ανοιχτού κώδικα και τρέχει σε οποιονδήποτε διακομιστή ή container Docker που μπορεί να εκτελέσει Node.js. Το Vercel κάνει την εγκατάσταση ευκολότερη· ο δικός σας διακομιστής μπορεί να προσφέρει πλεονεκτήματα στο κόστος, στην τοποθεσία των δεδομένων και στον έλεγχο.

03Τρέχει ένα έργο Next.js σε shared hosting;

Ένα έργο που χρειάζεται λειτουργίες διακομιστή δεν τρέχει σε κλασικό shared hosting όπου δεν μπορεί να εκτελεστεί διεργασία Node.js. Αν ο ιστότοπός σας είναι πλήρως στατικός, μπορείτε να ανεβάσετε τα αρχεία που παράγονται με το output: export· διαφορετικά χρειάζεστε VPS ή περιβάλλον με Node.

Η εγκατάσταση του Next.js απαιτεί μόλις λίγες εντολές· η σωστή στρατηγική απόδοσης και ένα στιβαρό περιβάλλον φιλοξενίας κάνουν ένα έργο μακροβιότερο. Αν σχεδιάζετε μια εφαρμογή προσαρμοσμένη στην επιχείρησή σας, όπως κρατήσεις, καταχωρίσεις ή πίνακα διαχείρισης, εξερευνήστε τις λύσεις λογισμικού μας· για έναν γρήγορο ιστότοπο με επίκεντρο το περιεχόμενο, γνωρίστε την ομάδα σχεδιασμού ιστοσελίδων μας.

Συνεχίστε την ανάγνωση

Σχετικά άρθρα

Όλες οι αναρτήσεις Οδηγών εγκατάστασης