用 MediaWiki 搭建个人知识库

信息碎片化问题困扰了我很久。笔记散落在各种 App 里—手机备忘录、微信收藏、浏览器书签、Notion 页面—找什么都找不到。

我需要一个集中、结构化、完全受控知识管理系统。试过 Notion、试过 Obsidian、试过语雀，最终选择了 MediaWiki。

听起来有点复古？确实。但 MediaWiki 有一个其他工具无法替代优势：它就是维基百科用那套系统。

为什么是 MediaWiki

维度	MediaWiki	Notion	Obsidian
数据归属	自己的服务器	Notion 云端	本地文件
内链机制	原生支持	手动链接	双向链接
搜索	全文搜索	还行	需要插件
权限控制	精细	有限	无
离线使用	否	否	是
成本	免费	免费有限制	免费有限制

我选择 MediaWiki 的核心理由：

1. 内链是知识库灵魂。MediaWiki 的 [[页面名]] 内链语法和维基百科完全一致，不需要学新语法。
2. 数据在自己手里。部署在自己服务器上，不依赖任何第三方。
3. 成熟稳定。运行了 20 年的系统，bug 极少，文档齐全。

安装部署

环境要求

• PHP 7.4+（推荐 8.x）
• MySQL/MariaDB
• Apache/Nginx
• 推荐 XAMPP 一键部署（省心）

核心步骤

# 下载 MediaWiki
wget https://releases.wikimedia.org/mediawiki/1.40/mediawiki-1.40.0.tar.gz
tar -xzf mediawiki-1.40.0.tar.gz
mv mediawiki-1.40.0 /opt/lampp/htdocs/wiki

# 浏览器访问 http://localhost/wiki 开始安装向导
# 安装完成后将 LocalSettings.php 下载到 wiki 根目录

安装向导会引导你配置数据库、管理员账号、语言等。整个过程不超过 10 分钟。

自定义配置

安装完成后，所有自定义都在 LocalSettings.php 中进行。

修改站点名称

$wgSitename = "公爵的知识库";

替换 Logo

$wgLogo = "$wgResourceBasePath/resources/assets/wiki.gif";

将自定义 Logo 文件放到 /resources/assets/ 目录下，修改路径即可。

页脚显示修订人

$wgMaxCredits = 2;

这会在页面底部显示 2 位编辑者信息，适合团队协作场景。

权限控制

// 允许游客注册和浏览，禁止编辑
$wgGroupPermissions['*']['createaccount'] = true;
$wgGroupPermissions['*']['read'] = true;
$wgGroupPermissions['*']['edit'] = false;

这个配置适合个人知识库：公开阅读，只有管理员可以编辑。

定制侧边栏

访问 http://your-wiki/index.php/MediaWiki:Sidebar 编辑侧边栏：

* navigation
** mainpage|mainpage-description
** recentchanges-url|recentchanges
** helppage|help
** 分类:Wiki定制化|更好地使用wiki

使用技巧

模板化

为重复性内容创建模板。比如我有一个”技术笔记”模板，包含以下字段：

== 概述 ==
== 环境信息 ==
== 操作步骤 ==
== 注意事项 ==
== 相关条目 ==

新建条目时直接引用模板，省去重复编写结构时间。

分类体系

MediaWiki 的分类是层级结构，类似文件系统目录。我的顶级分类：

• 技术：编程、运维、工具
• 游戏：攻略、评测、机制
• 生活：读书、思考、经验

每篇条目至少归入一个分类，通过 [[Category:分类名]] 语法添加。

搜索

MediaWiki 内置全文搜索引擎，支持中文分词。搜索框输入关键词即可，高级搜索支持命名空间筛选、布尔运算等。

不适合场景

公平起见，也说说 MediaWiki 的不足：

• 没有离线功能。必须联网访问，地铁上没法用。
• 移动端体验差。官方皮肤对手机不友好，需要装 MobileFrontend 扩展。
• Markdown 不支持。必须学 wikitext 语法，对新手有门槛。
• 协作功能弱。没有实时协同编辑，不如 Notion。

如果你使用场景高度依赖移动端或协作，Notion/Obsidian 可能更合适。

写在

工具只是工具，重要的是体系。一个维护良好 MediaWiki 和一个结构清晰 Notion 空间，效果没有本质区别。关键在于：你是否有意识地在整理自己知识，而不是在堆砌信息。

我的 Wiki 运行三年了，条目从最初十几个增长到两百多。每次搜索到半年前自己写笔记时，我都觉得当初花时间搭建它是值得。