如何本地部署Wikimedia Commons并使用pywikibot测试批量图片上传？

当然可以本地部署Wikimedia Commons来做测试！这绝对是避免在真实Commons上误操作的最佳方案，我来一步步帮你搞定这个问题——

一、为什么普通MediaWiki没法直接用？ #

你之前安装的普通MediaWiki和Commons有核心差异：Commons依赖一系列专属扩展（比如UploadWizard、CommonsMetadata），还需要特定的命名空间配置和权限规则。直接用普通MediaWiki会导致Pywikibot的上传逻辑不兼容，所以得按Commons的标准来搭建环境。

二、本地搭建Commons测试环境的关键步骤 #

1. 选择便捷的部署方式 #

• Docker快速部署：找现成的Commons镜像（或者基于MediaWiki镜像扩展），用docker-compose一键拉起，省去手动装扩展的麻烦。
• 手动搭建MediaWiki+Commons扩展：
  • 先安装基础MediaWiki，然后在LocalSettings.php里启用必需扩展：

    wfLoadExtension( 'UploadWizard' );
    wfLoadExtension( 'MultimediaViewer' );
    wfLoadExtension( 'CommonsMetadata' );
    

  • 配置文件上传核心参数：

    $wgEnableUploads = true;
    $wgUploadDirectory = "/path/to/your/upload/folder"; // 确保服务器有读写权限
    $wgMaxUploadSize = 10485760; // 测试可以设大一点，比如10MB
    $wgEnableCsrfProtection = false; // 本地测试临时关闭，生产环境务必开启
    

  • 给测试账号分配上传权限：进入本地MediaWiki的「特殊页面-权限管理」，确保你的测试账号拥有uploadfile权限（直接设为管理员最省事）。

三、Pywikibot适配本地环境的配置流程 #

这是你之前卡住的核心环节，按下面的步骤来：

1. 安装Pywikibot #

用pip快速安装：

pip install pywikibot

或者克隆源码仓库安装，按需选择即可。

2. 生成本地站点配置 #

运行Pywikibot的配置生成工具：

python pwb.py generate_user_files

然后按提示操作：

• 选择Custom site（自定义站点）
• 输入本地MediaWiki的API地址，比如http://localhost/mediawiki/api.php（根据你的本地部署路径调整，确保浏览器能打开这个地址）
• 给站点起个标识名，比如localcommons
• 输入测试账号的用户名和密码完成认证

3. 编写测试上传脚本 #

给你一个极简的测试脚本，直接复制就能用：

import pywikibot

# 加载本地Commons站点配置
site = pywikibot.Site('localcommons')
site.login()

# 准备上传参数
local_image_path = "./test_photo.jpg"  # 本地图片路径
wiki_file_title = "File:Test_photo.jpg"  # 上传到Wiki后的文件名
upload_summary = "Test upload via Pywikibot (local test)"

try:
    # 创建文件页对象
    file_page = pywikibot.FilePage(site, wiki_file_title)
    # 执行上传，ignore_warnings=True跳过重复上传等警告
    file_page.upload(local_image_path, comment=upload_summary, ignore_warnings=True)
    print(f"✅ 上传成功！文件地址：{file_page.get_full_url()}")
except Exception as e:
    print(f"❌ 上传失败：{str(e)}")

4. 常见问题排查 #

• 如果提示「API请求失败」：检查本地MediaWiki的API地址是否正确，确保服务器在运行
• 如果提示「权限不足」：确认测试账号的uploadfile权限已开启
• 如果提示「目录无写入权限」：给$wgUploadDirectory设置正确的服务器用户权限（比如Apache的www-data用户）

四、额外测试建议 #

• 测试各种边界场景：重复上传、带EXIF元数据的图片、添加分类标签等，确保你的批量上传脚本逻辑完全符合预期
• 本地环境可以随时重置，不用担心数据残留，完全放开了测试就行

内容的提问来源于stack exchange，提问作者kolam