Cách cài đặt DokuWiki trên Ubuntu 20.04 LTS

[theanh]

DokuWiki là một ứng dụng wiki miễn phí, mã nguồn mở và linh hoạt nhất được viết bằng PHP. Ứng dụng này đơn giản và nhẹ, sử dụng định dạng tệp đơn giản để lưu trữ dữ liệu, do đó không yêu cầu bất kỳ cơ sở dữ liệu nào. Ứng dụng này được biết đến với cú pháp rõ ràng và dễ đọc, cho phép bạn dễ dàng mở rộng và tối ưu hóa bằng nhiều tính năng nâng cao. Bạn có thể tạo trang web cá nhân hoặc doanh nghiệp của mình chỉ bằng cách tải nội dung của trang web lên máy chủ. Nó đi kèm với một bộ tính năng phong phú bao gồm hỗ trợ WYSIWYG, thân thiện với SEO, kiểm soát truy cập tích hợp và trình kết nối xác thực, khung CSS linh hoạt và nhiều tính năng khác.

Trong hướng dẫn này, chúng tôi sẽ chỉ cho bạn cách cài đặt DokuWiki với chứng chỉ SSL của Apache và Letsencrypt trên Ubuntu 20.04.

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

• Một máy chủ chạy Ubuntu 20.04.
• Một tên miền hợp lệ được trỏ đến máy chủ của bạn.
• Một mật khẩu gốc được cấu hình trên máy chủ của bạn.

Cập nhật các gói hệ thống​

Trước khi bắt đầu, bạn nên cập nhật các gói hệ thống của mình lên phiên bản mới nhất. Bạn có thể thực hiện bằng lệnh sau:

apt-get update -y
apt-get upgrade -y

Sau khi hệ thống của bạn được cập nhật, hãy khởi động lại để triển khai các thay đổi.

Cài đặt Apache và PHP​

DokuWiki được viết bằng PHP và chạy trên máy chủ web. Vì vậy, bạn sẽ cần cài đặt máy chủ web Apache, PHP và các thư viện PHP khác vào hệ thống của mình. Bạn có thể cài đặt tất cả chúng bằng cách chạy lệnh sau:

apt-get install apache2 php php-gd php-xml php-json -y

Sau khi tất cả các gói được cài đặt, hãy khởi động dịch vụ Apache và cho phép nó khởi động khi khởi động bằng lệnh sau:

systemctl start apache2
systemctl enable apache2

Sau khi hoàn tất, bạn có thể tiến hành bước tiếp theo.

Tải xuống DokuWiki​

Trước tiên, hãy truy cập trang tải xuống chính thức của DokuWiki và tải xuống phiên bản DokuWiki mới nhất bằng lệnh sau:

wget https://download.dokuwiki.org/src/dokuwiki/dokuwiki-rc.tgz

Sau khi tải xuống hoàn tất, hãy tạo một thư mục DokuWiki bên trong thư mục gốc web của Apache và giải nén DokuWiki:

mkdir /var/www/html/dokuwiki
tar -xvzf dokuwiki-rc.tgz -C /var/www/html/dokuwiki/ --strip-components=1

Tiếp theo, sao chép tệp .htaccess mẫu bằng lệnh sau:

cp /var/www/html/dokuwiki/.htaccess{.dist,}

Tiếp theo, thay đổi quyền sở hữu của dokuwiki thành www-data:

chown -R www-data:www-data /var/www/html/dokuwiki

Sau khi hoàn tất, bạn có thể tiến hành bước tiếp theo.

Cấu hình Apache cho DokuWiki​

Tiếp theo, tạo tệp cấu hình máy chủ ảo Apache để phục vụ trang web DokuWiki:

nano /etc/apache2/sites-available/dokuwiki.conf

Thêm các dòng sau:

 ServerName dokuwiki.linuxbuz.com DocumentRoot /var/www/html/dokuwiki   AllowOverride All Require all denied   Order allow,deny Deny from all   ErrorLog /var/log/apache2/dokuwiki_error.log CustomLog /var/log/apache2/dokuwiki_access.log combined

Lưu và đóng tệp khi bạn hoàn tất. Sau đó, bật trang DokuWiki và tải lại dịch vụ Apache bằng lệnh sau:

a2ensite dokuwiki.conf
systemctl reload apache2

Tại thời điểm này, máy chủ web Apache được cấu hình để phục vụ trang DokuWiki. Bây giờ bạn có thể tiến hành cài đặt Let's Encrypt SSL trên trang web của mình.

Bảo mật DokuWiki bằng Let's Encrypt SSL​

Trước tiên, bạn sẽ cần cài đặt ứng dụng khách Certbot trong hệ thống của mình. Certbot là một máy khách dễ sử dụng, có chức năng lấy chứng chỉ từ Let's Encrypt, một cơ quan cấp chứng chỉ mở do EFF, Mozilla và các tổ chức khác khởi chạy—và triển khai chứng chỉ đó lên máy chủ web. Sử dụng máy khách Certbot Let's Encrypt, bạn có thể dễ dàng tải xuống, cài đặt và gia hạn chứng chỉ SSL cho tên miền của mình.

Bạn có thể cài đặt Certbot bằng lệnh sau:

apt-get install certbot python3-certbot-apache -y

Sau khi máy khách Certbot đã được cài đặt thành công, hãy chạy lệnh sau để cài đặt Let's Encrypt SSL cho trang web của bạn:

certbot --apache -d dokuwiki.linuxbuz.com

Bạn sẽ được yêu cầu cung cấp email hợp lệ và chấp nhận điều khoản dịch vụ như hiển thị bên dưới:

Lưu nhật ký gỡ lỗi vào /var/log/letsencrypt/letsencrypt.logCác plugin đã chọn: Authenticator apache, Installer apacheNhập địa chỉ email (dùng để gia hạn khẩn cấp và thông báo bảo mật) (Nhập 'c' đểhủy): [emailprotected]- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -Vui lòng đọc Điều khoản dịch vụ tạihttps://letsencrypt.org/documents/LE-SA-v1.2-November-15-2017.pdf. Bạn phảiđồng ý để đăng ký với máy chủ ACME tạihttps://acme-v02.api.letsencrypt.org/directory- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -(A)gree/(C)ancel: A- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -Bạn có sẵn lòng chia sẻ địa chỉ email của mình với Electronic Frontier Foundation, đối tác sáng lập của dự án Let's Encrypt và tổ chức phi lợi nhuận phát triển Certbot không? Chúng tôi muốn gửi cho bạn email về công việc của chúng tôimã hóa web, tin tức EFF, các chiến dịch và các cách hỗ trợ tự do kỹ thuật số.- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -(C)ó/(K)ó: CNhận chứng chỉ mớiThực hiện các thử thách sau:Thử thách http-01 cho dokuwiki.linuxbuz.comĐã bật mô-đun ghi đè ApacheĐang chờ xác minh...Dọn dẹp các thử tháchĐã tạo một vhost SSL tại /etc/apache2/sites-available/dokuwiki-le-ssl.confĐã bật mô-đun Apache socache_shmcbĐã bật mô-đun Apache sslTriển khai chứng chỉ tới VirtualHost /etc/apache2/sites-available/dokuwiki-le-ssl.confĐã bật trang web khả dụng: /etc/apache2/sites-available/dokuwiki-le-ssl.conf

Tiếp theo, hãy chọn có chuyển hướng lưu lượng HTTP sang HTTPS hay không hoặc cấu hình Nginx để chuyển hướng tất cả lưu lượng tới trang web an toàn Truy cập HTTPS như được hiển thị trong đầu ra sau:

Vui lòng chọn có chuyển hướng lưu lượng HTTP sang HTTPS hay không, xóa quyền truy cập HTTP.- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -1: Không chuyển hướng - Không thực hiện thêm bất kỳ thay đổi nào đối với cấu hình máy chủ web.2: Chuyển hướng - Chuyển hướng tất cả các yêu cầu đến quyền truy cập HTTPS an toàn. Chọn tùy chọn này chocác trang web mới hoặc nếu bạn tin tưởng rằng trang web của mình hoạt động trên HTTPS. Bạn có thể hoàn tácthay đổi này bằng cách chỉnh sửa cấu hình máy chủ web của mình.- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -Chọn số thích hợp [1-2] rồi [enter] (nhấn 'c' để hủy): 2

Nhập 2 và nhấn Enter để bắt đầu quy trình. Sau khi cài đặt hoàn tất, bạn sẽ nhận được kết quả sau:

Enabled Apache rewrite moduleRedirecting vhost in /etc/apache2/sites-enabled/dokuwiki.conf to ssl vhost in /etc/apache2/sites-available/dokuwiki-le-ssl.conf- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -Xin chúc mừng! Bạn đã bật thành công https://dokuwiki.linuxbuz.comBạn nên kiểm tra cấu hình của mình tại:https://www.ssllabs.com/ssltest/analyze.html?d=dokuwiki.linuxbuz.com- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -LƯU Ý QUAN TRỌNG: - Xin chúc mừng! Chứng chỉ và chuỗi của bạn đã được lưu tại: /etc/letsencrypt/live/dokuwiki.linuxbuz.com/fullchain.pem Tệp khóa của bạn đã được lưu tại: /etc/letsencrypt/live/dokuwiki.linuxbuz.com/privkey.pem Chứng chỉ của bạn sẽ hết hạn vào ngày 05-09-2020. Để có phiên bản mới hoặc đã chỉnh sửa của chứng chỉ này trong tương lai, chỉ cần chạy lại certbot với tùy chọn "certonly". Để gia hạn không tương tác *tất cả* chứng chỉ của bạn, hãy chạy "certbot renew" - Nếu bạn thích Certbot, vui lòng cân nhắc hỗ trợ công việc của chúng tôi bằng cách: Quyên góp cho ISRG / Let's Encrypt: https://letsencrypt.org/donate Quyên góp cho EFF: https://eff.org/donate-le

Tại thời điểm này, trang Dokuwiki của bạn được bảo mật bằng Let's Encrypt SSL. Bây giờ bạn có thể truy cập trang web của mình một cách an toàn bằng giao thức HTTPS.

Truy cập DokuWiki​

Bây giờ, hãy mở trình duyệt web của bạn và nhập URL https://dokuwiki.linuxbuz.com/install.php. Bạn sẽ thấy màn hình cài đặt DokuWiki:





Cung cấp tên wiki, tên người dùng quản trị, mật khẩu, email, chọn chính sách của bạn và nhấp vào nút Lưu. Bạn sẽ được chuyển hướng đến trang sau:



Nhấp vào "DokuWiki mới của bạn". Bạn sẽ thấy màn hình sau:



Nhấp vào nút Đăng nhập. Bạn sẽ được chuyển hướng đến màn hình đăng nhập DokuWiki như hiển thị bên dưới:



Cung cấp tên người dùng quản trị, mật khẩu và nhấp vào nút Đăng nhập vào. Bạn sẽ thấy bảng điều khiển DokuWiki trong màn hình sau:

Thiết lập tính năng tự động gia hạn chứng chỉ SSL Let's Encrypt​

Theo mặc định, chứng chỉ Let's Encrypt có hiệu lực trong 90 ngày. Vì vậy, bạn sẽ cần thiết lập một công việc cron để tự động gia hạn chứng chỉ SSL. Có thể tạo một công việc cron chạy hàng tuần hoặc thậm chí hàng ngày.

Nếu bạn muốn gia hạn chứng chỉ SSL theo cách thủ công, hãy chạy lệnh sau:

certbot renew --dry-run

Bạn có thể thiết lập cron job để tự động gia hạn chứng chỉ SSL mỗi ngày lúc 10:00 sáng bằng cách chỉnh sửa tệp sau:

crontab -e

Thêm dòng sau:

00 10 * * * root /usr/bin/certbot renew >/dev/null 2>&1

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

Kết luận​

Xin chúc mừng! Bạn đã cài đặt DokuWiki thành công và bảo mật nó bằng Let's Encrypt SSL trên Ubuntu 20.04. Bạn cũng có thể mở rộng DokuWiki của mình bằng chủ đề, plugin và mẫu. Hãy thoải mái hỏi tôi nếu bạn có bất kỳ câu hỏi nào.