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

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

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

आवश्यकताएँ

विकी.जेएस चलाने के लिए आवश्यकताएं इस प्रकार हैं:

• Node.js संस्करण 6.11.1 या बाद का संस्करण
• MongoDB संस्करण 3.2 या बाद का
• संस्करण 2.7.4 या बाद के संस्करण
• एक वेब सर्वर जैसे कि Nginx, Apache, IIS, Caddy, या H2O। यह मार्गदर्शिका Nginx का उपयोग करेगी।
• Git-compliant repository (सार्वजनिक या निजी) यह वैकल्पिक है
• न्यूनतम 512 एमबी रैम। यह कम से कम 1GB रैम वाली मशीन का उपयोग करने के लिए अत्यधिक अनुशंसित है।
• डोमेन नाम A/ AAAAरिकॉर्ड सेट अप के साथ। इस गाइड में हम wiki.example.comएक उदाहरण डोमेन के रूप में उपयोग करेंगे।

शुरू करने से पहले

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

uname -ro
# FreeBSD 11.2-RELEASE

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

freebsd-update fetch install
pkg update && pkg upgrade -y

स्थापित करें sudo, vim, unzip, wget, git, bashऔर socatसंकुल अगर वे अपने सिस्टम पर मौजूद नहीं हैं।

pkg install -y sudo vim unzip wget git bash socat

अपने पसंदीदा उपयोगकर्ता नाम (हम उपयोग करेंगे johndoe) के साथ एक नया उपयोगकर्ता खाता बनाएँ ।

adduser

# Username: johndoe
# Full name: John Doe
# Uid (Leave empty for default): <Enter>
# Login group [johndoe]: <Enter>
# Login group is johndoe. Invite johndoe into other groups? []: wheel
# Login class [default]: <Enter>
# Shell (sh csh tcsh nologin) [sh]: bash
# Home directory [/home/johndoe]: <Enter>
# Home directory permissions (Leave empty for default): <Enter>
# Use password-based authentication? [yes]: <Enter>
# Use an empty password? (yes/no) [no]: <Enter>
# Use a random password? (yes/no) [no]: <Enter>
# Enter password: your_secure_password
# Enter password again: your_secure_password
# Lock out the account after creation? [no]: <Enter>
# OK? (yes/no): yes
# Add another user? (yes/no): no
# Goodbye!

समूह के सदस्यों को किसी भी कमांड को निष्पादित करने की अनुमति देने के लिए, visudoकमांड चलाएं और %wheel ALL=(ALL) ALLलाइन को अनकम्प्लीट करें wheel।

# Uncomment by removing the hash (#) sign
%wheel ALL=(ALL) ALL

अब, अपने नए बनाए गए उपयोगकर्ता पर जाएँ।

su - johndoe

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

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

sudo tzsetup

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

Wiki.js को Node.js 6.11.1 या बाद के संस्करण की आवश्यकता होती है, इसलिए हमें पहले Node.s.s. का उपयुक्त संस्करण स्थापित करना होगा

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

sudo pkg install -y node8 npm-node8

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

node -v && npm -v
# v8.12.0
# 6.4.1

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

Wiki.js एक डेटाबेस इंजन के रूप में MongoDB का उपयोग करता है।

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

sudo pkg install -y mongodb36

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

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

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

sudo sysrc mongod_enable=yes
sudo service mongod start

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

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

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 [email protected]
cd ~

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

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

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

# RSA 2048
sudo /etc/letsencrypt/acme.sh --issue --standalone --home /etc/letsencrypt -d wiki.example.com --ocsp-must-staple --keylength 2048
# ECDSA/ECC P-256
sudo /etc/letsencrypt/acme.sh --issue --standalone --home /etc/letsencrypt -d wiki.example.com --ocsp-must-staple --keylength ec-256

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

• आरएसए: /etc/letsencrypt/wiki.example.com
• ईसीसी / ECDSA: /etc/letsencrypt/wiki.example.com_ecc

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

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

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

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

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

sudo pkg install -y nginx

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

nginx -v
# nginx version: nginx/1.14.0

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

sudo sysrc nginx_enable=yes
sudo service nginx start

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

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

server {

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

  server_name wiki.example.com;

  charset utf-8;
  client_max_body_size 50M;

  # RSA
  ssl_certificate /etc/letsencrypt/wiki.example.com/fullchain.cer;
  ssl_certificate_key /etc/letsencrypt/wiki.example.com/wiki.example.com.key;
  # ECDSA
  ssl_certificate /etc/letsencrypt/wiki.example.com_ecc/fullchain.cer;
  ssl_certificate_key /etc/letsencrypt/wiki.example.com_ecc/wiki.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;
  }

}

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

अब हमें wiki.js.confफ़ाइल को मुख्य nginx.confफ़ाइल में शामिल करने की आवश्यकता है ।

sudo vim /usr/local/etc/nginx/nginx.confनिम्न पंक्ति को चलाएं और http {}ब्लॉक में जोड़ें।

include wiki.js.conf;

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

sudo nginx -t

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

sudo service nginx reload

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

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

sudo mkdir -p /usr/local/www/wiki.example.com

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

cd /usr/local/www/wiki.example.com

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

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

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

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

VERSION=$(curl -L -s -S https://beta.requarks.io/api/version/stable)
curl -L -s -S https://github.com/Requarks/wiki/releases/download/v$VERSION/wiki-js.tar.gz | tar -f - -xz -C .
curl -L -s -S https://github.com/Requarks/wiki/releases/download/v$VERSION/node_modules.tar.gz | tar -f - -xz -C .
cp -n config.sample.yml config.yml

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

node wiki --version
# 1.0.102

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

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

node wiki configure

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

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

PM2 प्रोसेस मैनेजर इंस्टॉल और सेटअप करें

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

PM2 को विश्व स्तर पर स्थापित करें npm।

sudo npm install -g pm2

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

pm2 -v
# 3.2.2

अपने दस्तावेज़ रूट फ़ोल्डर में नेविगेट करें यदि आप पहले से ही वहां नहीं हैं और Wiki.js. रोकें

cd /usr/local/www/wiki.example.com
node wiki stop

PM2 के माध्यम से विकीज शुरू करें।

pm2 start server/index.js --name "Wiki.js"

सूची प्रक्रिया PM2 द्वारा प्रबंधित।

pm2 list

PM2 को स्वयं को स्टार्टअप सेवा के रूप में कॉन्फ़िगर करने के लिए कहें:

pm2 startup

अंत में, कमांड चलाकर वर्तमान पीएम 2 विन्यास को बचाएं:

pm2 save

आपका Wiki.js उदाहरण अब एक पृष्ठभूमि प्रक्रिया के रूप में चलता है, PM2 को इसके प्रक्रिया प्रबंधक के रूप में उपयोग करता है।