نحوه نصب Wiki.js در Fedora 28

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

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

الزامات

موارد لازم برای اجرای Wiki.js موارد زیر است:

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

قبل از اینکه شروع کنی

نسخه سیستم عامل را بررسی کنید.

cat /etc/fedora-release
# Fedora release 28 (Twenty Eight)

یک حساب کاربری غیر ریشه جدید با دسترسی سودو ایجاد کنید و به آن سوئیچ کنید.

useradd -c "John Doe" johndoe && passwd johndoe
usermod -aG wheel johndoe
su - johndoe

توجه: با نام کاربری خود جایگزین johndoeکنید.

اطمینان حاصل کنید که سیستم شما به روز است.

sudo dnf check-upgrade || sudo dnf upgrade -y

منطقه زمانی را تنظیم کنید.

timedatectl list-timezones
sudo timedatectl set-timezone 'Region/City'

بسته های لازم و مفید را نصب کنید.

sudo dnf install -y wget vim unzip bash-completion git

برای سادگی ، SELinux و Firewall را غیرفعال کنید.

sudo setenforce 0
sudo systemctl stop firewalld
sudo systemctl disable firewalld

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

Wiki.js به Node.js 6.9.0 یا بالاتر نیاز دارد ، بنابراین ابتدا نیاز به نصب Node.js.

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

sudo dnf install -y nodejs

نسخه های Node.js و npm را بررسی کنید.

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

MongoDB را نصب کنید

Wiki.js از MongoDB به عنوان موتور پایگاه داده استفاده می کند. با توجه به آن ، ما نیاز به نصب MongoDB بر روی سرور خود داریم.

MongoDB را نصب کنید.

sudo dnf install -y mongodb mongodb-server

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

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

MongoDB را فعال کرده و شروع کنید.

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

Nginx را نصب و پیکربندی کنید

Wiki.js می تواند بدون هیچ سرور وب واقعی (مانند Nginx یا Apache) اجرا شود. با این حال ، توصیه می شود که یک سرور وب استاندارد را در مقابل Wiki.js. قرار دهید. این تضمین می کند که شما می توانید از ویژگی هایی مانند SSL ، وب سایت های مختلف ، ذخیره و سایر موارد استفاده کنید. ما در این آموزش از Nginx استفاده خواهیم کرد ، اما هر سرور دیگری انجام خواهد داد ، شما فقط باید آن را به درستی پیکربندی کنید.

Nginx را نصب کنید.

sudo dnf install -y nginx

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

nginx -v
# nginx version: nginx/1.12.1

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. 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 ~

acme.shنسخه را بررسی کنید .

/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 

بعد از اجرای دستورات فوق ، گواهینامه ها و کلیدهای شما در این قسمت قرار می گیرند:

• برای RSA: /etc/letsencrypt/wiki.example.com
• برای ECC / ECDSA: /etc/letsencrypt/wiki.example.com_ecc

توجه : فراموش نکنید wiki.example.comکه نام دامنه خود را جایگزین کنید.

بعد از اخذ گواهینامه های 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/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;
    }

}

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

sudo nginx -t

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

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

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