远程图片采集器

插件概述

远程图片采集器是一款专为 WordPress 设计的图片本地化插件。当你在文章中引用了其他网站的图片（外链图片）时，这款插件可以自动识别这些图片，将其下载到你的服务器，并替换文章中的图片链接。

核心功能一览

安装与激活

系统要求

安装步骤

1. 1
   下载插件 获取插件压缩包 img-collector.zip，确保文件完整未损坏。
2. 2
   进入插件安装页面 登录 WordPress 后台，点击左侧菜单 插件 → 安装插件。
3. 3
   上传插件 点击页面顶部的 上传插件 按钮，选择下载的 img-collector.zip 文件，然后点击 立即安装。
4. 4
   激活插件 安装完成后，点击 启用插件 按钮。插件激活后会自动创建所需的数据库表。

手动安装（可选）

如果你无法通过后台上传，也可以手动安装：

# 1. 解压插件压缩包
unzip img-collector.zip

# 2. 将 img-collector 文件夹上传到服务器
# 路径：/wp-content/plugins/img-collector/

# 3. 在 WordPress 后台 → 插件 → 已安装插件 中启用

基础设置

插件安装完成后，建议先进行基础设置，以符合你的使用需求。点击左侧菜单 设置 → 远程图片采集器 进入设置页面。

常规设置

图片处理设置

服务器优化设置

代理设置（可选）

如果你的服务器无法直接访问某些图片源（如部分海外图片服务器），可以配置代理服务器：

1. 在 代理设置 标签页中勾选 启用代理
2. 填写代理主机地址和端口
3. 如代理需要认证，填写用户名和密码

手动采集图片

手动采集是最常用的方式，适合在编辑单篇文章时使用。插件会在经典编辑器工具栏添加一个采集按钮。

在经典编辑器中采集

1. 1
   编辑文章 进入文章编辑页面，确保文章内容中包含外链图片（即图片 URL 不是你自己网站的域名）。
2. 2
   点击采集按钮 在编辑器工具栏中找到 保存站外图片 按钮（带下载图标），点击它。
3. 3
   选择要采集的图片 弹出的模态窗口会列出文章中检测到的所有外链图片。每张图片都有缩略图预览、URL 和域名信息。勾选你想要采集的图片（默认全选）。
4. 4
   选择采集方式 在模态窗口顶部选择采集方式：服务器采集（推荐） 或 代理采集。
5. 5
   开始采集 点击 开始采集 按钮，插件会按顺序逐张下载图片。采集过程中可以看到每张图片的状态变化：待采集 → 采集中 → 已采集/失败。
6. 6
   保存文章 采集完成后，关闭模态窗口，点击 更新 或 发布 保存文章。此时文章中的图片链接已经替换为本地链接。

采集状态说明

自动采集模式

如果你希望每次保存文章时都自动采集外链图片，可以开启自动采集模式。

开启自动采集

1. 1
   进入设置页面 点击 设置 → 远程图片采集器。
2. 2
   切换采集模式 在 常规设置 标签页中，将 采集模式 从"手动"改为 自动。
3. 3
   保存设置 点击页面底部的 保存设置 按钮。

自动采集的工作流程

开启自动采集后，每当你执行以下操作时，插件会自动检测并采集外链图片：

• 发布新文章
• 更新已发布的文章
• 保存草稿

采集过程在后台自动完成，采集结果会记录到日志中。你可以在 日志管理 标签页中查看历史记录。

水印功能

插件支持为采集的图片添加文字水印，保护你的图片版权。

启用水印

1. 1
   进入水印设置 在插件设置页面切换到 水印设置 标签页。
2. 2
   启用水印功能 勾选 启用水印 复选框。
3. 3
   设置水印文字 在 水印文字 输入框中填写你想要显示的文字，如你的网站名称或品牌标识。
4. 4
   选择字体 从字体下拉框中选择合适的字体。插件内置了 Arial、微软雅黑、黑体、宋体等常用字体，也支持上传自定义字体文件。
5. 5
   调整样式 设置字体大小（10-100px）、颜色、透明度（0-100%）和位置（9个方位可选）。
6. 6
   保存设置 点击 保存设置，之后采集的图片会自动添加水印。

使用自定义字体

如果内置字体不能满足需求，你可以上传自己的字体文件：

1. 准备 TTF、TTC 或 OTF 格式的字体文件
2. 将字体文件上传到插件目录的 fonts/ 文件夹中：/wp-content/plugins/img-collector/fonts/
3. 刷新设置页面，字体下拉框会自动显示自定义字体

中文字体支持

插件内置了中文字体自动回退机制。如果水印文字包含中文但所选字体不支持，插件会自动在系统中查找可用的中文字体（如微软雅黑、文泉驿微米黑等）。如果系统未安装中文字体，建议上传自定义中文字体文件到 fonts 目录。

过滤规则

过滤规则让你可以精确控制哪些图片需要采集，哪些图片应该跳过。

顺序过滤

按图片在文章中出现的顺序进行过滤：

• 起始位置：从第几张图片开始采集（如设置为 2，则跳过第一张图片）
• 数量限制：最多采集多少张图片（如设置为 5，则只采集前 5 张）

例如，设置起始位置为 2、数量限制为 3，则只采集文章中的第 2、3、4 张图片。

尺寸过滤

按图片尺寸过滤，跳过尺寸过小的图片（如头像、图标等）：

• 最小宽度：只采集宽度大于等于该值的图片
• 最小高度：只采集高度大于等于该值的图片

格式过滤

按图片格式过滤，只采集指定格式的图片：

• 支持的格式：JPG、JPEG、PNG、GIF、WebP、BMP、TIF
• 可以勾选多种格式，未勾选的格式将被跳过

域名过滤

按图片所在域名进行白名单或黑名单过滤：

• 在 域名列表 中输入要过滤的域名，每行一个
• 支持通配符，如 *.example.com 匹配所有子域名
• 列表中的域名将被跳过（黑名单模式）

URL 去重

开启 URL 去重后，插件会记录已采集过的图片 URL。如果同一张图片在多个文章中出现，插件会直接使用已采集的本地副本，而不会重复下载。

全局扫描

全局扫描功能可以批量检测网站中所有文章的外链图片，并统一进行采集。这对于已有大量文章需要处理的情况非常实用。

进入扫描页面

点击左侧菜单 图片采集扫描 进入全局扫描页面。

设置扫描条件

执行扫描

1. 1
   设置扫描条件 根据需要填写扫描条件。如果不需要限制，保持默认即可扫描全部内容。
2. 2
   开始扫描 点击 开始扫描 按钮。插件会遍历所有符合条件的文章，检测其中的外链图片。
3. 3
   查看扫描结果 扫描完成后，结果表格会显示所有包含外链图片的文章，包括文章 ID、标题、外链图片数量和当前状态。
4. 4
   选择要采集的文章 勾选需要采集的文章（可使用表头的全选框一键全选），然后点击 批量采集选中项。
5. 5
   等待采集完成 批量采集会逐篇文章处理，每篇文章采集完成后状态会更新为"已采集"。采集过程中请保持页面打开。

单个文章采集

在扫描结果中，每篇文章右侧都有 采集 按钮。点击该按钮可以单独采集该文章的外链图片，适合只需要处理个别文章的情况。

古腾堡编辑器

插件同时支持 WordPress 古腾堡（区块）编辑器。在古腾堡编辑器中，插件以侧边栏面板的形式提供采集功能。

在古腾堡编辑器中采集

1. 1
   打开文章编辑 在古腾堡编辑器中打开或创建一篇文章，确保内容中包含外链图片。
2. 2
   打开插件侧边栏 点击编辑器右上角的 选项 菜单（三个点），选择 远程图片采集器，或点击顶部工具栏中的图片采集图标。
3. 3
   选择采集方式 在侧边栏中选择采集方式：服务器采集、代理采集或浏览器采集。
4. 4
   开始采集 点击 开始采集 按钮。采集完成后，编辑器内容会自动更新，外链图片链接替换为本地链接。

常见问题

采集失败怎么办？

如果图片采集失败，请按以下步骤排查：

1. 检查图片 URL 是否可访问：在浏览器中直接打开图片 URL，确认图片可以正常显示
2. 检查服务器配置：确认 PHP 的 allow_url_fopen 设置为 On，或 cURL 扩展已启用
3. 检查目标网站限制：部分网站有防盗链机制，会拒绝非浏览器请求
4. 尝试代理采集：如果服务器无法直接访问目标图片，配置代理服务器后再试
5. 查看错误日志：在插件的日志管理中查看具体错误信息

水印中文显示乱码？

水印中文乱码通常是因为服务器缺少中文字体支持。解决方法：

1. 在设置中选择 微软雅黑 或 黑体 等中文字体
2. 如果内置字体不可用，下载中文字体文件（如 msyh.ttc）上传到插件的 fonts/ 目录
3. 确保服务器安装了 GD 库和 FreeType 支持

采集后图片不显示？

如果采集完成后文章中的图片无法显示：

1. 检查图片是否成功上传到媒体库（媒体 → 库）
2. 确认文章中的图片 URL 已正确替换为本地 URL
3. 检查文件权限，确保上传目录（/wp-content/uploads/）有读取权限
4. 清除浏览器缓存和 CDN 缓存（如果使用 CDN）

如何查看采集日志？

插件会自动记录每次采集的日志。在设置页面的 日志管理 标签页中，可以查看：

• 采集时间
• 原始图片 URL
• 本地图片 URL
• 采集状态（成功/失败）
• 错误信息（如果失败）

日志默认保留 30 天，可以在设置中调整保留天数。

插件冲突怎么办？

如果插件与其他插件或主题发生冲突：

1. 暂时停用其他插件，逐一排查冲突源
2. 检查浏览器控制台是否有 JavaScript 错误
3. 确认 WordPress 和 PHP 版本符合插件要求
4. 如果问题持续，可以在 GitHub 提交 Issue 寻求帮助