stefaanvermassen/mediawiki-azure

MediaWiki Docker镜像说明

镜像概述

MediaWiki是一款强大的开源wiki系统，广泛应用于***等平台，支持协作式内容创建与管理。Bitnami提供的该镜像基于minideb构建，具备自动更新、稳定可靠的特点，可快速部署并与MariaDB数据库无缝集成，降低用户搭建wiki站点的技术门槛。

核心功能

• 数据持久化：通过挂载卷保存应用和数据库数据，避免容器重启丢失信息
• 灵活配置：支持通过环境变量设置用户信息、数据库连接、SMTP邮件服务等
• 多环境部署：兼容Docker Compose、Kubernetes（Helm Charts）等部署方式
• 扩展能力：可安装Imagemagick提升图片处理质量，支持现有Bitnami MediaWiki栈迁移
• 安全更新：Bitnami每日更新镜像，及时修复安全漏洞

使用场景

• 企业内部知识管理平台：沉淀团队经验与文档
• 开源项目文档站点：方便社区贡献与查阅
• 教育机构协作平台：支持师生共同编辑学习资料
• 小型组织协作库：提升内部沟通与信息共享效率

配置说明

环境变量

可通过环境变量调整镜像配置，关键变量包括：

• 用户配置：MEDIAWIKI_USERNAME（默认user）、MEDIAWIKI_PASSWORD（默认bitnami1）等
• 数据库配置：MARIADB_HOST（默认mariadb）、MEDIAWIKI_DATABASE_NAME（默认bitnami_mediawiki）等
• SMTP配置：SMTP_HOST、SMTP_PORT、SMTP_USER等（支持Gmail等邮件服务）

部署示例

Docker Compose部署

yaml
version: '2'
services:
  mariadb:
    image: 'docker.xuanyuan.run/bitnami/mariadb:latest'
    environment:
      - ALLOW_EMPTY_PASSWORD=yes
      - MARIADB_USER=bn_mediawiki
      - MARIADB_DATABASE=bitnami_mediawiki
    volumes:
      - 'mariadb_data:/bitnami'
  mediawiki:
    image: 'docker.xuanyuan.run/bitnami/mediawiki:1'
    ports:
      - '80:80'
      - '443:443'
    environment:
      - MARIADB_HOST=mariadb
      - MEDIAWIKI_DATABASE_USER=bn_mediawiki
      - MEDIAWIKI_DATABASE_NAME=bitnami_mediawiki
      - ALLOW_EMPTY_PASSWORD=yes
    volumes:
      - 'mediawiki_data:/bitnami'
    depends_on:
      - mariadb
volumes:
  mariadb_data:
    driver: local
  mediawiki_data:
    driver: local

执行命令：

bash
curl -sSL https://raw.githubusercontent.com/bitnami/bitnami-docker-mediawiki/master/docker-compose.yml > docker-compose.yml
docker-compose up -d

手动部署

1. 创建网络：docker network create mediawiki-tier
2. 启动MariaDB：

bash
docker volume create mariadb_data
docker run -d --name mariadb \
  -e ALLOW_EMPTY_PASSWORD=yes \
  -e MARIADB_USER=bn_mediawiki \
  -e MARIADB_DATABASE=bitnami_mediawiki \
  --net mediawiki-tier \
  --volume mariadb_data:/bitnami \
  docker.xuanyuan.run/bitnami/mariadb:latest

3. 启动MediaWiki：

bash
docker volume create mediawiki_data
docker run -d --name mediawiki -p 80:80 -p 443:443 \
  -e ALLOW_EMPTY_PASSWORD=yes \
  -e MEDIAWIKI_DATABASE_USER=bn_mediawiki \
  -e MEDIAWIKI_DATABASE_NAME=bitnami_mediawiki \
  --net mediawiki-tier \
  --volume mediawiki_data:/bitnami \
  docker.xuanyuan.run/bitnami/mediawiki:latest

访问地址：http://你的IP/

升级与迁移

• 升级镜像：拉取最新镜像，备份数据后重启容器
• 迁移现有栈：导出原数据库与文件，导入新容器并修复权限（详见原镜像文档）

注意事项

• 生产环境建议设置强密码，避免使用ALLOW_EMPTY_PASSWORD=yes
• 持久化卷需定期备份，防止数据丢失
• 如需提升图片处理能力，可自定义镜像安装Imagemagick
• 遇到问题可参考Bitnami官方文档或提交Issue至GitHub仓库：https://github.com/bitnami/bitnami-docker-mediawiki