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

Για να εγκαταστήσετε το 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· στη συνέχεια ανοίξτε ξανά το τερματικό.
winget install OpenJS.NodeJS.LTS node -vmacOS
Μπορείτε να το εγκαταστήσετε με το επίσημο πακέτο ή με το Homebrew.
brew install node node -vLinux
Η έκδοση στα αποθετήρια των διανομών μπορεί να είναι παλιά· η εγκατάσταση με το nvm είναι ασφαλέστερη.
nvm install --lts nvm use --lts node -vΔημιουργία έργου με το create-next-app
Ο οδηγός create next app είναι το επίσημο εργαλείο εκκίνησης και εγκαθιστά όλα τα απαραίτητα πακέτα με τη μία. Όταν εκτελέσετε την εντολή, ζητά όνομα έργου και μερικές επιλογές· αν δεν είστε σίγουροι, η αποδοχή των προτεινόμενων προεπιλογών είναι μια καλή αρχή.
| Ερώτηση | Σύσταση |
|---|---|
| TypeScript | Ναι· εντοπίζει σφάλματα καθώς γράφετε |
| ESLint | Ναι· για ποιότητα κώδικα |
| Tailwind CSS | Προαιρετικό· επιλέξτε ανάλογα με το σύστημα σχεδίασής σας |
| Φάκελος src/ | Προαιρετικό· διαχωρίζει τα αρχεία ρυθμίσεων από τον κώδικα |
| App Router | Ναι· η προτεινόμενη δομή για νέα έργα |
| Import alias | Αρκεί το προεπιλεγμένο @/* |
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.ts | API endpoint (χειριστές POST και GET) |
Μεταδεδομένα για SEO
Κάθε αρχείο σελίδας ή layout μπορεί να εξάγει ένα αντικείμενο metadata για να ορίσει τον τίτλο, την περιγραφή και τις ετικέτες Open Graph. Για δυναμικές σελίδες χρησιμοποιείται η συνάρτηση generateMetadata. Αυτή η δομή διευκολύνει τη διαχείριση, σε επίπεδο σελίδας, των ετικετών που χρειάζονται για τον σχεδιασμό ιστοσελίδων φιλικό προς το SEO.
Build και μεταβλητές περιβάλλοντος
Πριν δημοσιεύσετε, δημιουργήστε ένα build παραγωγής με το npm run build. Η έξοδος του build απαριθμεί αν κάθε σελίδα παράγεται στατικά ή δυναμικά· μια σελίδα που βγαίνει απρόσμενα δυναμική είναι πρώιμο σημάδι περιττού φόρτου στον διακομιστή.
Οι μεταβλητές περιβάλλοντος φυλάσσονται στο αρχείο .env.local. Μόνο οι μεταβλητές με το πρόθεμα NEXT_PUBLIC_ στέλνονται στο πρόγραμμα περιήγησης· οι κωδικοί βάσης δεδομένων και τα μυστικά κλειδιά API πρέπει να μένουν χωρίς πρόθεμα και να χρησιμοποιούνται μόνο σε κώδικα διακομιστή.
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 τη γραμμή που εμφανίζει στην οθόνη· αυτή η γραμμή κάνει την εφαρμογή να ξεκινά αυτόματα όταν επανεκκινείται ο διακομιστής.
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 startupserver { 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 απαιτεί μόλις λίγες εντολές· η σωστή στρατηγική απόδοσης και ένα στιβαρό περιβάλλον φιλοξενίας κάνουν ένα έργο μακροβιότερο. Αν σχεδιάζετε μια εφαρμογή προσαρμοσμένη στην επιχείρησή σας, όπως κρατήσεις, καταχωρίσεις ή πίνακα διαχείρισης, εξερευνήστε τις λύσεις λογισμικού μας· για έναν γρήγορο ιστότοπο με επίκεντρο το περιεχόμενο, γνωρίστε την ομάδα σχεδιασμού ιστοσελίδων μας.


