نحوه نصب Wiki.js در Debian 9

• الزامات
• Git را نصب کنید
• Node.js را نصب کنید
• MongoDB را نصب کنید
• Nginx را نصب و پیکربندی کنید
• Acme.sh را نصب کنید و یک گواهی Letry Encrypt (اختیاری) دریافت کنید
• Wiki.js را نصب کنید
• PM2 را تنظیم کنید

Wiki.js یک برنامه ویکی مدرن رایگان و منبع باز است که در Node.js ، MongoDB ، Git و Markdown ساخته شده است. کد منبع Wiki.js در GitHub به صورت عمومی میزبانی می شود . این راهنما نحوه نصب Wiki.js را روی نمونه جدید Debian 9 Vultr با استفاده از Node.js ، MongoDB ، PM2 ، Nginx ، Git و Acme.sh. به شما نشان می دهد.

الزامات

• Node.js 6.9.0 یا بالاتر
• MongoDB 3.2 یا بالاتر
• نگینکس
• Git 2.7.4 یا بالاتر
• مخزن سازگار با Git (عمومی یا خصوصی) ( اختیاری )
• حداقل از 768MB RAM
• نام دامنه با A/ AAAAسوابق تنظیم شده است

نسخه Debian را بررسی کنید.

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

Git را نصب کنید

Git را روی دبیان نصب کنید.

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 را نصب و پیکربندی کنید

توصیه می شود که یک سرور وب استاندارد را در مقابل Wiki.js. قرار دهید. این تضمین می کند که شما می توانید از ویژگی هایی مانند SSL ، وب سایت های مختلف ، ذخیره سازی و موارد دیگر استفاده کنید. ما در این آموزش از 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(در صورت استفاده از اس اس ال) پروکسی معکوس برای استفاده 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. Wiki.js 3000بصورت پیش فرض از پورت استفاده می کند .

پیکربندی را بررسی کنید.

sudo nginx -t

بارگیری مجدد Nginx

sudo systemctl reload nginx.service

Acme.sh را نصب کنید و یک گواهی Letry Encrypt (اختیاری) دریافت کنید

ایمن سازی ویکی با استفاده HTTPSاز آن ضروری نیست ، اما این یک عمل خوب برای تأمین ترافیک سایت شماست. به منظور به دست آوردن گواهی SSL از Letry Encrypt از مشتری Acme.sh استفاده خواهیم کرد. Acme.sh یک نرم افزار پوسته یونیکس خالص برای بدست آوردن گواهینامه های SSL از Let Encrypt با وابستگی های صفر است. این باعث می شود در مقایسه با برخی دیگر از پروتکل های 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فهرست.

بعد از اخذ گواهینامه های Let Encrypt ، باید 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

بارگیری مجدد Nginx

sudo systemctl reload nginx.service

Wiki.js را نصب کنید

یک پوشه root root را در جایی که 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

برای مشاهده نسخه نصب شده Wiki.js. می توانید دستور زیر را اجرا کنید.

node wiki --version
# 1.0.78

پس از اتمام نصب ، از شما خواسته می شود که جادوگر پیکربندی را اجرا کنید.

جادوگر پیکربندی را با اجرا شروع کنید.

node wiki configure

با این کار به شما اطلاع می دهید تا http://localhost:3000در پیکربندی Wiki.js. حرکت کنید. اگر جلوی Wiki.js Nginx دارید ، این بدان معنی است که می توانید http://wiki.example.comبه جای مراجعه به سایت ، نام دامنه خود را باز کنید (به عنوان مثال ) localhost.

با استفاده از مرورگر وب ، به http://wiki.example.comدستورالعمل های روی صفحه بروید و پیروی کنید. تمام تنظیمات وارد شده در هنگام جادوگر پیکربندی در config.ymlپرونده ذخیره می شود. جادوگر پیکربندی به طور خودکار Wiki.js را برای شما شروع می کند.

PM2 را تنظیم کنید

به طور پیش فرض ، Wiki.js پس از راه اندازی مجدد سیستم به طور خودکار شروع نمی شود. برای شروع کار در بوت ، باید مدیر پروسه 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و بررسی کنید که Wiki.js پس از راه اندازی مجدد از شروع دوباره شروع می شود.