开源MediaWiki本地部署教程,Docker快速搭建个人维基百科系统,内网穿透远程访问
作者
小编
发布时间

MediaWiki是维基百科官方开源维基引擎,采用PHP开发,支持350+语言。功能丰富易扩展,适配小型个人维基到大型企业知识库。本文详解Docker Compose快速部署步骤、环境变量配置及访问方式,助力快速搭建个人知识库和团队文档平台。
项目介绍
MediaWiki 是一款免费开源的维基百科引擎,采用 PHP 编写而成。作为维基百科及其他维基媒体项目的核心平台,每月被数亿用户访问。这个强大的系统已被本地化为超过 350 种语言版本,以其卓越的稳定性和丰富的功能特性赢得了全球开发者和用户的信赖。
MediaWiki 具备以下特点:
功能丰富且易于扩展,支持数百个第三方插件和自定义功能
高度可扩展,适用于小型个人维基到大型企业知识库
安装简便,兼容大多数硬件和软件环境
多语言支持,覆盖全球用户
无论你是想搭建个人知识库、企业内部文档系统还是社区百科全书,MediaWiki 都能满足你的需求。
项目地址:点我跳转
部署安装
如需在外网也能访问你的 MediaWiki 系统,建议配置内网穿透工具。可以前往帕斯内网穿透注册账号,这样就能随时随地访问你的维基系统。具体操作步骤可以参考这个教程。
使用 Docker Compose 快速部署
MediaWiki 官方提供了开箱即用的 Docker Compose 配置,让技术小白也能轻松搭建。
第一步:复制配置文件
将以下配置保存为 `docker-compose.yml` 文件:
1version: '3'2services:3 mediawiki:4 image: docker-registry.wikimedia.org/dev/bookworm-php83-fpm:1.0.05 user: "${MW_DOCKER_UID}:${MW_DOCKER_GID}"6 volumes:7 - ./:/var/www/html/w:cached8 env_file:9 - '.env'10 environment:11 COMPOSER_CACHE_DIR: '/var/www/html/w/cache/composer'12 MW_SERVER: 'http://localhost:${MW_DOCKER_PORT:-8080}'13 MW_DOCKER_PORT: "${MW_DOCKER_PORT:-8080}"14 MW_SCRIPT_PATH: '/w'15 MW_DBPATH: '/var/www/html/w/cache/sqlite'16 MW_DBTYPE: 'sqlite'17 MW_LANG: 'en'18 MW_USER: '${MEDIAWIKI_USER:-Admin}'19 MW_PASS: '${MEDIAWIKI_PASSWORD:-dockerpass}'20 MW_SITENAME: 'MediaWiki'21 MW_LOG_DIR: /var/www/html/w/cache22 XDEBUG_ENABLE: '${XDEBUG_ENABLE:-true}'23 XHPROF_ENABLE: '${XHPROF_ENABLE:-true}'2425 mediawiki-web:26 image: docker-registry.wikimedia.org/dev/bookworm-apache2:1.0.127 user: "${MW_DOCKER_UID}:${MW_DOCKER_GID}"28 ports:29 - "${MW_DOCKER_PORT:-8080}:8080"30 volumes:31 - ./:/var/www/html/w:cached32 env_file:33 - '.env'34 environment:35 MW_LOG_DIR: /var/www/html/w/cache36 MW_DOCKER_PORT: "${MW_DOCKER_PORT:-8080}"3738 mediawiki-jobrunner:39 image: docker-registry.wikimedia.org/dev/bookworm-php83-jobrunner:1.0.040 user: "${MW_DOCKER_UID}:${MW_DOCKER_GID}"41 volumes:42 - ./:/var/www/html/w:cached43 env_file:44 - '.env'45 environment:46 MW_LOG_DIR: /var/www/html/w/cache47 MW_INSTALL_PATH: /var/www/html/w
第二步:打开你的 NAS 设备或服务器
在飞牛 NAS、群晖或其他 NAS 设备上,进入 Docker 管理界面。
第三步:启动容器
将上述配置文件上传到你的服务器,然后运行以下命令启动 MediaWiki:
1docker-compose up -d
等待容器启动完成即可。
端口配置说明
默认情况下,MediaWiki 会在 `8080` 端口运行。如果你的系统中该端口已被占用,可以修改 `docker-compose.yml` 中的以下部分:
1ports:2 - "你的端口号:8080"
例如改为 `'9090:8080'` 表示外部访问 9090 端口,内部仍然是 8080。
环境变量配置
创建一个 `.env` 文件来配置 MediaWiki 的参数:
必须设置:
`MEDIAWIKI_USER`: 管理员用户名(默认:Admin)
`MEDIAWIKI_PASSWORD`: 管理员密码(默认:dockerpass)- 强烈建议修改为强密码
可选设置:
`MW_DOCKER_PORT`: 访问端口(默认:8080)
`MW_DOCKER_UID`: Docker 用户 ID(默认:1000)
`MW_DOCKER_GID`: Docker 用户组 ID(默认:1000)
`MW_LANG`: 系统语言(默认:en,可改为 zh 使用中文)
`MW_SITENAME`: 维基网站名称(默认:MediaWiki)
`XDEBUG_ENABLE`: 是否启用调试模式(默认:true)
其他参数保持默认即可,直接启动就好了。
第四步:访问你的 MediaWiki
容器启动成功后,打开浏览器访问:
1http://你的服务器IP:8080
就能看到 MediaWiki 的欢迎页面了。使用你在环境变量中设置的用户名和密码登录,即可开始创建你的维基内容。
数据持久化
MediaWiki 的所有数据(包括页面内容和配置)都会保存在项目目录下的 `cache` 文件夹中。建议定期备份这个目录以防数据丢失。
本篇教程结束。现在你已经拥有了一个功能完整的 MediaWiki 系统,可以用来构建个人知识库或团队文档平台了!
相关教程

PassNAT内网穿透完整使用教程,详细讲解飞牛NAS、群晖NAS(7.1及以上/以下版本)和 Windows平台的配置步骤。从订阅购买、隧道创建到frpc客户端部署,手把手教你实现公 网访问。涵盖Docker镜像配置、配置文件导入、端口映射等关键操作,适合NAS用户和远 程访问需求者。

GreaterWMS是开源企业级仓库管理系统,采用Python+Node.js技术栈,集库存、出入库、订单处理于一体。提供Docker快速部署、美观管理界面、跨平台支持,助力中小企业和大型仓储中心实现现代化仓储管理,告别手工管理方式。

自托管书签管理工具Servas,采用Laravel和Inertia.js构建,支持标签分类、嵌套分组、浏览器扩展、多用户账户、双因素认证等功能。提供Docker快速部署,配置简单,数据安全本地存储,是整理和管理个人书签的最佳解决方案。

Dnote是一款极简强大的命令行笔记本应用,采用轻量级设计,单一二进制文件零依赖。笔记安全存储在SQLite数据库中,支持跨设备同步、全文搜索。本指南详细介绍Docker Compose快速部署方法,包括配置文件、端口设置、数据存储、开机自启等完整步骤,帮助你在NAS上轻松搭建私有笔记服务。