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

[theanh]

DokuWiki là một phần mềm wiki đơn giản, dễ sử dụng và cực kỳ linh hoạt được viết bằng PHP. Phần mềm này miễn phí, mã nguồn mở và sử dụng định dạng tệp đơn giản để lưu trữ dữ liệu thay vì sử dụng bất kỳ hệ thống cơ sở dữ liệu nào. Phần mềm này cung cấp nhiều tính năng giúp bạn dễ dàng mở rộng và tối ưu hóa trang wiki của mình. Phần mềm này đang ngày càng phổ biến do cú pháp rõ ràng và dễ đọc. Sử dụng Dokuwiki, bạn có thể tạo trang web cá nhân hoặc doanh nghiệp của mình thông qua bảng điều khiển web Dokuwiki.

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

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

• Một máy chủ chạy Ubuntu 22.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ài đặt Apache và PHP​

Trước tiên, bạn sẽ cần cài đặt máy chủ web Apache, PHP và các thư viện PHP khác trên 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 cài đặt tất cả các gói, hãy khởi động dịch vụ Apache và cho phép nó khởi động cùng lúc với lệnh sau lệnh:

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.

Cài đặt DokuWiki Ubuntu 22.04​

Tiếp theo, hãy truy cập trang tải xuống chính thức của DokuWiki, sao chép URL tải xuống và tải xuống phiên bản mới nhất của DokuWiki với các mục sau lệnh:

wget https://download.dokuwiki.org/out/dokuwiki-24117f7f9e0362c4b1782ff29220b0ab.tgz

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

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

Tiếp theo, sao chép tệp .htaccess mẫu với nội dung sau lệnh:

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

Tiếp theo, thay đổi quyền sở hữu 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.

Tạo Apache Virtualhost cho DokuWiki​

Tiếp theo, bạn sẽ cần tạo một Tệp cấu hình máy chủ ảo Apache để phục vụ trang web DokuWiki. Bạn có thể tạo tệp này bằng lệnh sau

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

Thêm các dòng sau:

 ServerName doku.example.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 đó, hãy bật tệp cấu hình máy chủ ảo DokuWiki và tải lại dịch vụ Apache bằng lệnh sau:

a2ensite dokuwiki.conf
systemctl reload apache2

Bây giờ bạn có thể kiểm tra trạng thái Apache bằng lệnh sau:

systemctl status apache2

Bạn sẽ thấy thông báo sau đầu ra:

? apache2.service - The Apache HTTP Server Loaded: loaded (/lib/systemd/system/apache2.service; enabled; vendor preset: enabled) Active: active (running) since Sat 2022-06-25 15:44:31 UTC; 4min 30s ago Docs: https://httpd.apache.org/docs/2.4/ Process: 52450 ExecReload=/usr/sbin/apachectl graceful (code=exited, status=0/SUCCESS) Main PID: 52131 (apache2) Tasks: 6 (limit: 4579) Memory: 16.9M CPU: 331ms CGroup: /system.slice/apache2.service ??52131 /usr/sbin/apache2 -k start ??52454 /usr/sbin/apache2 -k start ??52455 /usr/sbin/apache2 -k start ??52456 /usr/sbin/apache2 -k start ??52457 /usr/sbin/apache2 -k start ??52458 /usr/sbin/apache2 -k start
Jun 25 15:44:30 ubuntu2204 systemd[1]: Starting The Apache HTTP Server...

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ật SSL trên Trang web DokuWiki​

Để bật SSL trên DokuWiki, bạn sẽ cần cài đặt máy khách Certbot trong hệ thống của mình. Certbot là công cụ Let's Encrypt được sử dụng để tải xuống và quản lý SSL.

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

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

Sau khi cài đặt, 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:

Saving debug log to /var/log/letsencrypt/letsencrypt.log
Plugins selected: Authenticator apache, Installer apache
Enter email address (used for urgent renewal and security notices) (Enter 'c' to
cancel): [emailprotected]
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Please read the Terms of Service at
https://letsencrypt.org/documents/LE-SA-v1.2-November-15-2017.pdf. You must
agree in order to register with the ACME server at
https://acme-v02.api.letsencrypt.org/directory
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
(A)gree/(C)ancel: A
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Would you be willing to share your email address with the Electronic Frontier
Foundation, a founding partner of the Let's Encrypt project and the non-profit
organization that develops Certbot? We'd like to send you email about our work
encrypting the web, EFF news, campaigns, and ways to support digital freedom.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
(Y)es/(N)o: Y
Obtaining a new certificate
Performing the following challenges:
http-01 challenge for dokuwiki.linuxbuz.com
Enabled Apache rewrite module
Waiting for verification...
Cleaning up challenges
Created an SSL vhost at /etc/apache2/sites-available/dokuwiki-le-ssl.conf
Enabled Apache socache_shmcb module
Enabled Apache ssl module
Deploying Certificate to VirtualHost /etc/apache2/sites-available/dokuwiki-le-ssl.conf
Enabling available site: /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 như hiển thị bên dưới:

Please choose whether or not to redirect HTTP traffic to HTTPS, removing HTTP access.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
1: No redirect - Make no further changes to the webserver configuration.
2: Redirect - Make all requests redirect to secure HTTPS access. Choose this for
new sites, or if you're confident your site works on HTTPS. You can undo this
change by editing your web server's configuration.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Select the appropriate number [1-2] then [enter] (press 'c' to cancel): 2

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

Enabled Apache rewrite module
Redirecting vhost in /etc/apache2/sites-enabled/dokuwiki.conf to ssl vhost in /etc/apache2/sites-available/dokuwiki-le-ssl.conf
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Congratulations! You have successfully enabled https://dokuwiki.linuxbuz.com
You should test your configuration at:
https://www.ssllabs.com/ssltest/analyze.html?d=dokuwiki.linuxbuz.com
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
IMPORTANT NOTES: - Congratulations! Your certificate and chain have been saved at: /etc/letsencrypt/live/dokuwiki.linuxbuz.com/fullchain.pem Your key file has been saved at: /etc/letsencrypt/live/dokuwiki.linuxbuz.com/privkey.pem Your cert will expire on 2020-09-05. To obtain a new or tweaked version of this certificate in the future, simply run certbot again with the "certonly" option. To non-interactively renew *all* of your certificates, run "certbot renew" - If you like Certbot, please consider supporting our work by: Donating to ISRG / Let's Encrypt: https://letsencrypt.org/donate Donating to EFF: https://eff.org/donate-le

Lúc này, trang Dokuwiki của bạn được bảo mật bằng Let's Encrypt SSL.

Truy cập DokuWiki​

Bây giờ, hãy mở trình duyệt web của bạn và nhập URL

Đang tải…

dokuwiki.linuxbuz.com

. 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, mật khẩu quản trị viên của bạn và nhấp vào nút Đăng nhập. Bạn sẽ thấy bảng điều khiển DokuWiki trên màn hình sau:

Thiết lập Tự động gia hạn​

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. Bạn 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 tác vụ cron để tự động gia hạn chứng chỉ SSL vào lúc 6:00 sáng hàng ngày bằng cách chỉnh sửa tệp sau:

crontab -e

Thêm nội dung sau dòng:

00 06 * * * 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 22.04. Bây giờ bạn có thể tạo trang wiki của riêng mình bằng DokuWiki. Hãy thoải mái hỏi tôi nếu bạn có bất kỳ câu hỏi nào.