linux下搭建dokuwiki

基础概念

DokuWiki 是一个开源的、基于 Web 的 Wiki 引擎，它使用 PHP 编写，并且依赖于 SQLite、MySQL 或 PostgreSQL 数据库。DokuWiki 以其简单易用、高度可定制性和轻量级著称，非常适合小型到中型的 Wiki 项目。

相关优势

1. 轻量级：DokuWiki 不需要复杂的安装过程，只需几个简单的步骤即可搭建。
2. 易于定制：通过插件和模板，可以轻松地定制 DokuWiki 的外观和功能。
3. 安全性：DokuWiki 提供了基本的安全措施，如防止跨站脚本攻击（XSS）和 SQL 注入。
4. 多语言支持：DokuWiki 支持多种语言，可以轻松切换到不同的语言版本。
5. 版本控制：DokuWiki 自带版本控制系统，可以追踪和恢复页面的历史版本。

类型

DokuWiki 主要有以下几种类型：

1. 标准版：适用于大多数基本的 Wiki 需求。
2. 企业版：提供更多的高级功能和安全性增强特性。
3. 插件版：通过安装各种插件来扩展 DokuWiki 的功能。

应用场景

DokuWiki 适用于以下场景：

• 内部文档：企业或组织内部的文档管理系统。
• 项目协作：团队项目的知识库和协作平台。
• 个人知识管理：个人的笔记和知识整理系统。

搭建步骤

以下是在 Linux 下搭建 DokuWiki 的基本步骤：

1. 安装必要的软件

首先，确保你的 Linux 系统上已经安装了 Apache、PHP 和数据库（如 SQLite 或 MySQL）。以下是使用 Ubuntu 的示例命令：

sudo apt update
sudo apt install apache2 php libapache2-mod-php php-sqlite3

2. 下载并解压 DokuWiki

你可以从 DokuWiki 的官方网站下载最新版本的 DokuWiki：

wget https://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz
tar -xzf dokuwiki-stable.tgz -C /var/www/html/

3. 配置 Apache

创建一个新的 Apache 虚拟主机配置文件：

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

添加以下内容：

<VirtualHost *:80>
    ServerAdmin webmaster@localhost
    DocumentRoot /var/www/html/dokuwiki

    <Directory /var/www/html/dokuwiki>
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>

    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>

启用该虚拟主机并重启 Apache：

sudo a2ensite dokuwiki.conf
sudo systemctl restart apache2

4. 配置 DokuWiki

进入 DokuWiki 目录并复制 config/config.example.php 到 config/config.php：

cd /var/www/html/dokuwiki
sudo cp config/config.example.php config/config.php

编辑 config/config.php 文件，设置数据库连接信息：

$dbtype = 'sqlite3';
$dbserver = '';
$dbname = '/var/www/html/dokuwiki/data/database.sqlite3';
$dbuser = '';
$dbpass = '';
$dbprefix = 'doku_';

5. 初始化数据库

运行 DokuWiki 的安装脚本：

sudo -u www-data php install.php

按照提示完成安装过程。

常见问题及解决方法

问题：无法访问 DokuWiki 页面

原因：可能是 Apache 配置不正确或防火墙阻止了访问。

解决方法：

1. 检查 Apache 配置文件是否正确。
2. 确保防火墙允许 HTTP 流量：

sudo ufw allow 'Apache Full'

问题：数据库连接失败

原因：可能是数据库配置不正确或数据库服务未启动。

解决方法：

1. 检查 config/config.php 中的数据库配置信息。
2. 确保数据库服务已启动：

sudo systemctl start sqlite3

参考链接

• DokuWiki 官方网站
• Apache 官方文档
• PHP 官方文档

通过以上步骤，你应该能够在 Linux 系统上成功搭建 DokuWiki。如果遇到其他问题，可以参考官方文档或社区论坛寻求帮助。