服务器与大带宽专家 · 持牌IDC/CDN/ISP服务商
简米科技官网JIANMI TECH
资讯 2026-11-15 简米科技 3,650 字 9 分钟阅读

lnmp环境下更换域名后需要哪些配置修改?怎么操作,详细步骤

导读LNMP环境下更换域名,至少要同步改三处:Nginx 站点配置里的 server_name 和证书路径、数据库里存着的老域名、以及 CDN、支付回调、定时任务这类外部依赖, 绝大多数“换完域名首页能开、点内页跳回老地址、后台登不上”的故障,问题都出在第二处,LNMP更换域名后需要修改哪些配置文件先给一张对照表……

LNMP环境下更换域名,至少要同步改三处:Nginx 站点配置里的 server_name 和证书路径、数据库里存着的老域名、以及 CDN、支付回调、定时任务这类外部依赖。 绝大多数“换完域名首页能开、点内页跳回老地址、后台登不上”的故障,问题都出在第二处。

LNMP更换域名后需要修改哪些配置文件

先给一张对照表,照着查基本不会漏项。

配置项 常见路径或位置 是否必改
Nginx 站点配置 /usr/local/nginx/conf/vhost/.conf 必改
SSL 证书与私钥路径 同上,ssl_certificate 两条指令 换证书则必改
数据库中的站点地址 wp_options、common_setting 等表 必改
定时任务里的 URL crontab -l 视情况
CDN 回源与缓存 云厂商控制台 视情况

Nginx 配置:server_name、证书、301 跳转

lnmp.org 一键包的站点配置一般在 /usr/local/nginx/conf/vhost/,用 yum 或 apt 装的 Nginx 则多在 /etc/nginx/conf.d/,先全局搜一遍老域名:

grep -rn "old.com" /usr/local/nginx/conf/

把 server_name 改成新域名,多个域名用空格隔开,证书文件通常按域名命名,换域名后 Let's Encrypt 得重新签发:

lnmp ssl add

或者直接用 certbot:certbot --nginx -d new.com -d www.new.com,改完先 nginx -t 验语法,通过后再 systemctl reload nginx,业务不中断。

如果老域名还要继续访问,建议单独加一个 server 块做 301,把权重传过去:

server {
    listen 80;
    server_name old.com www.old.com;
    return 301 https://www.new.com$request_uri;
}

这个跳转建议至少保留三个月,等搜索引擎完成换址识别再撤。

PHP-FPM 与站点参数

PHP-FPM 本身跟域名关系不大,但有两处容易踩坑,一是 pool 配置文件如果按域名命名,改域名后记得同步文件名和引用;二是 php.ini 里的 session.cookie_domain,如果写死了老域名,会出现登录成功但刷新即掉线的情况。

数据库里的老域名是重灾区

主流 CMS 几乎都把站点地址存在数据库里,WordPress 是 wp_options 的 siteurl 和 home,Discuz 是 pre_common_setting,自研 ThinkPHP 站点常见于 config 表,改之前先备份,这是底线:

mysqldump -uroot -p db_name > /root/backup_db_$(date +%F).sql

具体的替换方法见下文专门章节。

缓存与外部依赖

  • Redis:确认只存了本站缓存再执行 flushall,多站点共用实例时慎用
  • OPcache:reload php-fpm 即可清空
  • Nginx fastcgi_cache 目录:直接清空目录内容
  • CDN:更新回源域名,刷新全量缓存
  • 微信支付、支付宝回调地址,第三方登录授权回调,短信模板里的短链
  • crontab -l 里写死域名的采集、推送、备份脚本

业内专家指出,不少“换域名后支付成功但订单状态不更新”的案例,根源就是支付回调地址还指向老域名,网关请求打到了已失效的地址上。

LNMP环境更换域名后网站打不开怎么解决

别急着重装环境,先看日志再动手。

按报错对症下药

  • 403:目录权限不对,或者请求落到了 Nginx 默认站点上
  • 404:伪静态规则里写死了域名,或者站点根目录指向错误
  • 502:PHP-FPM 没起来、socket 路径不匹配,这跟域名无关但常被误判
  • 重定向次数过多:Nginx 里 301 到新域名,数据库里还写着老域名,两边互相打架

日志位置通常在两处:

tail -f /usr/local/nginx/logs/error.log
tail -f /usr/local/php/var/log/php-fpm.log

三条验证命令

curl -I https://new.com
curl -I -H "Host: new.com" http://127.0.0.1
grep -rn "old.com" /usr/local/nginx/conf/ /home/wwwroot/

第二条最关键,它绕开 DNS 直接请求本机,能快速区分是解析没生效还是配置没改对,省去反复等 DNS 缓存的时间。

上线前用 hosts 预演

在本地 hosts 文件里把新域名指向服务器 IP,完整走一遍登录、下单、后台操作,比直接切 DNS 出问题再回滚成本低得多,这个习惯能挡掉大部分低级失误。

WordPress站点换域名数据库批量替换

WordPress 的 options 和 postmeta 里存在序列化数据,直接 UPDATE ... REPLACE 会破坏字段长度标记,表现为页面出现乱码或小工具消失。

wp-cli 一条命令搞定

wp search-replace 'old.com' 'new.com' --all-tables --precise --recurse-objects

正式执行前先加 --dry-run 跑一遍,看清楚会影响多少条记录。--precise 保证按 PHP 序列化规则处理,--recurse-objects 处理嵌套数组。

没装 wp-cli 怎么办

可以导出 SQL 后用文本编辑器全局替换,但只替换域名本身,别碰其他内容,或者用 Better Search Replace 插件,它内部同样做了序列化兼容,替换完清一遍对象缓存,再进后台“设置-常规”确认两个 URL 都是新域名。

宝塔面板LNMP站点更换域名步骤

宝塔用户操作路径短一些,但数据库那一步一样省不掉。

  1. 网站 → 设置 → 域名,添加新域名
  2. 删除老域名,或者保留下来单独做 301
  3. SSL → 重新申请 Let's Encrypt 证书
  4. 打开配置文件,确认 server_name 已同步更新
  5. 按上一节的方法处理数据库
  6. 清缓存,重启 PHP

宝塔的站点配置在 /www/server/panel/vhost/nginx/,跟原生 LNMP 路径不同,改完点保存会自动执行 nginx -t,语法错误会当场提示。

收尾这几项别忘

  • 域名备案信息变更,换域名本身也需要在接入商处更新
  • 百度搜索资源平台重新验证站点,提交改版规则
  • robots.txt 和 sitemap 里的域名替换
  • 统计代码、在线客服代码里的站点标识
  • 站点验证文件,比如百度、必应要求的 HTML 校验文件

行业共识认为,换域名后一段时间内流量有波动属于正常现象,最终能保住多少权重,主要看 301 做得干不干净、老链接是否都能正确跳转。

关于费用:单站点纯配置层面的更换,外包报价通常在几百到一千多元;如果还要处理小程序业务域名、微信支付证书、CDN 全量刷新,价格会往上走,北京、杭州这类建站需求密集的城市,不少服务商已经把这项做成了标准套餐。

换域名的本质是一次站点身份迁移,配置只是表层,数据和外部依赖才是里子,照上面的清单逐项过一遍,再配合本地 hosts 预演,基本能做到切换当天平稳过渡、不影响正常访问。

LNMP更换域名常见问题

LNMP更换域名后老域名还要保留吗

建议保留至少三个月,并配置 301 永久跳转,搜索引擎识别换址需要周期,直接停掉解析等于放弃老站积累的权重,保留期间老域名必须能正常返回跳转,不能是错误页。

只改 Nginx 不改数据库会怎样

典型表现是首页能打开、点击内页跳到老域名、后台登录后自动退出,因为程序读取的站点地址仍是旧的,所有动态生成的链接都指向老域名,一旦老域名解析停用,整站链接就全断了。

LNMP更换域名需要重启服务器吗

不需要重启整机,Nginx 配置改完执行 nginx -t 检查语法,通过后 systemctl reload nginx 即可生效,PHP 侧有改动时 reload php-fpm 就够了,整机重启反而容易暴露开机自启项没配好的问题,平白多出一堆故障点。

分享本文
本文为 简米科技官网 原创,已由运维技术专家审核。转载请注明来源:原文链接
售前咨询 服务热线 售后 邮箱