CentOS 7 作为一款稳定可靠的Linux发行版,常被用于搭建各类服务环境,MediaWiki 是一款功能强大的维基软件,广泛应用于知识管理系统、百科全书等项目,本文将详细介绍如何在CentOS 7系统上部署和配置MediaWiki,涵盖环境准备、安装步骤、基础配置及安全优化等内容。

环境准备与依赖安装
在开始部署MediaWiki之前,需要确保系统满足基本要求并安装必要的依赖包,更新系统软件包至最新版本:
sudo yum update -y
接着安装Apache、PHP和MySQL(MariaDB)等核心组件,MediaWiki支持PHP 5.6及以上版本,建议使用PHP 7.4以获得更好的性能:
sudo yum install -y httpd mariadb-server php php-mysql php-gd php-mbstring php-xml php-intl
安装完成后,启动并设置这些服务开机自启:
sudo systemctl start httpd mariadb sudo systemctl enable httpd mariadb
数据库配置
MediaWiki需要数据库来存储页面内容、用户信息等数据,首先初始化MariaDB并设置root密码:
sudo mysql_secure_installation
根据提示完成安全配置后,登录MariaDB创建专用数据库和用户:
mysql -u root -p CREATE DATABASE wikidb CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; CREATE USER 'wikiuser'@'localhost' IDENTIFIED BY 'yourpassword'; GRANT ALL PRIVILEGES ON wikidb.* TO 'wikiuser'@'localhost'; FLUSH PRIVILEGES; EXIT;
注意将yourpassword替换为强密码。

MediaWiki安装与配置
下载MediaWiki最新稳定版(以1.39为例)并解压到Apache网站根目录:
cd /tmp wget https://releases.wikimedia.org/mediawiki/1.39/mediawiki-1.39.0.tar.gz tar -xvzf mediawiki-1.39.0.tar.gz sudo mv mediawiki-1.39.0 /var/www/html/wiki sudo chown -R apache:apache /var/www/html/wiki
在浏览器中访问http://服务器IP/wiki,进入MediaWiki的Web安装界面,按照以下步骤完成配置:
- 语言选择:选择简体中文(或需要的语言)。
- 权限检查:确保所有依赖项通过检查,若出现权限问题需手动调整目录权限。
- 数据库配置:输入之前创建的数据库名、用户名和密码。
- 管理员账户:设置Wiki管理员用户名和密码。
- 站点配置:输入站点名称、首页描述等信息。
安装完成后,LocalSettings.php文件会自动生成,建议将其权限设置为仅可被Apache读取:
sudo chmod 640 /var/www/html/wiki/LocalSettings.php
基础功能优化
安装完成后,可通过LocalSettings.php进一步调整功能,例如启用重写规则以美化URL:
$wgArticlePath = "/wiki/$1"; $wgUsePathInfo = true;
在Apache中启用URL重写模块并创建.htaccess文件:
sudo systemctl restart httpd
MediaWiki支持大量扩展插件,可通过LocalSettings.php启用,

- VisualEditor:可视化编辑器,需额外安装相关扩展。
- SyntaxHighlight_GeSHi:代码高亮支持。
安装扩展时需从MediaWiki官网下载并按照文档配置。
安全与维护建议
为确保Wiki安全,需采取以下措施:
- 定期更新:关注MediaWiki和系统安全公告,及时更新软件版本。
- 权限控制:限制
LocalSettings.php的访问权限,避免敏感信息泄露。 - 备份策略:定期备份数据库和配置文件,可使用
mysqldump工具:mysqldump -u wikiuser -p wikidb > wikibackup.sql
- 防火墙配置:使用
firewalld仅开放必要端口(如HTTP/HTTPS):sudo firewall-cmd --permanent --add-service=http sudo firewall-cmd --reload
相关问答FAQs
Q1: 如何修改MediaWiki的默认首页?
A: 编辑LocalSettings.php文件,添加以下内容:
$wgDefaultUserOptions['usenewrc'] = true; $wgMainPageTitle = '首页'; // 将首页标题改为“首页”
或通过管理界面的“特殊页面”>“设置首页”功能直接修改。
Q2: MediaWiki上传图片失败怎么办?
A: 检查以下几点:
- 确认
images目录权限正确(通常为755,属主为apache)。 - 在
LocalSettings.php中调整上传限制:$wgFileExtensions = [ 'png', 'jpg', 'jpeg', 'gif' ]; // 允许的文件类型 $wgMaxUploadSize = 104857600; // 最大上传大小(100MB)
- 检查PHP配置文件
php.ini中的upload_max_filesize和post_max_size值是否足够大。