Cách cài đặt Wiki.js với Apache2 Reverse Proxy trên Ubuntu 22.04

[theanh]

Wiki.js là phần mềm wiki miễn phí và mã nguồn mở dựa trên Node.js, Git và Markdown. Phần mềm này được phát hành theo Giấy phép AGPL-v3 và được thiết kế để tiết kiệm tài nguyên hệ thống và hiệu suất. Wiki.js là phần mềm Wiki mạnh mẽ có thể cài đặt ở bất kỳ đâu trên hệ thống của bạn; bạn có thể cài đặt phần mềm này trên hệ điều hành hoặc sử dụng các dịch vụ đám mây như Heroku và cũng có thể triển khai Wiki.js trên các môi trường chứa như Docker và Kubernetes.

Wiki.js tương thích với cơ sở dữ liệu PostgreSQL và cung cấp hơn 50 tích hợp cho các hệ thống xác thực, ghi nhật ký, công cụ tìm kiếm, kết xuất và lưu trữ bổ sung. Đây là phần mềm Wiki mạnh mẽ được xây dựng trên các giao diện đẹp và trực quan cho bảng điều khiển và các trang quản trị. Đây là phần mềm wiki hoàn toàn có thể tùy chỉnh để ghi lại tài liệu về ngăn xếp công nghệ của bạn.

Trong hướng dẫn này, bạn sẽ cài đặt và định cấu hình Wiki.js trên máy chủ Ubuntu 22.04, sử dụng PostgreSQL làm cơ sở dữ liệu mặc định và Apache2 làm proxy ngược. Ngoài ra, bạn sẽ có kết nối HTTPS/SSL an toàn khi cài đặt Wiki.js. Khi hoàn tất, bạn sẽ có một Wiki.js hoạt động đầy đủ và an toàn trên hệ thống Ubuntu của mình.

Điều kiện tiên quyết​

Để hoàn thành hướng dẫn này, trước tiên bạn cần có các yêu cầu sau:

• Máy chủ Ubuntu 22.04.
• Người dùng không phải root có quyền root/quản trị viên.
• Tên miền trỏ đến địa chỉ IP máy chủ Ubuntu của bạn.

Cài đặt Node.js​

Trước khi cài đặt Wiki.js, bạn phải cài đặt các phần phụ thuộc mà Wiki.js yêu cầu.

Wiki.js là phần mềm wiki chủ yếu được viết bằng JavaScript để bạn cài đặt JavaScript runtime Node.js trong bước đầu tiên này. Kho lưu trữ mặc định của Ubuntu cung cấp gói Node.js, nhưng đối với hướng dẫn này, bạn sẽ sử dụng kho lưu trữ Nodesource để cài đặt Node.js.

Chạy lệnh curl bên dưới để thêm kho lưu trữ Nodesource vào hệ thống Ubuntu của bạn. Tại thời điểm viết bài này, Wiki.js yêu cầu ít nhất Node.js v8 trở lên. Và đối với hướng dẫn này, bạn sẽ cài đặt phiên bản LTS của Node.js v16.

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -

data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22237%22%3E%3C/svg%3E


Bây giờ bạn có thể cài đặt gói Node.js bằng lệnh apt bên dưới.

sudo apt install nodejs

data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22177%22%3E%3C/svg%3E


Sau khi cài đặt hoàn tất, hãy kiểm tra và xác minh phiên bản Node.js bằng lệnh sau. Bạn sẽ thấy phiên bản Node.js v16 LTS trên màn hình thiết bị đầu cuối của mình.

node --version
npm --version

data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22603%22%20height=%22154%22%3E%3C/svg%3E

Cài đặt cơ sở dữ liệu PostgreSQL​

WIki.js mặc định hỗ trợ nhiều RDBMS như PostgreSQL, MySQL/MariaDB và SQLite (mặc định), nhưng cơ sở dữ liệu được khuyến nghị cho sản xuất là PostgreSQL. Bạn sẽ cài đặt gói PostgreSQL trên hệ thống Ubuntu, sau đó tạo cơ sở dữ liệu và người dùng cho Wiki.js.

Để bắt đầu, hãy chạy lệnh apt sau để cài đặt cơ sở dữ liệu PostgreSQL trên máy chủ của bạn. Nhập Y để xác nhận cài đặt và nhấn ENTER để tiếp tục, quá trình cài đặt sẽ bắt đầu.

sudo apt install postgresql postgresql-common

data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22308%22%3E%3C/svg%3E


Khi quá trình cài đặt hoàn tất, hãy chạy lệnh systemctl sau để kiểm tra và xác minh dịch vụ PostgreSQL. Và bạn sẽ thấy dịch vụ PostgreSQL được bật, nghĩa là nó sẽ tự động khởi động khi hệ thống khởi động. Và trạng thái hiện tại của dịch vụ PostgreSQL là "Đang hoạt động".

sudo systemctl is-enabled postgresql
sudo systemctl status postgresql

Đăng nhập vào bảng điều khiển PostgreSQL bằng lệnh bên dưới để tạo cơ sở dữ liệu và người dùng PostgreSQL.

sudo -u postgres psql

Chạy lệnh sau từ bảng điều khiển PostgreSQL của bạn để tạo cơ sở dữ liệu và người dùng mới cho Wiki.js. Trong ví dụ này, chúng tôi đang tạo cơ sở dữ liệu "wikijs" và người dùng "wiki" với mật khẩu "wikijspassword".

CREATE DATABASE wikijs;
CREATE USER wiki WITH ENCRYPTED PASSWORD 'wikijspassword';
GRANT ALL PRIVILEGES ON DATABASE wikijs TO wiki;

Bây giờ bạn có thể sử dụng "Ctrl+d" để thoát khỏi bảng điều khiển PostgreSQL hoặc chỉ cần sử dụng lệnh "\q" để thoát.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22302%22%3E%3C/svg%3E

Cài đặt Wiki.js​

Bây giờ bạn sẽ cài đặt Wiki.js theo cách thủ công vào hệ thống Ubuntu của mình. Thông qua hướng dẫn này, bạn sẽ tạo một người dùng hệ thống cho Wiki.js, tải xuống mã nguồn Wiki.js, thiết lập Wiki.js với cơ sở dữ liệu PostgreSQL và cuối cùng, bạn sẽ chạy Wiki.js dưới dạng dịch vụ systemd.

Trước tiên, hãy chạy lệnh sau để tạo một người dùng mới cho Wiki.js. Trong ví dụ này, chúng tôi đang tạo một người dùng hệ thống mới có tên là "wiki" với thư mục home mặc định là "/opt/wikijs" và vì đây là người dùng hệ thống, chúng tôi đang vô hiệu hóa quyền truy cập shell.

sudo useradd -r -d /opt/wikijs -s /usr/sbin/nologin wiki

Bây giờ hãy tải xuống mã nguồn Wiki.js bằng lệnh wget bên dưới.

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

Khi quá trình tải xuống hoàn tất, hãy tạo một thư mục mới "/opt/wikijs" và giải nén mã nguồn Wiki.js vào đó. Bạn sẽ thấy mã nguồn Wiki.js có sẵn trong thư mục cài đặt "/opt/wikijs".

mkdir -p /opt/wikijs
tar xzf wiki-js.tar.gz -C /opt/wikijs

Để thiết lập Wiki.js với cơ sở dữ liệu PostgreSQL, bạn sẽ sao chép cấu hình mẫu mặc định "config.sample.yml" và sửa đổi/chỉnh sửa nó bằng trình soạn thảo văn bản của bạn.

Chạy lệnh sau để sao chép tệp cấu hình Wiki.js mẫu vào "/opt/wikijs/config.yml". Sau đó, chỉnh sửa tệp mới "/opt/wikijs/config.yml" bằng trình chỉnh sửa nano.

cp /opt/wikijs/config.sample.yml /opt/wikijs/config.yml
nano /opt/wikijs/config.yml

Thay đổi cấu hình mặc định như bên dưới.

Trong ví dụ này, chúng tôi sẽ chạy Wiki.js trên cổng TCP mặc định "3000". Đảm bảo thay đổi tên cơ sở dữ liệu PostgreSQL, người dùng và mật khẩu. Trên tùy chọn "bindIP", hãy đổi thành localhost hoặc "127.0.0.1". Đối với cấu hình nhật ký Wiki.js, chúng tôi sẽ sử dụng mức mặc định "info" với định dạng "json".

# default port wikijs will run
port: 3000

# PostgreSQL database details
db:
 type: postgres
 host: localhost
 port: 5432
 user: wiki
 pass: wikijspassword
 db: wikijs
 ssl: false

# bind wikijs to localhost only
bindIP: 127.0.0.1

# setup log and the format
loglevel: info
logFormat: json

Lưu và đóng tệp khi bạn hoàn tất.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22218%22%3E%3C/svg%3E


Bây giờ hãy chạy lệnh chown bên dưới để thay đổi quyền sở hữu thư mục cài đặt Wiki.js "/opt/wikijs" thành người dùng "wiki".

sudo chown -R wiki:wiki /opt/wikijs

Trong ví dụ này, chúng tôi sẽ chạy Wiki.js dưới dạng dịch vụ systemd. Vì vậy, bạn cần tạo một tệp dịch vụ systemd mới cho Wiki.js.

Chạy lệnh sau để tạo một tệp dịch vụ systemd mới "/etc/systemd/system/wikijs.service".

sudo nano /etc/systemd/system/wikijs.service

Thêm cấu hình sau vào tệp.

[Unit]
Description=Wiki.js
After=network.target postgresql.service

[Service]
Type=simple
ExecStart=/usr/bin/node server
Restart=always

User=wiki
Environment=NODE_ENV=production
WorkingDirectory=/opt/wikijs

[Install]
WantedBy=multi-user.target

Lưu và đóng tệp khi bạn hoàn tất.

Tiếp theo, chạy lệnh sau để tải lại trình quản lý hệ thống và áp dụng tệp dịch vụ mới "wikijs.service"

sudo systemctl daemon-reload

Bây giờ bạn có thể bắt đầu và kích hoạt dịch vụ "wikijs" bằng cách sử dụng lệnh sau.

sudo systemctl start wikijs
sudo systemctl enable wikijs

data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22142%22%3E%3C/svg%3E


Cuối cùng, hãy kiểm tra và xác minh dịch vụ "wikijs" bằng lệnh sau. Bây giờ bạn sẽ thấy dịch vụ "wikijs" đang chạy trên cổng TCP mặc định "3000" với PostgreSQL là cơ sở dữ liệu mặc định.

sudo systemctl status wikijs

data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22198%22%3E%3C/svg%3E

Thiết lập Apache2 làm Proxy ngược​

Trong ví dụ này, Wiki.js hiện đang chạy trên cổng TCP "3000". Để hiển thị với các mạng bên ngoài hoặc internet, tốt hơn là thiết lập proxy ngược trước Wiki.js và áp dụng HTTPS/SSL trên đó để bảo vệ mọi thông tin xác thực và thông tin đăng nhập. Bạn cũng sẽ sử dụng Apache2 làm proxy ngược cho Wiki.js.

Chạy lệnh apt bên dưới để cài đặt gói Apache2. Nhập Y để xác nhận cài đặt và nhấn ENTER để tiếp tục, quá trình cài đặt sẽ bắt đầu.

sudo apt install apache2

data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22275%22%3E%3C/svg%3E


Sau khi cài đặt hoàn tất, hãy chạy lệnh "ufw" bên dưới để mở cổng HTTP và HTTPS trên hệ thống Ubuntu của bạn. Sau đó, hãy xác minh danh sách các quy tắc UFW.

sudo ufw allow "Apache Full"
sudo ufw status

data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22627%22%20height=%22302%22%3E%3C/svg%3E


Tiếp theo, hãy kích hoạt một số mô-đun Apache2 bằng lệnh sau. Bạn sẽ sử dụng các mô-đun này để thiết lập proxy ngược Apache2.

sudo a2enmod proxy proxy_http ssl remoteip http2

data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22284%22%3E%3C/svg%3E


Bây giờ hãy tạo cấu hình máy chủ ảo Apache2 mới "/etc/apache2/sites-available/wikijs.conf" bằng cách sử dụng lệnh sau lệnh.

sudo nano /etc/apache2/sites-available/wikijs.conf

Thêm cấu hình sau vào tệp. Trong ví dụ này, chúng tôi sẽ sử dụng tên miền "wiki.howtoforge.local" để cài đặt Wiki.js và chứng chỉ SSL từ letsencrypt. Hãy chắc chắn thay đổi tên miền và đường dẫn của chứng chỉ SSL.

 ServerName wiki.howtoforge.local

 # Comment to prevent HTTP to HTTPS redirect
 Redirect permanent / https://wiki.howtoforge.local

 ErrorLog /var/log/apache2/wiki.howtoforge.local-error.log
 CustomLog /var/log/apache2/wiki.howtoforge.local-access.log combined




 ServerName wiki.howtoforge.local

 ProxyPreserveHost On

 ProxyPass "/" "http://127.0.0.1:3000/"
 ProxyPassReverse "/" "http://127.0.0.1:3000/"

 SSLEngine on
 SSLCertificateFile /etc/letsencrypt/live/wiki.howtoforge.local/fullchain.pem
 SSLCertificateKeyFile /etc/letsencrypt/live/wiki.howtoforge.local/privkey.pem
 Protocols h2 http/1.1

 # Enable only strong encryption ciphers and prefer versions with forwarding Secrecy
 SSLCipherSuite HIGH:RC4-SHA:AES128-SHA:!aNULL:!MD5
 SSLHonorCipherOrder on

 # Disable insecure SSL and TLS versions
 SSLProtocol all -SSLv2 -SSLv3 -TLSv1 -TLSv1.1

 ErrorLog /var/log/apache2/wiki.howtoforge.local-error.log
 CustomLog /var/log/apache2/wiki.howtoforge.local-access.log combined

Lưu và đóng tệp khi bạn hoàn tất.

Tiếp theo, kích hoạt tệp máy chủ ảo 'wikijs.conf" bằng lệnh sau.

sudo a2ensite wikijs.conf

Kiểm tra và xác minh cấu hình Aache2 bằng lệnh sau. nếu bạn nhận được thông báo đầu ra như "Cú pháp OK", có nghĩa là cấu hình Apache2 đã sẵn sàng. Sau đó, khởi động lại dịch vụ Apache2 để áp dụng các thay đổi mới.

sudo apachectl configtest
sudo systemctl restart apache2

data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22271%22%3E%3C/svg%3E

Cấu hình cài đặt Wiki.js​

Mở trình duyệt web và truy cập tên miền của cài đặt Wiki.js của bạn (ví dụ: https://wiki.howtoforge.local/).

Nhập email, mật khẩu và URL trang web của quản trị viên mới cho cài đặt Wiki.js của bạn. Sau đó, nhấp vào nút "CÀI ĐẶT" để bắt đầu cài đặt.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22743%22%3E%3C/svg%3E


Sau khi cài đặt hoàn tất, bạn sẽ thấy trang đăng nhập của Wiki.js. nhập email và mật khẩu của quản trị viên và nhấp vào "Đăng nhập".


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22310%22%3E%3C/svg%3E


Bây giờ bạn sẽ thấy thông báo chào mừng từ Wiki.js. Nhấp vào nút "TẠO TRANG CHỦ" để thiết lập trang chỉ mục mặc định cho Wiki.js của bạn.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22693%22%20height=%22440%22%3E%3C/svg%3E


Chọn trình soạn thảo bạn muốn sử dụng. Trong ví dụ này, chúng ta sẽ sử dụng trình soạn thảo Markdown.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22714%22%20height=%22633%22%3E%3C/svg%3E


Nhập tiêu đề, mô tả và các mục khác. Sau đó nhấp vào "OK".


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22508%22%3E%3C/svg%3E


Nhập thông tin chi tiết trang chỉ mục cho Wiki.js của bạn và nhấp vào "CREATE" để xác nhận.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22197%22%3E%3C/svg%3E


Và bạn sẽ thấy trang chủ mặc định của Wiki.js mà bạn vừa tạo.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22369%22%3E%3C/svg%3E


Để truy cập bảng điều khiển quản trị Wiki.js, hãy nhấp vào biểu tượng cài đặt bánh răng ở góc trên bên trái. Bạn sẽ thấy bảng điều khiển quản trị Wiki.js bên dưới.


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22478%22%3E%3C/svg%3E

Kết luận​

Trong hướng dẫn này, bạn đã thiết lập Wiki.js trên cơ sở dữ liệu PostgreSQL và proxy ngược Apache2, chạy trên máy chủ Ubuntu mới nhất 22.04. Bạn cũng đã bảo mật Wiki.js của mình bằng tường lửa UFW và SSL/HTTPS được bật trên proxy ngược Apache. Cuối cùng, bạn cũng đã cấu hình trang chủ hoặc chỉ mục mặc định cho cài đặt Wiki.js của mình.

Bạn có thể tạo thêm nội dung và thiết lập danh mục cho dự án Wiki của mình. Bạn cũng có thể thêm một số mô-đun vào Wiki.js để mở rộng chức năng của nó hoặc thiết lập chủ đề mới cho Wiki.js.