डेबियन 9 पर विकीज को कैसे स्थापित करें

• आवश्यकताएँ
• गिट स्थापित करें
• Node.js स्थापित करें
• MongoDB स्थापित करें
• स्थापित करें और Nginx को कॉन्फ़िगर करें
• Acme.sh को इनस्टॉल करें और लेट एनक्रिप्ट सर्टिफिकेट (वैकल्पिक) प्राप्त करें
• Wiki.js स्थापित करें
• PM2 सेटअप करें

Wiki.js एक स्वतंत्र और खुला स्रोत है, आधुनिक विकी ऐप है जिसे Node.js, MongoDB, Git और Markdown पर बनाया गया है। Wiki.js स्रोत कोड सार्वजनिक रूप से GitHub पर होस्ट किया गया है । यह मार्गदर्शिका आपको दिखाएगी कि कैसे विकोडी को स्थापित किया जाए। Node.js, MongoDB, PM2, Nginx, Git और Acme.sh का उपयोग करके एक नए डेबियन 9 वल्चर उदाहरण पर Wiki.js स्थापित करें।

आवश्यकताएँ

• Node.js 6.9.0 या बाद का
• MongoDB 3.2 या बाद का
• nginx
• २. G.४ या बाद में
• एक अनुवर्ती भंडार (सार्वजनिक या निजी) ( वैकल्पिक )
• की न्यूनतम 768MB RAM
• डोमेन नाम A/ AAAAरिकॉर्ड सेट अप के साथ

डेबियन संस्करण की जाँच करें।

lsb_release -ds
# Debian GNU/Linux 9.4 (stretch)

सुनिश्चित करें कि आपका सिस्टम पुराना है।

apt update && apt upgrade -y

आवश्यक पैकेज स्थापित करें।

apt install -y build-essential apt-transport-https sudo curl wget dirmngr sudo

एक्सेस और स्विच के non-rootसाथ एक नया उपयोगकर्ता खाता बनाएं sudo।

adduser johndoe --gecos "John Doe"
usermod -aG sudo johndoe
su - johndoe

नोट : अपने उपयोगकर्ता नाम के साथ बदलें johndoe।

टाइमजोन सेट करें।

sudo dpkg-reconfigure tzdata

गिट स्थापित करें

डेबियन पर गिट स्थापित करें।

sudo apt install -y git

Git संस्करण सत्यापित करें।

git --version
# git version 2.11.0

Node.js स्थापित करें

Node.js के लिए NodeSource APT रिपॉजिटरी का उपयोग करके Node.js स्थापित करें

curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash -
sudo apt install -y nodejs

Node.js और npm संस्करणों की जाँच करें।

node -v && npm -v
# v8.11.2
# 5.6.0

MongoDB स्थापित करें

Wiki.js एक डेटाबेस इंजन के रूप में MongoDB का उपयोग करता है। उसी के अनुसार, हमें अपने सर्वर पर MongoDB स्थापित करना होगा। हम स्थापना के लिए आधिकारिक MongoDB रिपॉजिटरी का उपयोग करेंगे ।

MongoDB सामुदायिक संस्करण स्थापित करें।

sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 2930ADAE8CAF5059EE73BB4B58712A2291FA4AD5
echo "deb http://repo.mongodb.org/apt/debian stretch/mongodb-org/3.6 main" | sudo tee /etc/apt/sources.list.d/mongodb-org-3.6.list
sudo apt update
sudo apt install -y mongodb-org

संस्करण की जाँच करें।

mongo --version | head -n 1 && mongod --version | head -n 1
# MongoDB shell version v3.6.5
# db version v3.6.5

MongoDB सक्षम और प्रारंभ करें।

sudo systemctl enable mongod.service
sudo systemctl start mongod.service

स्थापित करें और Nginx को कॉन्फ़िगर करें

विकी.जेएस के सामने एक मानक वेब सर्वर रखने की अत्यधिक अनुशंसा की जाती है यह सुनिश्चित करता है कि आप एसएसएल, कई वेबसाइटों, कैशिंग और अधिक जैसी सुविधाओं का उपयोग कर सकते हैं। हम इस ट्यूटोरियल में नग्नेक्स का उपयोग करेंगे, लेकिन कोई अन्य सर्वर करेगा, आपको बस इसे ठीक से कॉन्फ़िगर करने की आवश्यकता है।

Nginx स्थापित करें।

wget https://nginx.org/keys/nginx_signing.key
sudo apt-key add nginx_signing.key
rm nginx_signing.key
sudo -s
printf "deb https://nginx.org/packages/mainline/debian/ $(lsb_release -sc) nginx\ndeb-src https://nginx.org/packages/mainline/debian/ $(lsb_release -sc) nginx\n" >> /etc/apt/sources.list.d/nginx_mainline.list
exit
sudo apt update
sudo apt install -y nginx

संस्करण की जाँच करें।

sudo nginx -v
# nginx version: nginx/1.15.0

सक्षम करें और Nginx शुरू करें।

sudo systemctl enable nginx.service
sudo systemctl start nginx.service

Nginx को कॉन्फ़िगर करें HTTPया HTTPS(यदि आप SSL का उपयोग करते हैं) Wiki.js अनुप्रयोग के लिए रिवर्स प्रॉक्सी।

sudo vim /etc/nginx/conf.d/wiki.js.confनीचे दिए गए मूल रिवर्स प्रॉक्सी कॉन्फ़िगरेशन के साथ इसे चलाएँ और पॉप्युलेट करें।

server {

    listen [::]:80;
    listen 80;

    server_name wiki.example.com;

    root /usr/share/nginx/html;

    charset utf-8;
    client_max_body_size 50M;

    location /.well-known/acme-challenge/ {
        allow all;
    }

    location / {
        proxy_set_header Host $http_host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_pass http://127.0.0.1:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_next_upstream error timeout http_502 http_503 http_504;
    }

}

उपरोक्त विन्यास में आपको जिन चीजों को बदलने की आवश्यकता है, वे हैं केवल server_nameनिर्देश, और proxy_passयदि आप किसी अन्य पोर्ट को कॉन्फ़िगर करने का निर्णय लेते हैं, तो संभवतः यह निर्देश है 3000। विकी.जेएस 3000डिफ़ॉल्ट रूप से पोर्ट का उपयोग करता है ।

कॉन्फ़िगरेशन की जाँच करें।

sudo nginx -t

रीलोडेड नेग्नेक्स।

sudo systemctl reload nginx.service

Acme.sh को इनस्टॉल करें और लेट एनक्रिप्ट सर्टिफिकेट (वैकल्पिक) प्राप्त करें

अपनी विकि को सुरक्षित रखना HTTPSआवश्यक नहीं है, लेकिन यह आपकी साइट के यातायात को सुरक्षित करने के लिए एक अच्छा अभ्यास है। लेट्स एनक्रिप्ट से SSL सर्टिफिकेट प्राप्त करने के लिए हम Acme.sh क्लाइंट का उपयोग करेंगे। Acme.sh एक शुद्ध यूनिक्स शेल सॉफ्टवेयर है जो शून्य निर्भरता वाले चलो एनक्रिप्ट से एसएसएल प्रमाणपत्र प्राप्त करने के लिए है। यह कुछ अन्य ACME प्रोटोकॉल ग्राहकों की तुलना में बहुत हल्का बनाता है जिन्हें सफलतापूर्वक चलाने के लिए बहुत अधिक निर्भरता की आवश्यकता होती है।

Acme.sh को डाउनलोड और इंस्टॉल करें।

sudo mkdir /etc/letsencrypt
git clone https://github.com/Neilpang/acme.sh.git
cd acme.sh
sudo ./acme.sh --install --home /etc/letsencrypt --accountemail your_email@example.com
cd ~

संस्करण की जाँच करें।

/etc/letsencrypt/acme.sh --version
# v2.7.9

के लिए RSA और ECDSA प्रमाणपत्र प्राप्त करें wiki.example.com।

# RSA 2048
sudo /etc/letsencrypt/acme.sh --issue --home /etc/letsencrypt -d wiki.example.com --webroot /usr/share/nginx/html --reloadcmd "sudo systemctl reload nginx.service" --accountemail your_email@example.com --ocsp-must-staple --keylength 2048
# ECDSA/ECC P-256
sudo /etc/letsencrypt/acme.sh --issue --home /etc/letsencrypt -d wiki.example.com --webroot /usr/share/nginx/html --reloadcmd "sudo systemctl reload nginx.service" --accountemail your_email@example.com --ocsp-must-staple --keylength ec-256 

नोट : अपने डोमेन नाम के साथ बदलना न भूलें wiki.example.com।

उपरोक्त आदेशों को चलाने के बाद, आपके प्रमाणपत्र और कुंजियाँ निम्नलिखित निर्देशिकाओं में होंगी।

• RSA के लिए: /etc/letsencrypt/wiki.example.comनिर्देशिका।
• ECC / ECDSA के लिए: /etc/letsencrypt/wiki.example.com_eccनिर्देशिका।

लेट्स एनक्रिप्ट से प्रमाण पत्र प्राप्त करने के बाद, हमें उनका लाभ लेने के लिए Nginx को कॉन्फ़िगर करने की आवश्यकता है।

sudo vim /etc/nginx/conf.d/wiki.js.confफिर से चलाएँ और Nginx को एक HTTPSरिवर्स प्रॉक्सी के रूप में कॉन्फ़िगर करें ।

server {

    listen [::]:443 ssl http2;
    listen 443 ssl http2;
    listen [::]:80;
    listen 80;

    server_name wiki.example.com;

    root /usr/share/nginx/html;

    charset utf-8;
    client_max_body_size 50M;

    location /.well-known/acme-challenge/ {
        allow all;
    }

    # RSA
    ssl_certificate /etc/letsencrypt/wiki.example.com/fullchain.cer;
    ssl_certificate_key /etc/letsencrypt/wiki.example.com/example.com.key;
    # ECDSA
    ssl_certificate /etc/letsencrypt/wiki.example.com_ecc/fullchain.cer;
    ssl_certificate_key /etc/letsencrypt/wiki.example.com_ecc/example.com.key;

    location / {
        proxy_set_header Host $http_host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_pass http://127.0.0.1:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_next_upstream error timeout http_502 http_503 http_504;
    }

}

कॉन्फ़िगरेशन की जाँच करें।

sudo nginx -t

रीलोडेड नेग्नेक्स।

sudo systemctl reload nginx.service

Wiki.js स्थापित करें

एक रिक्त दस्तावेज़ रूट फ़ोल्डर बनाएँ जहाँ Wiki.js को स्थापित किया जाना चाहिए।

sudo mkdir -p /var/www/wiki.example.com

दस्तावेज़ रूट फ़ोल्डर में नेविगेट करें।

cd /var/www/wiki.example.com

/var/www/wiki.example.comउपयोगकर्ता के लिए फ़ोल्डर का स्वामित्व बदलें johndoe।

sudo chown -R johndoe:johndoe /var/www/wiki.example.com

से /var/www/wiki.example.comफ़ोल्डर, डाउनलोड करने के लिए निम्न आदेश चला और स्थापित Wiki.js.

curl -sSo- https://wiki.js.org/install.sh | bash

विकी.जे के वर्तमान में स्थापित संस्करण को देखने के लिए आप निम्नलिखित कमांड को चला सकते हैं

node wiki --version
# 1.0.78

एक बार इंस्टॉलेशन पूरा हो जाने के बाद, आपको कॉन्फ़िगरेशन विज़ार्ड चलाने के लिए प्रेरित किया जाएगा।

कॉन्फ़िगरेशन विज़ार्ड को चलाकर प्रारंभ करें।

node wiki configure

यह आपको http://localhost:3000Wiki.js. को कॉन्फ़िगर करने के लिए नेविगेट करने के लिए सूचित करेगा। यदि आपके पास विकी.जेएस के सामने नगनेक्स है, तो इसका मतलब है कि आप http://wiki.example.comजाने के बजाय अपना डोमेन नाम (जैसे ) खोल सकते हैं localhost।

अपने वेब ब्राउज़र का उपयोग करते हुए, http://wiki.example.comऑन-स्क्रीन निर्देशों को नेविगेट करें और उनका पालन करें। कॉन्फ़िगरेशन विज़ार्ड के दौरान दर्ज की गई सभी सेटिंग्स config.ymlफ़ाइल में सहेजी जाती हैं । कॉन्फ़िगरेशन विज़ार्ड स्वचालित रूप से आपके लिए Wiki.js शुरू कर देगा।

PM2 सेटअप करें

डिफ़ॉल्ट रूप से, विकी.जेएस सिस्टम रिबूट के बाद स्वचालित रूप से शुरू नहीं होगा। इसे बूट पर शुरू करने के लिए, हमें PM2 प्रक्रिया प्रबंधक को सेटअप करने की आवश्यकता है। PM2 Wiki.js के साथ एक स्थानीय NPM मॉड्यूल के रूप में आता है, इसलिए हमें विश्व स्तर पर PM2 को स्थापित करने की आवश्यकता नहीं है।

खुद को स्टार्टअप सेवा के रूप में कॉन्फ़िगर करने के लिए PM2 को बताएं।

/var/www/wiki.example.com/node_modules/pm2/bin/pm2 startup

अंत में, वर्तमान PM2 कॉन्फ़िगरेशन को सहेजें।

/var/www/wiki.example.com/node_modules/pm2/bin/pm2 save

आपका Wiki.js उदाहरण एक पृष्ठभूमि प्रक्रिया के रूप में चलता है, PM2 को इसके प्रक्रिया प्रबंधक के रूप में उपयोग करता है। आप अपने ओएस को रिबूट कर सकते हैं sudo rebootऔर जांचें कि क्या रिबूट के बाद विकीज शुरू होता है।