迁移前准备

宝塔面板虽然简化了服务器管理，但Windows与Linux在文件系统、权限、软件环境上存在本质差异。直接拷贝文件往往导致网站无法运行。迁移前务必在Windows面板中备份所有网站文件、数据库和站点配置，并记录当前使用的PHP版本、MySQL版本及已安装的PHP扩展。

网站文件迁移

将Windows服务器上的网站目录（例如 D:/wwwroot/你的站点）打包，通过宝塔备份功能或FTP上传到Linux服务器对应路径，通常为 /www/wwwroot/。注意保持目录结构完整，并确认上传后的文件归属为 www 用户。

权限设置

Linux对文件权限敏感，执行以下命令设置标准权限：

1. 目录权限：chmod -R 755 /www/wwwroot/你的站点
2. 文件权限：chmod -R 644 /www/wwwroot/你的站点/*.php
3. 属主属组：chown -R www:www /www/wwwroot/你的站点

数据库迁移

在Windows宝塔中导出数据库为SQL文件，然后在Linux宝塔面板中创建同名数据库及同权限用户，导入SQL。注意核对字符集，建议统一使用 utf8mb4，避免中文乱码。

配置适配与修复

路径和伪静态

站点配置文件（Nginx或Apache）中的root路径必须改为Linux绝对路径，例如 /www/wwwroot/你的站点。Windows下的 .htaccess 规则在Nginx下不生效，需在宝塔“伪静态”功能中重新配置，或手动转换规则。

PHP扩展差异

Windows下的PHP扩展如 php_curl.dll、php_mbstring.dll 在Linux中需通过宝塔软件商店安装对应扩展包（如 curl、mbstring）。建议在“软件商店”中安装与源环境版本一致或更高的PHP，并勾选所需扩展。

文件编码与换行符

Windows下文件常使用GBK编码和CRLF换行符，可能引发PHP解析错误或页面乱码。使用命令行工具统一转换：

• 换行符转换：find /www/wwwroot/你的站点 -type f -exec dos2unix {} \;
• 编码转换：iconv -f GBK -t UTF-8 原始文件 -o 新文件（建议在编辑器中进行，避免误操作）

常见问题排查

白屏或500错误

打开宝塔终端，查看PHP错误日志（默认位于 /www/server/php/版本号/var/log）。若未开启显示错误，可在站点配置中设置 display_errors = On 临时调试。

数据库连接失败

确认数据库用户是否允许远程访问、密码是否正确，以及Linux防火墙和阿里云/腾讯云安全组是否放行3306端口（如需远程连接）。

伪静态404

检查Nginx配置中的 rewrite 规则是否完整，或在宝塔“网站管理”中重新选择对应程序的伪静态模板。

验证与上线

完成迁移后，先修改本地hosts文件测试网站，重点检查页面访问、数据中心列表、后台登录、文件上传等功能。确认无报错后，将域名解析至新服务器，并确保旧服务器停止服务，避免数据冲突。