ServBay के साथ Koa.js प्रोजेक्ट बनाएँ और चलाएँ

ServBay macOS के लिए डिज़ाइन किया गया एक स्थानीय वेब विकास वातावरण है, जिसमें Node.js रनटाइम और कई डेटाबेस सहित अनेक डेवलपर-फ्रेंडली सॉफ़्टवेयर पैकेज एकीकृत हैं। यह लेख बताएगा कि कैसे आप ServBay के सहज वातावरण का लाभ उठाकर तेज़ी से Koa.js प्रोजेक्ट बना, चला और प्रबंधित कर सकते हैं।

Koa.js क्या है?

Koa.js, Express.js टीम द्वारा विकसित, Node.js आधारित अगली पीढ़ी का वेब फ्रेमवर्क है। यह अपने सिंपल, एक्सप्रेसिव और शक्तिशाली फीचर्स के लिए प्रसिद्ध है, और वेब एप्लिकेशन तथा API बनाने के लिए एक आदर्श विकल्प है। Koa.js आधुनिक जावास्क्रिप्ट की ताकत, ख़ासतौर पर async/await सिंटैक्स का अधिकतम उपयोग करता है, जिससे असिंक्रोनस संचालन और मिडलवेयर लिखना बेहद आसान हो जाता है और कोड क्लीन व मेंटेनेबल रहता है।

Koa.js की मुख्य विशेषताएँ

• async/await आधारित: इसकी कोर डिज़ाइन async/await के इर्द-गिर्द है, जिससे असिंक्रोनस फ्लो कंट्रोल अधिक सहज होता है।
• लाइटवेट कोर: Koa का कोर बहुत छोटा है, केवल बुनियादी फीचर्स शामिल हैं; अतिरिक्त कार्यक्षमता के लिए मॉड्यूलर मिडलवेयर का प्रयोग करते हैं।
• पावरफुल मिडलवेयर: कैस्केडिंग मिडलवेयर तंत्र, जिससे रिक्वेस्ट प्रोसेसिंग फ्लो बहुत लचीला व स्पष्ट है।
• वेब केंद्रित: केवल वेब और API विकास पर केंद्रित, गैर-जरूरी अतिरिक्त फीचर्स शामिल नहीं हैं।

Koa.js का इस्तेमाल करके डेवलपर्स तेज़, उच्च-प्रदर्शन और रख-रखाव योग्य वेब सेवाएँ जल्दी बना सकते हैं।

ServBay के साथ Koa.js विकास वातावरण सेटअप करें

ServBay Node.js डेवलपर्स को एक रेडी-टू-यूज़ वातावरण मुहैया कराता है, जिसमें Node.js रनटाइम और मुख्य डेटाबेस सेवा शामिल होती हैं। ServBay की वेबसाइट (Website) कार्यक्षमता के साथ, आप अपना लोकल Koa.js प्रोजेक्ट कस्टम डोमेन व SSL सर्टिफिकेट के साथ आसानी से एक्सेस कर सकते हैं।

पूर्व-आवश्यकताएँ

शुरू करने से पहले, यह सुनिश्चित कर लें:

1. ServBay इंस्टॉल करें: ServBay की ऑफिसियल वेबसाइट पर जाकर लेटेस्ट वर्जन डाउनलोड कर इंस्टॉल करें।
2. Node.js पैकेज इंस्टॉल करें: ServBay ऐप खोलकर पैकेजेस (Packages) प्रबंधन इंटरफ़ेस में जाएँ और ज़रूरी Node.js वर्शन इंस्टॉल करें।
3. ServBay का बुनियादी संचालन जानें: ServBay में सेवाएँ चालू/बंद करना तथा वेबसाइट (Website) का प्रबंधन करना सीख लें।

Koa.js प्रोजेक्ट बनाना

ServBay का अनुशंसित वेबसाइट रूट डायरेक्टरी /Applications/ServBay/www है जहाँ प्रोजेक्ट फ़ाइलें रखें।

1. प्रोजेक्ट डायरेक्टरी इनिशियलाइज़ करें

   टर्मिनल (Terminal) खोलें, ServBay वेबसाइट रूट पर जाएँ, नया फ़ोल्डर बनाएँ (मान लें servbay-koa-app), फिर उसमें जाएँ और नया Node.js प्रोजेक्ट इनिशियलाइज़ करें:

   cd /Applications/ServBay/www
   mkdir servbay-koa-app
   cd servbay-koa-app
   npm init -y

   npm init -y कमांड एक डिफ़ॉल्ट package.json फाइल जेनरेट करेगा।

2. Koa.js इंस्टॉल करें

   प्रोजेक्ट डाइरेक्ट्री servbay-koa-app में npm से Koa.js (और TypeScript के लिए उसका टाइप डिफ़िनिशन) इंस्टॉल करें:

   npm install koa
   # अगर TypeScript यूज़ करते हैं, तो टाइप डिफिनिशन इंस्टॉल करें
   # npm install @types/koa --save-dev

3. ऐप एंट्री फाइल बनाएं

   servbay-koa-app फोल्डर के भीतर app.js नाम की फाइल बनाएं और उसमें यह बेसिक Koa.js कोड लिखें:

   const Koa = require('koa');
   const app = new Koa();
   
   // मिडलवेयर: अनुरोध जानकारी लॉग करें
   app.use(async (ctx, next) => {
     const start = Date.now();
     await next();
     const ms = Date.now() - start;
     console.log(`${ctx.method} ${ctx.url} - ${ms}ms`);
   });
   
   // मिडलवेयर: रूट पाथ अनुरोधों को हैंडल करें
   app.use(async ctx => {
     ctx.body = 'Hello from ServBay Koa.js App!';
   });
   
   // पोर्ट डिफाइन करें, पहले PORT एनवायरमेंट वेरिएबल देखें
   const port = process.env.PORT || 3000;
   
   // HTTP सर्वर प्रारंभ करें
   app.listen(port, () => {
     console.log(`Koa.js server running on http://localhost:${port}`);
     console.log(`Project path: ${__dirname}`);
   });

   यह कोड एक बेसिक Koa ऐप बनाएगा जिसमें दो मिडलवेयर होंगे: एक रिक्वेस्ट टाइमिंग और पाथ लॉगिंग के लिए, और दूसरा / पथ के लिए "Hello from ServBay Koa.js App!" जवाब देने के लिए। ऐप PORT एनवायरमेंट या डिफ़ॉल्ट 3000 पोर्ट पर लिसन करेगा।

डेवलपमेंट मोड में प्रवेश

डेवलपमेंट के दौरान, स्थानीय Node.js प्रोसेस से Koa.js ऐप चलाएँ और ServBay की वेबसाइट (Website) से उसे एक्सेस करें।

1. Koa.js डेव सर्वर चलाएँ

   टर्मिनल में servbay-koa-app फोल्डर पर जाएँ और app.js चलाएँ। पोर्ट टकराव से बचने या ServBay कंफ़िगरेशन के लिए कोई विशिष्ट पोर्ट (जैसे 8585) चुनें:

   cd /Applications/ServBay/www/servbay-koa-app
   PORT=8585 node app.js

   टर्मिनल में Koa.js server running on http://localhost:8585 जैसा आउटपुट दिखेगा, मतलब सर्वर सफलतापूर्वक पोर्ट 8585 पर शुरू हो गया है। टर्मिनल विंडो खुली रखें।

2. ServBay वेबसाइट (Website) रिवर्स प्रॉक्सी कंफ़िगर करें

   कस्टम डोमेन से localhost:8585 पर चल रहे Koa.js ऐप तक पहुँचने के लिए ServBay में एक वेबसाइट (Website) में रिवर्स प्रॉक्सी सेटअप करें:

   • ServBay ऐप खोलें।
   • वेबसाइट (Website) सेक्शन में जाएँ।
   • बाएँ नीचे + बटन चुनकर नई वेबसाइट जोड़ें।
   • वेबसाइट कंफ़िगरेशन भरें:
     • नाम (Name): ServBay Koa.js Dev Site
     • डोमेन (Domain): servbay-koa-dev.servbay.demo ( .servbay.demo एंडिंग से ServBay खुद SSL सर्टिफिकेट जेनरेट करता है)
     • प्रकार (Type): रिवर्स प्रॉक्सी (Reverse Proxy)
     • IP पता (IP Address): 127.0.0.1
     • पोर्ट (Port): 8585
     • रूट डायरेक्ट्री (Document Root): रिवर्स प्रॉक्सी के लिए जरूरी नहीं, खाली रखें या प्रोजेक्ट पाथ /Applications/ServBay/www/servbay-koa-app डाल दें
   • सेव करें।
   • अगर ServBay बदलाव लागू करने को कहे तो "Apply" पर क्लिक करें।

   इसके बाद, ServBay आपके लोकल hosts फाइल में servbay-koa-dev.servbay.demo की एंट्री जोड़ देगा और उसमें आने वाले रिक्वेस्ट ज़रूरत अनुसार लोकल पोर्ट 8585 पर फॉरवर्ड/प्रॉक्सी कर देगा। .servbay.demo डोमेन के कारण SSL भी ऑटोमैटिकली लागू हो जाएगा।

   डिटेल्ड स्टेप्स के लिए आप ServBay के डॉक्युमेंटेशन में Adding Node.js Development Website रेफर कर सकते हैं (इंग्लिश वर्शन देखें)।

3. Koa.js डेव वेबसाइट पर जाएँ

   ब्राउज़र खोलें और https://servbay-koa-dev.servbay.demo ओपन करें।

   अगर सबकुछ सही सेट किया गया है, तो आपको "Hello from ServBay Koa.js App!" मैसेज मिलेगा। app.js फाइल में बदलाव करके व Node.js प्रोसेस रीस्टार्ट कर ब्राउज़र रिफ्रेश करें, अपडेटेड रिस्पॉन्स मिल जाएगा।

प्रोडक्शन वर्शन डिप्लॉय करें (सिमुलेशन)

प्रोडक्शन एनवायरमेंट सिमुलेट करते वक्त अलग पोर्ट, एनवायरमेंट वेरिएबल, आदि लग सकते हैं। ServBay की रिवर्स प्रॉक्सी यही रहती है।

1. Koa.js प्रोडक्शन सर्वर (सिमुलेटेड) चलाएँ

   एक नए टर्मिनल में डेवलपमेंट सर्वर बंद करें (अगर चल रहा है), और प्रोडक्शन मोड में ऐप शुरू करें, जैसे अलग पोर्ट 8586 और NODE_ENV सेट करें:

   cd /Applications/ServBay/www/servbay-koa-app
   PORT=8586 NODE_ENV=production node app.js

   यह पोर्ट 8586 पर Koa.js ऐप चलाएगा, सिमुलेटड प्रोडक्शन रूप में।

2. ServBay वेबसाइट (Website) रिवर्स प्रॉक्सी (प्रोडक्शन सिम्युलेशन) कंफ़िगर करें

   इसी प्रकार, ServBay में नई वेबसाइट जोड़ें, ये भरें:

   • नाम (Name): ServBay Koa.js Prod Site
   • डोमेन (Domain): servbay-koa-prod.servbay.demo (या अपने डोमेन का इस्तेमाल Let's Encrypt के साथ)
   • प्रकार (Type): रिवर्स प्रॉक्सी (Reverse Proxy)
   • IP पता (IP Address): 127.0.0.1
   • पोर्ट (Port): 8586
   • रूट डायरेक्ट्री (Document Root): रिक्त या प्रोजेक्ट पथ

   सेव कर लें और बदलाव लागू करें।

   यदि .servbay.demo डोमेन इस्तेमाल करते हैं तो SSL सर्टिफिकेट ServBay User CA को मिलेगा। पब्लिक डोमेन पर आप ServBay का ACME/Let's Encrypt इंटीग्रेशन भी यूज़ कर सकते हैं। डिटेल्स के लिए देखें: SSL से वेबसाइट सुरक्षित करें।

3. Koa.js प्रोडक्शन वेबसाइट (सिमुलेटेड) पर जाएँ

   ब्राउज़र में जाएँ: https://servbay-koa-prod.servbay.demo

   पेज आउटपुट वही मिलेगा, पर इस बार प्रॉक्सी के माध्यम से पोर्ट 8586 पर चलता सर्वर संभावित प्रोडक्शन मांगों को संभाल रहा है।

डेटाबेस कनेक्शन

ServBay अनेक सामान्यत: प्रचलित डेटाबेस सर्विसेज़ को इनबिल्ट सपोर्ट करता है: MongoDB, Redis, MariaDB (MySQL संगत), PostgreSQL। Koa.js प्रोजेक्ट से कनेक्ट करना बेहद आसान है, क्योंकि सब लोकलहोस्ट पर डिफ़ॉल्ट रूप से ओपन रहती हैं।

नीचे Node.js से इन बेसों के कनेक्शन के उदाहरण हैं। सुनिश्चित करें कि जिस डेटाबेस को आप जोड़ना चाहते हैं, वह ServBay के पैकेजेस (Packages) में इंस्टॉल और रनिंग है।

1. MongoDB से कनेक्ट करें

   पहले, अपने Koa.js प्रोजेक्ट में MongoDB के Node.js ड्राइवर (जैसे mongoose या mongodb) इंस्टॉल करें:

   cd /Applications/ServBay/www/servbay-koa-app
   npm install mongoose # या npm install mongodb

   फिर app.js या किसी अन्य मॉड्यूल में कनेक्शन कोड लिखें:

   // Mongoose का उपयोग कर MongoDB से कनेक्ट करें
   const mongoose = require('mongoose');
   
   // ServBay का डिफ़ॉल्ट MongoDB बिना ऑथेंटिकेशन, DB नाम अपने मुताबिक चुनें
   mongoose.connect('mongodb://localhost:27017/servbay-koa-app', {
     useNewUrlParser: true,
     useUnifiedTopology: true
   })
   .then(() => console.log('Connected to MongoDB'))
   .catch(err => console.error('MongoDB connection error:', err));
   
   // नोट: असल ऐप में कनेक्शन कोड स्टार्टअप लॉजिक में रखते हैं,
   // और कनेक्शन सफल होने के बाद ही पोर्ट लिसन करते हैं।

   ServBay का MongoDB अमूमन पोर्ट 27017 पर ओपन होता है, बिना यूज़र-पासवर्ड के भी कनेक्शन देता है। डाटाबेस नाम न हो, तो भी ऑटोमैटिक बन जाता है।

2. Redis से कनेक्ट करें

   Redis के Node.js क्लाइंट का इंस्टॉलेशन:

   cd /Applications/ServBay/www/servbay-koa-app
   npm install redis

   कनेक्शन:

   // redis क्लाइंट से Redis कनेक्ट करें
   const redis = require('redis');
   
   // Redis क्लाइंट बनाएं, डिफ़ॉल्ट लोकलहोस्ट:6379 कनेक्शन
   const client = redis.createClient({
     url: 'redis://localhost:6379' // ServBay डिफ़ॉल्ट Redis पोर्ट
   });
   
   client.on('connect', () => {
     console.log('Connected to Redis');
   });
   
   client.on('error', (err) => {
     console.error('Redis connection error:', err);
   });
   
   // Redis सर्वर से कनेक्ट करें
   client.connect();
   
   // नोट: असली इस्तेमाल में कनेक्शन के सक्सेस के बाद काम करें,
   // जैसे client.connect() को async/await के साथ यूज़ करना।

   Redis सामान्यत: पोर्ट 6379 पर कोई पासवर्ड के बिना चालू रहता है।

3. MariaDB (या MySQL) से कनेक्ट करें

   MariaDB, MySQL जैसी ही है, APIs समान हैं। ServBay में MariaDB पैकेज मिलता है (MySQL के तरह यूज़ करें)।

   MariaDB Node.js ड्राइवर इंस्टॉल करें:

   cd /Applications/ServBay/www/servbay-koa-app
   npm install mariadb # या npm install mysql2 (अनुशंसित)

   mariadb से कनेक्ट करें:

   // mariadb क्लाइंट से MariaDB कनेक्ट करें
   const mariadb = require('mariadb');
   
   // डिफ़ॉल्ट MariaDB root पासवर्ड 'password' है
   const pool = mariadb.createPool({
     host: 'localhost',
     user: 'root',
     password: 'password',
     database: 'servbay_koa_app', // डेटाबेस बनाएं या नाम बदलें
     connectionLimit: 5
   });
   
   pool.getConnection()
     .then(conn => {
       console.log("Connected to MariaDB");
       conn.release(); // कनेक्शन को पूल में लौटाएँ
     })
     .catch(err => {
       console.error("MariaDB connection error:", err);
     });
   
   // नोट: पूल से कनेक्शन लेना असिंक्रोनस ऑपरेशन है

   mysql2 ड्राइवर (सिफारिश) से कनेक्ट करें:

   // mysql2 क्लाइंट से MariaDB/MySQL कनेक्ट करें
   const mysql = require('mysql2/promise'); // प्रॉमिस वर्शन
   
   // डिफ़ॉल्ट MariaDB root पासवर्ड 'password' है
   const pool = mysql.createPool({
     host: 'localhost',
     user: 'root',
     password: 'password',
     database: 'servbay_koa_app', // डेटाबेस बचे
     waitForConnections: true,
     connectionLimit: 10,
     queueLimit: 0
   });
   
   pool.getConnection()
     .then(conn => {
       console.log("Connected to MariaDB/MySQL using mysql2");
       conn.release(); // कनेक्शन पूल को लौटाएँ
     })
     .catch(err => {
       console.error("MariaDB/MySQL connection error:", err);
     });
   
   // नोट: ServBay में डिफ़ॉल्ट root पासवर्ड GUI के डेटाबेस सेटिंग में देखा-जाँचा और बदला जा सकता है।
   // प्रोजेक्ट में हार्डकोडिड पासवर्ड से बचना चाहिए; इसके लिए एनवायरमेंट वेरिएबल्स यूज़ करें।

   डिफ़ॉल्ट MariaDB पोर्ट 3306 है, root पासवर्ड ServBay GUI में मिलेगा। संभव है कि आपको servbay_koa_app डेटाबेस खुद बनाना पड़े (TablePlus, DBeaver जैसे क्लाइंट से भी)।

4. PostgreSQL से कनेक्ट करें

   PostgreSQL के Node.js ड्राइवर इंस्टॉल करें:

   cd /Applications/ServBay/www/servbay-koa-app
   npm install pg

   कनेक्शन:

   // pg क्लाइंट से PostgreSQL कनेक्ट करें
   const { Pool } = require('pg');
   
   // डिफ़ॉल्ट पोस्टग्रे यूज़र 'user', पासवर्ड 'password'
   const pool = new Pool({
     user: 'user', // ServBay डिफ़ॉल्ट यूज़र
     host: 'localhost',
     database: 'servbay_koa_app', // डेटाबेस बना लें
     password: 'password', // डिफ़ॉल्ट पासवर्ड
     port: 5432, // डिफ़ॉल्ट पोस्टग्रे पोर्ट
   });
   
   pool.connect((err, client, done) => {
     if (err) {
       console.error('PostgreSQL connection error:', err);
       return;
     }
     console.log('Connected to PostgreSQL');
     client.release(); // कनेक्शन पूल को लौटा दें
   });
   
   // नोट: डिफ़ॉल्ट यूज़र व पास ServBay GUI में डेटाबेस सेटिंग में देखें व बदलें।
   // प्रोजेक्ट में हार्डकोडिड पासवर्ड से बचें।

   डिफ़ॉल्ट PostgreSQL पोर्ट 5432 है। username/password ServBay के डेटाबेस मैनेजमेंट GUI में मिलेंगे। संभव है डेटाबेस खुद बनाना पड़े।

ServBay में डेटाबेस प्रबंधन

कोड से जोड़ने के अलावा, आप ग्राफिकल टूल से भी डेटाबेस मैनेजमेंट कर सकते हैं। ServBay के डेटाबेस 127.0.0.1/localhost पर सुनते हैं, GUI में दिखाए गए पोर्ट व यूज़र/पास से कनेक्ट करें।

• डिफ़ॉल्ट पासवर्ड देखें/बदलें: ServBay ऐप में संबंधित डेटाबेस पैकेज के पास सेटिंग पर क्लिक करें, वहाँ डिफ़ॉल्ट root (MariaDB) या user (PostgreSQL) पासवर्ड देख/बदल सकते हैं।
• डेटाबेस/यूज़र बनाएं: TablePlus, DBeaver, pgAdmin, MongoDB Compass जैसे क्लाइंट से कनेक्ट करें, फिर SQL या GUI से डेटाबेस, टेबल, यूज़र बनाएँ।

नोट्स

• पोर्ट टकराव: जिन पोर्ट्स (जैसे 8585, 8586) पर Koa.js चलाएँ, वे किसी और ऐप से व्यस्त न हों।
• ServBay स्टेटस: ServBay ऐप व संबंधित Node.js पैकेज/डेटाबेस चालू हों।
• hosts फाइल: आमतौर पर ServBay खुद होस्ट्स फ़ाइल बदल देता है, लेकिन डोमेन रिजॉल्व न हो, तो /etc/hosts जांचें।
• फ़ायरवॉल: macOS या थर्ड पार्टी फायरवॉल से सर्वर या Node.js की नेटवर्किंग ब्लॉक न हो।
• लॉग जाँचें: किसी भी दिक्कत पर ServBay का लॉग्स टैब व Node.js टर्मिनल आउटपुट देखें।

अक्सर पूछे जाने वाले प्रश्न (FAQ)

• प्रश्न: Koa.js प्रोजेक्ट एक्सेस के लिए ServBay की रिवर्स प्रॉक्सी क्यों?

  उत्तर: रिवर्स प्रॉक्सी (ServBay वेबसाइट फंक्शन) के कई लाभ हैं:

  1. प्रोडक्शन जैसा माहौल: कस्टम डोमेन (जैसे .servbay.demo या आपका अपना डोमेन) यूज़ करना सीधे localhost:PORT के बजाय, रियल वेबसाइट टेस्टिंग जैसा एहसास देता है।
  2. SSL सपोर्ट: ServBay आपके लोकल साइट्स के लिए ऑटोमैटिक SSL सेटअप (ServBay User CA या Let's Encrypt) देता है, जिससे आप HTTPS को भी आसानी से परीक्षण कर सकते हैं।
  3. सेंट्रल प्रबंधन: ServBay में सभी विकास वेबसाइट्स एक जगह से मैनेज होती हैं, सुविधाजनक व तेज।
  4. पोर्ट छुपाना: बाहरी या ब्राउज़र यूज़र 80/443 पर रिक्वेस्ट भेजते हैं, वास्तविक Node.js प्रोसेस पर ट्रैफिक प्रॉक्सी होता है।

• प्रश्न: क्या मैं रिवर्स प्रॉक्सी के बिना सीधे localhost:PORT से एक्सेस कर सकता हूँ?

  उत्तर: बिल्कुल। अगर Koa.js ऐप किसी पोर्ट (जैसे 3000 या अन्य) पर चल रहा है तो ब्राउज़र में सीधे http://localhost:PORT खोल सकते हैं। मगर ServBay के कस्टम डोमेन, ऑटो SSL, साइट-स्तर लॉग आदि खूबियाँ नहीं मिलेंगी। रियल डिप्लॉय जैसा अहसास चाहिए तो ServBay की रिवर्स प्रॉक्सी अच्छा विक्लप है।

• प्रश्न: ServBay का डिफ़ॉल्ट डेटाबेस पासवर्ड क्या है? कैसे बदलें?

  उत्तर: ServBay का डिफ़ॉल्ट डेटाबेस पासवर्ड आप ServBay ऐप के डेटाबेस उपखंड में पाएँगे। संबंधित डेटाबेस (जैसे MariaDB, PostgreSQL) के पास सेटिंग्स आइकन क्लिक करें, जानकारी विंडो में डिफ़ॉल्ट यूज़र व पासवर्ड दिख जाएगा। आप चाहें तो वहीं पासवर्ड बदल सकते हैं। सुरक्षा के लिए पासवर्ड अवश्य बदलें।

संक्षिप्त सारांश

इस लेख से आपने सीखा कि macOS पर ServBay से Koa.js विकास व्यवस्था कैसे तैयार करें। हमने आधारभूत Koa.js ऐप बनाया और उसे ServBay वेबसाइट की मदद से रिवर्स प्रॉक्सी के जरिए कस्टम डोमेन और HTTPS के साथ लोकल पर तथा सिम्युलेटेड प्रोडक्शन उदाहरणों में चलाया। साथ ही ServBay के डिफ़ॉल्ट डेटाबेस से कनेक्ट करने का तरीका भी समझा।

ServBay Node.js डेवलपर्स के लिए एक इंटीग्रेटेड, मैनेजेबल लोकल डेव एनवायरनमेंट देता है, जिससे आप कोडिंग पर ध्यान केंद्रित कर सकते हैं, न कि माहौल सेटअप की झंझटों पर। ServBay की क्षमताओं से आपके विकास की गति काफी तेज़ होगी।