DokuWiki Servidor Próprio: Wiki Sem Banco de Dados

A gestão do conhecimento corporativo e a documentação técnica exigem ferramentas que sejam confiáveis, duradouras e independentes de infraestruturas complexas. Neste cenário, o DokuWiki se destaca como uma solução robusta para quem busca uma wiki sem banco de dados. Diferente de plataformas populares como MediaWiki ou Confluence, o DokuWiki não depende de MySQL, PostgreSQL ou MariaDB. Ele armazena toda a informação em arquivos de texto plano (UTF-8), o que simplifica drasticamente o backup, a migração e a manutenção do servidor.

Este tutorial é ideal para sysadmins, devs e profissionais de TI que desejam instalar uma wiki sem banco de dados em um ambiente Linux, seja em uma VPS dedicada ou em um servidor físico. Vamos guiar você através da instalação completa do DokuWiki em um sistema Ubuntu/Debian, configurando o Apache como proxy reverso e garantindo a segurança básica.

Pré-requisitos e Preparação do Ambiente

Antes de iniciar a instalação do dokuwiki servidor próprio, é fundamental ter um ambiente limpo e atualizado. Recomendamos o uso de uma distribuição Linux recente, como Ubuntu 22.04 LTS ou Debian 12. Você precisará de acesso root ou um usuário com privilégios sudo.

O primeiro passo é atualizar os pacotes do sistema operacional para garantir que todas as bibliotecas e dependências estejam nas versões mais recentes e seguras.

sudo apt update
sudo apt upgrade -y

Em seguida, instale as dependências básicas necessárias para a execução do servidor web e para o gerenciamento de certificados SSL. O DokuWiki é escrito em PHP, portanto, precisamos garantir que o interpretador e os módulos necessários estejam instalados.

sudo apt install apache2 libapache2-mod-php php-cli php-common php-gd php-xml unzip curl -y

Com as dependências instaladas, vamos habilitar os módulos essenciais do Apache. O módulo rewrite é crucial para a geração de URLs amigáveis (SEO), e o módulo ssl será necessário para criptografar a comunicação com a wiki.

sudo a2enmod rewrite
sudo a2enmod ssl
sudo systemctl restart apache2

Baixando e Configurando o DokuWiki

Agora que o servidor está pronto, precisamos baixar os arquivos do DokuWiki. A versão estável mais recente pode ser encontrada diretamente no site oficial. Para este tutorial, utilizaremos a linha de comando para garantir uma instalação limpa.

Crie um diretório dedicado para a instalação e navegue até ele. É uma boa prática separar os arquivos binários do servidor web dos dados da aplicação, mas para simplificar o processo inicial, instalaremos em um subdiretório padrão do Apache.

cd /tmp
sudo mkdir -p /var/www/wiki
sudo chown $USER:$USER /var/www/wiki
cd /var/www/wiki

Baixe o arquivo tar.gz da última versão estável. Verifique sempre o site oficial para obter o link mais recente, mas o padrão costuma ser:

curl -L -o dokuwiki.tgz https://download.dokuwiki.org/

Após o download, extraia os arquivos e mova o conteúdo para o diretório raiz da aplicação. A estrutura do DokuWiki é simples: ele extrai tudo para um subdiretório com versão.

tar -xzf dokuwiki.tgz
sudo mv dokuwiki-*/* /var/www/wiki/
sudo rm -rf dokuwiki-* dokuwiki.tgz

Agora, defina as permissões corretas. O Apache precisa ter permissão de leitura e escrita em algumas pastas específicas para que os usuários possam editar páginas e fazer upload de arquivos.

sudo chown -R www-data:www-data /var/www/wiki
sudo chmod -R 755 /var/www/wiki

Configuração do Servidor Web (Apache)

Para que o dokuwiki servidor próprio seja acessível de forma organizada, vamos criar um Virtual Host no Apache. Isso permite que acessemos a wiki através de um domínio ou subdomínio dedicado.

Crie um arquivo de configuração para o site:

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

Cole a seguinte configuração, substituindo wiki.seudominio.com pelo seu domínio real:

<VirtualHost *:80>
    ServerName wiki.seudominio.com
    DocumentRoot /var/www/wiki

    <Directory /var/www/wiki>
        Options -Indexes +FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>

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

Habilite o novo site e desative o padrão do Apache para evitar conflitos:

sudo a2ensite wiki.conf
sudo a2dissite 000-default.conf
sudo systemctl reload apache2

Instalação via Navegador Web

Embora tenhamos preparado os arquivos no servidor, o DokuWiki possui uma etapa de configuração final que deve ser feita via navegador para garantir a segurança. Abra seu navegador e acesse http://wiki.seudominio.com/install.php.

Você verá um formulário com diversos campos. É aqui que você define as credenciais de administrador e configura o comportamento da wiki.

• Name of Wiki: O nome que aparecerá no topo da página.
• Language: Selecione pt-br para português do Brasil.
• Admin Account: Defina o nome de usuário e senha para o administrador. Use uma senha forte.
• License: O DokuWiki é GPL, selecione a opção correspondente.

Após preencher os dados, clique em "Create Account". Se tudo correr bem, você verá uma mensagem de sucesso. Muito importante: imediatamente após a criação da conta, exclua o arquivo install.php do servidor para evitar que qualquer pessoa possa reconfigurar sua wiki.

sudo rm /var/www/wiki/install.php

Habilitando HTTPS com Let's Encrypt

Para uma instalação profissional de wikis open source, a segurança é primordial. Vamos instalar o Certbot para obter um certificado SSL gratuito do Let's Encrypt, garantindo que a comunicação seja criptografada.

sudo apt install certbot python3-certbot-apache -y
sudo certbot --apache -d wiki.seudominio.com

O Certbot irá pedir um email de contato e aceitar os termos de serviço. Em seguida, ele configurará automaticamente o Apache para redirecionar todo o tráfego HTTP para HTTPS. Se houver opção, escolha "2" para forçar o redirecionamento SSL.

Verifique se o certificado foi instalado corretamente acessando https://wiki.seudominio.com. O cadeado de segurança deve aparecer na barra de endereço.

Otimizando a Segurança do DokuWiki

Após a instalação básica, é recomendável ajustar algumas configurações de segurança diretamente no arquivo conf/local.php, que foi gerado durante o processo de instalação via web. Edite o arquivo:

sudo nano /var/www/wiki/conf/local.php

Adicione ou modifique as seguintes linhas para reforçar a segurança:

$conf['allowdebug'] = 0; // Desativa informações de debug em produção
$conf['usemail'] = 1;    // Habilita envio de emails (se necessário)
$conf['securelink'] = 1; // Gera links seguros internos
$conf['superuser'] = '@admin'; // Garante que o admin tem acesso total

Além disso, bloqueie o acesso direto a pastas sensíveis editando o arquivo .htaccess na raiz da instalação. Se ele não existir, crie-o:

sudo nano /var/www/wiki/.htaccess

Adicione estas regras para proteger arquivos de configuração e dados:

# Bloquear acesso a pastas sensíveis
<DirectoryMatch "/\.dokuwiki/">>
    Require all denied
</DirectoryMatch>

# Bloquear acesso direto a arquivos .php na pasta conf (redundância)
<FilesMatch "^.*\.php$">
    <If "%{REQUEST_URI} =~ m#^/conf/#">
        Require all denied
    </If>
</FilesMatch>

Mantendo a Wiki Atualizada e Segura

Uma das grandes vantagens de manter um dokuwiki servidor próprio é o controle total sobre as atualizações. No entanto, isso também traz a responsabilidade de monitorar vulnerabilidades.

Backups Automáticos

Como o DokuWiki não usa banco de dados, o backup é extremamente simples. Você precisa apenas fazer cópia dos arquivos e da pasta conf/.

# Exemplo de script de backup simples
tar -czf /backups/wiki-$(date +%F).tar.gz /var/www/wiki/conf/ /var/www/wiki/data/

Crie um cron job para rodar isso diariamente:

sudo crontab -e

Adicione a linha:

0 2 * * * tar -czf /backups/wiki-$(date +\%F).tar.gz /var/www/wiki/conf/ /var/www/wiki/data/

Atualização do Core

Para atualizar o DokuWiki, não é necessário reinstalar. Basta baixar a nova versão, substituir os arquivos (exceto conf/local.php e data/) e verificar se há incompatibilidades com plugins.

cd /tmp
curl -L -o dokuwiki-stable.tgz https://download.dokuwiki.org/
tar -xzf dokuwiki-stable.tgz
# Mover arquivos novos, preservando conf e data
cp -r dokuwiki-stable/* /var/www/wiki/
sudo chown -R www-data:www-data /var/www/wiki

Extensibilidade e Plugins

O DokuWiki é altamente extensível através de plugins. A interface administrativa permite gerenciar facilmente a instalação, atualização e remoção de plugins. Acesse Ajuda > Gerenciamento de Plugins no menu lateral da sua wiki.

Plugins populares incluem:

• Import/Export: Permite importar páginas do MediaWiki ou exportar para PDF.
• Syntax Highlight: Melhora a exibição de blocos de código com colorização de sintaxe.
• Usermanager: Facilita a gestão de usuários e grupos em wikis maiores.

Para instalar, basta procurar o nome do plugin na lista oficial, clicar em "Install" e a interface cuidará do download e das permissões necessárias.

Considerações Finais sobre Gestão de Conhecimento Self-Hosted

Optar por uma documentação self-hosted como o DokuWiki oferece privacidade, controle total dos dados e custos operacionais reduzidos. A ausência de banco de dados elimina um ponto único de falha comum em outras soluções enterprise.

Para ambientes que exigem versionamento avançado de páginas ou integração profunda com sistemas de ticketing, talvez outras ferramentas sejam mais adequadas. Porém, para documentação técnica, manuais de procedimentos e bases de conhecimento internas, o DokuWiki continua sendo uma das opções mais leves, rápidas e confiáveis do mercado.

Lembre-se de monitorar os logs do Apache e configurar alertas de expiração de certificado SSL para manter sua hospedagem wiki leve sempre segura e disponível. Com a manutenção adequada, seu servidor wiki pode durar anos sem necessidade de grandes reestruturações.