چگونگی نصب Wiki.js بر روی لینوکس

Wiki.js یک سیستم مدیریت دانش متن‌باز است که با Node.js اجرا می‌شود و برای ساخت ویکی داخلی، مستندات پروژه و پایگاه دانش استفاده می‌شود. این ابزار بیشتر برای تیم‌هایی مناسب است که می‌خواهند یک سیستم مستندات سبک، سریع و قابل توسعه داشته باشند.

در ادامه مراحل نصب را به‌صورت عملی بررسی می‌کنیم.

به‌روزرسانی سیستم برای نصب Wiki.js

قبل از شروع، سیستم را آپدیت می‌کنیم تا همه پکیج‌ها به نسخه پایدار برسند.

sudo apt update
sudo apt upgrade -y

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

sudo apt install curl wget git -y

نصب Node.js

Wiki.js برای اجرا به Node.js نیاز دارد. در این آموزش از نسخه 20 LTS استفاده می‌کنیم.

اضافه کردن ریپازیتوری:

curl -fsSL <a href="https://deb.nodesource.com/setup_20.x">https://deb.nodesource.com/setup_20.x</a> | sudo -E bash -

نصب Node.js:

sudo apt install nodejs -y

بررسی نصب:

node -v
npm -v

نصب PostgreSQL

برای ذخیره داده‌ها از PostgreSQL استفاده می‌شود.

sudo apt install postgresql postgresql-contrib -y

فعال‌سازی سرویس:

sudo systemctl enable postgresql
sudo systemctl start postgresql

ساخت دیتابیس و کاربران پس از نصب Wiki.js

وارد محیط دیتابیس می‌شویم:

sudo -u postgres psql

ساخت دیتابیس:

CREATE DATABASE wikijs;

ساخت کاربر:

CREATE USER wikiuser WITH PASSWORD 'StrongPassword123';

در اینجا:

• wikiuser نام کاربر دیتابیس است
• رمز عبور باید با یک رمز قوی جایگزین شود

دادن دسترسی:

GRANT ALL PRIVILEGES ON DATABASE wikijs TO wikiuser;

خروج:

\q

دانلود Wiki.js

ساخت مسیر نصب:

sudo mkdir -p /var/www/wikijs
cd /var/www/wikijs

دانلود فایل:

sudo wget https://github.com/Requarks/wiki/releases/latest/download/wiki-js.tar.gz

استخراج فایل:

sudo tar -xzf wiki-js.tar.gz

تنظیمات Wiki.js

فایل تنظیمات را ایجاد می‌کنیم:

sudo cp config.sample.yml config.yml

ویرایش فایل:

sudo nano config.yml

تنظیم دیتابیس:

db:
type: postgres
host: localhost
port: 5432
user: wikiuser
pass: StrongPassword123
db: wikijs

اجرای Wiki.js

برای تست اجرا:

node server

بعد از اجرا:

http://SERVER_IP:3000

SERVER_IP باید با آی‌پی سرور جایگزین شود.

اجرای دائمی با PM2

نصب PM2:

sudo npm install -g pm2

اجرای سرویس:

pm2 start server --name wikijs

ذخیره وضعیت:

pm2 save

اجرای خودکار بعد از ریبوت:

pm2 startup

بررسی نصب و اجرای صحیح سرویس

بعد از اینکه Wiki.js اجرا شد، مهم‌ترین کار این است که مطمئن شویم سرویس بدون مشکل بالا آمده و ارتباط آن با دیتابیس برقرار است. در این مرحله معمولاً بررسی می‌شود که صفحه اولیه سایت در مرورگر باز می‌شود و خطایی در اتصال به PostgreSQL یا اجرای Node.js وجود ندارد. اگر صفحه لود نشود یا خطای اتصال نمایش داده شود، در اکثر مواقع مشکل از تنظیمات دیتابیس، دسترسی‌ها یا اجرای نادرست Node.js است، نه خود Wiki.js.

راه‌اندازی نهایی Wiki.js روی سرور

وقتی سرویس بدون خطا اجرا شد، Wiki.js عملاً آماده استفاده است و می‌توان از طریق مرورگر وارد پنل مدیریتی آن شد. از این مرحله به بعد، تمام کارها مثل ساخت صفحات، مدیریت محتوا، تنظیم دسترسی‌ها و دسته‌بندی اطلاعات از داخل داشبورد انجام می‌شود و دیگر نیازی به تغییر مستقیم در سطح سرور نیست. در واقع اینجا بخش اصلی کار از محیط سرور به رابط کاربری منتقل می‌شود.

نتیجه‌گیری

نصب Wiki.js روی لینوکس در اصل به سه بخش اصلی وابسته است: اجرای برنامه با Node.js، ذخیره‌سازی داده‌ها در PostgreSQL و مدیریت سرویس با ابزارهایی مثل PM2. اگر این سه بخش به‌درستی تنظیم شوند، Wiki.js بدون مشکل اجرا می‌شود و می‌تواند به‌عنوان یک سیستم مستندات پایدار و قابل اعتماد برای پروژه‌ها مورد استفاده قرار بگیرد.