怎样用脚本自动更换域名？

wen 实用脚本 2026-07-22 2

高效管理多站点部署的终极指南

📖 目录导读

为什么需要自动更换域名？ – 场景与痛点分析
核心原理 – 脚本如何识别与替换域名
实操方案 – 三种主流脚本语言实现方式
关键陷阱 – 替换过程中必须注意的5个细节
常见问题解答 – 处理替换后链接失效、证书问题等
– 自动化域名管理的长期价值

为什么需要自动更换域名？

当你管理多个站点、迁移服务器或频繁更换主域名时，手动在成千上万行代码中逐一修改域名不仅耗时，还极易出错。

怎样用脚本自动更换域名？

数据库中的站点链接
配置文件中的API地址
静态文件中的图片引用
Nginx/Apache虚拟主机配置

手动替换可能遗漏一个http://或https://前缀，导致整个站点部分功能挂掉。脚本自动替换能将这类操作从数小时压缩到几秒，且100%精准。

核心原理：脚本如何识别与替换域名？

自动更换域名的本质是字符串模式匹配与替换，脚本需完成三个步骤：

扫描目标：遍历文件、数据库记录或环境变量
匹配模式：识别所有旧域名的出现位置（包括协议头、路径前缀）
执行替换：将旧域名替换为新域名，同时保持相对路径不变

关键点在于避免误替换——例如把example.com.cn中的example.com部分也换掉，导致域名整段失效。

实操方案：三种主流脚本语言实现方式

方案1：Bash脚本（适用于Linux/Mac系统服务配置）

#!/bin/bash
# 用途：批量替换站点配置文件中的域名
old_domain="old-site.com"
new_domain="new-site.com"
target_dir="/etc/nginx/sites-enabled/"
find "$target_dir" -type f -name "*.conf" | while read file; do
    sed -i "s/${old_domain}/${new_domain}/g" "$file"
done
echo "域名替换完成"

适用场景：服务器配置文件、日志文件内的域名替换。
优点：无需安装额外工具，系统自带命令。
缺点：无法处理数据库字段内的域名。

方案2：Python脚本（万能型，支持数据库与文件）

import os
import re
def replace_domain_in_files(root_dir, old_domain, new_domain):
    # 编码后的域名防止正则特殊字符干扰
    old_escaped = re.escape(old_domain)
    pattern = re.compile(f'({old_escaped})', re.IGNORECASE)
    for dirpath, _, filenames in os.walk(root_dir):
        for fn in filenames:
            if fn.endswith(('.php', '.html', '.js', '.css', '.json')):
                file_path = os.path.join(dirpath, fn)
                with open(file_path, 'r', encoding='utf-8') as f:
                    content = f.read()
                new_content = pattern.sub(new_domain, content)
                if new_content != content:
                    with open(file_path, 'w', encoding='utf-8') as f:
                        f.write(new_content)
                    print(f"已替换 {file_path}")
# 执行替换
replace_domain_in_files('/var/www/html', 'old-site.com', 'new-site.com')

适用场景：网站源码、数据库导出文件、API配置文件。
优点：支持递归遍历、正则灵活过滤、可对接数据库API。
缺点：需要Python环境。

方案3：MySQL SQL脚本（专用于数据库内域名替换）

-- 更新文章内容中的域名
UPDATE wp_posts 
SET post_content = REPLACE(post_content, 'old-site.com', 'new-site.com')
WHERE post_content LIKE '%old-site.com%';
-- 更新用户自定义链接
UPDATE wp_options 
SET option_value = REPLACE(option_value, 'old-site.com', 'new-site.com')
WHERE option_name IN ('siteurl', 'home');

适用场景：WordPress、Discuz等CMS数据库迁移。
优点：直接操作数据库，速度快、无遗漏。
缺点：需备份数据库，误操作可能破坏数据结构。

关键陷阱：替换过程中必须注意的5个细节

协议头差异：http://与https://都需要匹配，有时旧站点混用两种协议
子域名误杀：blog.old-site.com不应该被替换成blog.new-site.com？需明确策略：是否保留子域名
文件编码问题：Windows服务器可能使用GBK编码，脚本指定utf-8会乱码
配置文件语法：替换后若导致Nginx配置语法错误，需重启前先测试：nginx -t
缓存问题：浏览器缓存、CDN缓存、OPcache都会延续旧域名，需清除后验证

避坑技巧：

始终先在测试环境运行脚本
使用diff命令对比替换前后的文件差异
数据库替换时务必先导出备份

常见问题解答

Q1：脚本替换后，部分页面仍然跳转到旧域名怎么办？
A：可能是以下原因：

数据库内的序列化字符串（如WordPress的a:1:{s:4:"url";s:22:"http://..."}）中域名被硬编码，需使用专用序列化替换工具（如WP-CLI的search-replace）
浏览器的预加载HSTS记录,清空浏览器历史或使用隐私模式测试
CDN缓存未清除,需手动刷新边缘节点

Q2：如何处理SSL证书与域名的绑定关系？
A：脚本只负责文本替换，证书必须单独更新：