Linux下怎么安装和使用Dokuwiki

发布时间：2022-01-25 09:57:46 作者：iii
来源：亿速云阅读：234

# Linux下怎么安装和使用Dokuwiki

## 什么是Dokuwiki

Dokuwiki 是一个轻量级、开源、无需数据库的 Wiki 系统，使用纯文本文件存储数据。它非常适合个人知识管理、团队协作文档以及企业知识库建设。主要特点包括：

- 无需数据库（文件存储）
- 简洁高效的语法
- 完善的权限管理
- 丰富的插件生态
- 多语言支持
- 响应式设计

## 安装前的准备

### 系统要求

- Linux 操作系统（本文以 Ubuntu 20.04 为例）
- PHP 7.2 或更高版本
- Web 服务器（Apache/Nginx）
- 约 50MB 磁盘空间

### 安装必要组件

```bash
sudo apt update
sudo apt install -y apache2 php php-xml php-gd php-json php-mbstring

安装Dokuwiki

方法一：通过包管理器安装（推荐）

添加Dokuwiki官方仓库：

wget -qO - https://download.dokuwiki.org/apt/dokuwiki-release.gpg.key | sudo apt-key add -
echo "deb https://download.dokuwiki.org/apt/ubuntu/ focal main" | sudo tee /etc/apt/sources.list.d/dokuwiki.list

安装Dokuwiki：

sudo apt update
sudo apt install dokuwiki

方法二：手动安装

下载最新版本：

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

sudo tar -xzf dokuwiki-stable.tgz -C /var/www/html/
sudo mv /var/www/html/dokuwiki-*/ /var/www/html/dokuwiki
sudo chown -R www-data:www-data /var/www/html/dokuwiki

配置Web服务器

Apache配置

创建虚拟主机配置文件：

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

添加以下内容：

<VirtualHost *:80>
    ServerName wiki.yourdomain.com
    DocumentRoot /var/www/html/dokuwiki
    
    <Directory /var/www/html/dokuwiki>
        Options FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>
    
    ErrorLog ${APACHE_LOG_DIR}/dokuwiki_error.log
    CustomLog ${APACHE_LOG_DIR}/dokuwiki_access.log combined
</VirtualHost>

启用配置并重启Apache：

sudo a2ensite dokuwiki.conf
sudo a2enmod rewrite
sudo systemctl restart apache2

Nginx配置

创建配置文件：

sudo nano /etc/nginx/sites-available/dokuwiki

添加以下内容：

server {
    listen 80;
    server_name wiki.yourdomain.com;
    root /var/www/html/dokuwiki;
    index doku.php;
    
    location / {
        try_files $uri $uri/ @dokuwiki;
    }
    
    location @dokuwiki {
        rewrite ^/_media/(.*) /lib/exe/fetch.php?media=$1 last;
        rewrite ^/_detail/(.*) /lib/exe/detail.php?media=$1 last;
        rewrite ^/_export/([^/]+)/(.*) /doku.php?do=export_$1&id=$2 last;
        rewrite ^/(.*) /doku.php?id=$1 last;
    }
    
    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php7.4-fpm.sock;
    }
    
    location ~ /(data|conf|bin|inc)/ {
        deny all;
    }
}

启用配置并重启Nginx：

sudo ln -s /etc/nginx/sites-available/dokuwiki /etc/nginx/sites-enabled/
sudo systemctl restart nginx

完成安装向导

访问你的Wiki地址（如 http://wiki.yourdomain.com/install.php）
按照向导完成配置：
- 设置Wiki名称
- 选择授权方式（建议使用ACL）
- 创建管理员账户
完成安装后删除install.php：

sudo rm /var/www/html/dokuwiki/install.php

基本使用指南

创建页面

在搜索框输入新页面名称（如 start）
点击”创建此页面”按钮
使用Dokuwiki语法编辑内容
点击”保存”按钮

常用语法示例

= 一级标题 =
== 二级标题 ==

**粗体** //斜体//

[[内部链接]]
[[https://example.com|外部链接]]

{{wiki:dokuwiki-128.png?200|图片}}

  * 无序列表
  - 另一种无序列表
  1. 有序列表

> 引用文字

页面管理

点击”显示页面”查看最终效果
使用”编辑”按钮修改内容
“历史”按钮查看修改记录
“返回”按钮取消编辑

高级配置

用户认证

编辑配置文件：

sudo nano /var/www/html/dokuwiki/conf/users.auth.php

添加用户格式：

# 用户名:加密密码:真实姓名:邮箱:用户组
admin:$1$salt$hashedpassword:Admin User:admin@example.com:admin,user

权限控制

编辑ACL配置文件：

sudo nano /var/www/html/dokuwiki/conf/acl.auth.php

示例规则：

# 所有用户可读
*               @ALL          1
# 只有admin组可写
*               @admin        8
# 特定页面权限
private:*       @user         4

安装插件

通过管理界面安装：
- 访问 http://wiki.yourdomain.com/?do=admin&page=extension
- 搜索并安装所需插件
手动安装：
- 下载插件到 /var/www/html/dokuwiki/lib/plugins/
- 设置正确权限：

sudo chown -R www-data:www-data /var/www/html/dokuwiki/lib/plugins/

常用插件推荐

Tag - 添加标签功能
Wrap - 增强排版功能
Bureaucracy - 创建表单
Indexmenu - 自动生成目录
Move - 页面重命名/移动

备份与维护

备份Wiki内容

sudo tar -czf dokuwiki-backup-$(date +%F).tar.gz /var/www/html/dokuwiki/data/

升级Dokuwiki

备份当前安装
下载新版压缩包
解压覆盖旧文件（保留data/和conf/目录）
运行升级脚本：

php /var/www/html/dokuwiki/bin/indexer.php

常见问题解决

1. 页面编辑后无法保存

检查目录权限：

sudo chown -R www-data:www-data /var/www/html/dokuwiki/data/
sudo chmod -R 755 /var/www/html/dokuwiki/data/

2. 插件安装失败

确保PHP有写权限：

sudo chown -R www-data:www-data /var/www/html/dokuwiki/lib/plugins/

3. 页面显示404错误

检查URL重写规则是否生效，确保服务器配置正确。

结语

Dokuwiki是一个强大而轻量的知识管理工具，通过本文的安装和使用指南，你应该已经能够在Linux系统上成功部署自己的Wiki站点。无论是个人笔记还是团队协作，Dokuwiki都能提供简单高效的解决方案。

建议进一步探索： - 自定义模板主题 - 配置邮件通知 - 集成LDAP认证 - 设置定期自动备份

Happy wiki editing! “`