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站点更换域名步骤
宝塔用户操作路径短一些,但数据库那一步一样省不掉。
- 网站 → 设置 → 域名,添加新域名
- 删除老域名,或者保留下来单独做 301
- SSL → 重新申请 Let's Encrypt 证书
- 打开配置文件,确认 server_name 已同步更新
- 按上一节的方法处理数据库
- 清缓存,重启 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 就够了,整机重启反而容易暴露开机自启项没配好的问题,平白多出一堆故障点。