WordPress MU Domain Mapping 插件配置详解

VFX大学 WordPress MU Domain Mapping 插件配置详解

标签: ,

  • This topic is empty.
正在查看 0 条回复
  • 作者
    帖子
    • #614

      追光
      管理员

      我们来详细讲解经典的多站点独立域名绑定插件 —— WordPress MU Domain Mapping 插件的用法、原理与配置方法。

      尽管该插件已不再更新,但在一些老项目或特殊环境中仍然被使用,并且具备完整的后台 UI 管理界面,适合不想使用纯代码方式配置的用户。


      🌐 WordPress MU Domain Mapping 插件配置详解

      实现多站点子站绑定独立域名的经典方案


      🧠 插件概览

      • 插件名称:WordPress MU Domain Mapping

      • 插件主页:WordPress MU Domain Mapping 插件中文修复版

      • 最后更新:较久(功能稳定但已停止维护)

      • 支持:WordPress Multisite(子域名或子目录均可)

      • 特点:

        ✅ 可视化绑定界面

        ✅ 支持域名强制重定向

        ✅ 支持启用 Cookie 同域登录

        ✅ 支持 SSL / 自定义 IP 映射


      📦 安装步骤

      1. 下载与上传

      插件不在默认搜索中显示,请手动安装:

      • 上传并解压至 /wp-content/plugins/wordpress-mu-domain-mapping/


      2. 修改

      wp-config.php

      (必须)

      wp-config.php 文件中添加以下代码:

      define( 'SUNRISE', 'on' );

      放置位置:在 /* That’s all, stop editing! */ 之前


      3. 复制

      sunrise.php

      插件安装后,会有一个 sunrise.php 文件在插件目录下:

      将其复制到:

      /wp-content/sunrise.php

      ✅ 注意:不是放在插件目录内,而是 WordPress 内容目录的根部。


      4. 启用插件

      进入后台「网络后台 > 插件」,启用 WordPress MU Domain Mapping 插件(网络启用)。


      🛠 插件配置使用

      1. 管理界面位置

      插件启用后,在网络后台菜单中会新增:

      • Domain Mapping > Domains

      • Domain Mapping > Settings


      2. 设置绑定参数(Settings)

      常见配置说明:

      选项

      说明

      Primary Domain

      将此域名设为子站主域(默认)

      Redirect

      将子站原访问地址强制跳转至独立域名

      Permanent Redirect (301)

      用于 SEO 的永久跳转

      Enable Cookie Mapping

      多站间自动登录共享(多域名共 Cookie)


      3. 添加绑定域名(Domains)

      1. 进入 Domain Mapping > Domains

      2. 点击「Add New」

      3. 填写以下内容:

      字段

      内容

      Domain

      aivideo.com(要绑定的独立域名)

      Blog ID

      目标子站的 ID(可在站点列表中看到)

      Primary

      是否设为主域名(默认勾选)

      1. 保存即可


      🌐 配置 DNS 与服务器

      ✅ DNS 设置

      将绑定域名如 aivideo.com 的 A 记录指向你的服务器 IP。

      ✅ Nginx 虚拟主机配置

      server {
          listen 80;
          server_name aivideo.com;
      
          root /www/wwwroot/你的主站目录;
          index index.php index.html;
      
          location / {
              try_files $uri $uri/ /index.php?$args;
          }
      
          location ~ \.php$ {
              include fastcgi_params;
              fastcgi_pass unix:/run/php/php8.2-fpm.sock;
              fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
          }
      }

      🧠 原理简述:插件做了什么?

      1. 通过 sunrise.php 拦截访问请求,检测访问域名

      2. 查找该域名是否被绑定到某个子站点(blog ID)

      3. 动态切换数据库上下文,加载对应子站点配置

      4. 可强制跳转域名、共享登录状态、定义 SSL 域名策略等


      ✅ 使用效果

      原访问地址

      映射后的访问地址

      实际效果

      dev.newvfx.com

      aivideo.com

      访问时自动切换 blog ID,显示为独立站

      sound.newvfx.com

      soundvfx.net

      SEO 独立,外观不变,但路径完全隔离

      后台中仍用子站原始地址管理,对用户透明


      ❗注意事项

      问题

      说明

      插件已停更

      功能稳定但未来不再更新,建议用在长期不变项目

      sunrise.php 必须存在

      缺失将导致域名解析失败

      Cookie 映射受浏览器限制

      跨域登录在现代浏览器中受限(如 Safari/Chrome 隐私策略)

      若干插件不兼容

      个别插件不支持动态切换站点上下文(如某些缓存、会员插件)


      🆚 与新方案比较:Mercator 与 MU Domain Mapping

      项目

      MU Domain Mapping

      Mercator

      是否有 UI

      ✅ 有界面

      ❌ 无界面,代码配置

      是否停更

      ❌ 停止维护

      ✅ 持续更新

      配置难度

      中(有指引)

      稍高(需了解 Hook)

      可扩展性

      高(更现代、适合自定义)

      推荐用途

      老项目维护、可视化管理

      新项目、现代部署场景


      ✅ 总结

      虽然 WordPress MU Domain Mapping 插件已经不再更新,但它仍是一款经典稳定、界面友好、功能完善的独立域名映射方案,适合以下场景:

      • 需要快速部署多站绑定独立域名

      • 管理员希望在后台图形界面添加域名绑定

      • 项目稳定、部署环境兼容 sunrise.php 机制

      • 尚未使用更现代方案的老站迁移或维护

正在查看 0 条回复
  • 在下方一键注册,登录后就可以回复啦。