小白适用 宝塔Linux面板部署ZBlog SSL证书完整实操指南

前置准备检查（避免卡壳必看） 服务器与环境要求 确认你的服务器满足这2个条件： 1. 已安装宝塔Linux面板（推荐7.x或8.x免费版，官网地址：https://www.bt.cn/bbs/thread-1914-1-1.html，按服务器系统选对应一键安装脚本） 2. 已通过宝塔面板搭建好ZBlog PHP版环境（支持Nginx或Apache，推荐Nginx性能更优） 域名与证书要求 确认： 1. 域名（不带www的主域名+带www的二级域名最好都绑定）已完成DNS解析到当前服务器公网IP 2. 已获取SSL证书文件：如果是免费的Let's Encrypt、宝塔自签，或付费的DV/OV/EV证书都可以，文件必须包含cert.pem（证书公钥）、privkey.pem（证书私钥）两个核心文件 步骤一：通过宝塔面板快速获取/上传SSL证书 方式1：免费一键申请Let's Encrypt（有效期90天，自动续期） 这是绝大多数小白的首选，操作简单且永久免费： 1. 登录宝塔面板后台，点击左侧菜单「网站」 2. 找到已搭建好的ZBlog域名对应的站点行，点击右侧「设置」 3. 在弹出的「站点修改」窗口中，切换到「SSL」选项卡 4. 勾选「Let's Encrypt」下方的「主域名」和「带www的域名」（如果解析了其他二级域名也可勾选） 5. 点击底部「申请」按钮，等待3-5秒，提示「申请成功，已部署」即可 6. 关键操作项：勾选SSL选项卡右上角的「强制HTTPS」开关（第一次可能需要等10秒验证证书生效） 方式2：上传已有的付费/自签证书 如果已经从云服务商、CA机构获取了证书文件： 1. 登录宝塔面板后台→左侧「网站」→对应ZBlog站点「设置」→「SSL」选项卡 2. 切换到「其他证书」 3. 打开你下载的证书压缩包，找到以下两类文件内容： - 公钥文件：一般命名为`cert.pem`、`fullchain.pem`、`域名.crt`（推荐优先用`fullchain.pem`，包含完整证书链），用记事本或VS Code打开全选复制内容，粘贴到「证书(PEM格式)」输入框 - 私钥文件：一般命名为`privkey.pem`、`域名.key`，全选复制内容，粘贴到「密钥(KEY)」输入框 4. 点击「保存」按钮，提示「保存成功，已部署」 5. 关键操作项：勾选右上角「强制HTTPS」开关 步骤二：修改ZBlog后台配置（解决浏览器显示不安全锁/混合内容问题） 很多人部署完SSL证书后，浏览器地址栏还是不显示绿色锁，核心原因是ZBlog内部硬编码了HTTP链接，必须做2步修改： 第一步：修改ZBlog全局配置文件 1. 登录宝塔面板后台→左侧「文件」 2. 进入ZBlog安装目录（默认一般是`/www/wwwroot/你的域名/`） 3. 找到`zb_system/defend`文件夹下的`c_option.php`文件，右键点击「编辑」 4. 找到以下两行配置（如果没有就手动添加到最后一行`?>`之前）： ```php $option['ZC_BLOG_HOST'] = 'https://你的完整域名/'; // 注意替换成你的实际域名，结尾必须加斜杠 $option['ZC_PERMANENT_DOMAIN_ENABLE'] = true; // 开启永久域名强制跳转 ``` 5. 点击左上角「保存」按钮 6. 找到网站根目录下的`c_custom.php`文件（如果没有就新建一个），右键点击「编辑」，粘贴以下代码（防止后台登录跳回HTTP）： ```php ``` 7. 点击「保存」 第二步：替换数据库中所有HTTP链接为HTTPS 即使修改了全局配置，之前发布的文章、图片、侧边栏等内容里的HTTP链接还是会导致混合内容错误，必须批量替换： 1. 登录宝塔面板后台→左侧「数据库」 2. 找到ZBlog对应的数据库名，点击右侧「管理」（会自动跳转到phpMyAdmin） 3. 在phpMyAdmin左侧点击选中你的ZBlog数据库 4. 点击顶部菜单「SQL」选项卡 5. 复制以下SQL语句（注意将所有`http://你的旧完整域名`替换成你之前的HTTP完整域名，比如`http://example.com`），粘贴到输入框： ```sql -- 替换文章内容表中的HTTP链接 UPDATE zbp_post SET log_Content = REPLACE(log_Content, 'http://你的旧完整域名', 'https://你的旧完整域名'); -- 替换文章标题、摘要等 UPDATE zbp_post SET log_Title = REPLACE(log_Title, 'http://你的旧完整域名', 'https://你的旧完整域名'); UPDATE zbp_post SET log_Intro = REPLACE(log_Intro, 'http://你的旧完整域名', 'https://你的旧完整域名'); -- 替换附件表中的HTTP链接 UPDATE zbp_attachment SET att_Url = REPLACE(att_Url, 'http://你的旧完整域名', 'https://你的旧完整域名'); UPDATE zbp_attachment SET att_SourceUrl = REPLACE(att_SourceUrl, 'http://你的旧完整域名', 'https://你的旧完整域名'); -- 替换分类表、标签表等 UPDATE zbp_category SET cate_Url = REPLACE(cate_Url, 'http://你的旧完整域名', 'https://你的旧完整域名'); UPDATE zbp_tag SET tag_Url = REPLACE(tag_Url, 'http://你的旧完整域名', 'https://你的旧完整域名'); -- 替换配置表中的可能残留（可选） UPDATE zbp_config SET conf_Value = REPLACE(conf_Value, 'http://你的旧完整域名', 'https://你的旧完整域名'); ``` 6. 点击右下角「执行」按钮，提示「您的 SQL 语句已成功运行」即可 步骤三：修改ZBlog主题/插件中的硬编码HTTP链接（可选但建议） 如果替换完数据库后还是有混合内容错误，大概率是主题或插件里有硬编码的HTTP资源链接： 1. 登录ZBlog后台→左侧「插件管理」→禁用所有第三方插件，刷新前台看看绿色锁是否出现，如果出现，再逐个启用插件排查 2. 排查主题的方法：登录宝塔面板后台→文件→进入`/www/wwwroot/你的域名/zb_users/theme/当前使用的主题名/`，右键点击「搜索」，搜索关键词`http://你的旧完整域名`，找到后手动替换为`https://你的旧完整域名`，保存对应文件 步骤四：验证SSL证书是否完全生效 完成以上所有操作后，做3项验证： 1. 前台验证：用Chrome/Edge浏览器访问你的网站，查看地址栏是否显示绿色小锁+https://，点击小锁→「证书」，确认证书有效期、颁发机构正确 2. 混合内容验证：访问网站的任意文章页、分类页，按F12打开浏览器开发者工具，切换到「Console」选项卡，查看是否有红色的「Mixed Content」错误 3. 跳转验证：访问`http://你的域名`，确认能自动跳转到https://，访问`http://www.你的域名`也能跳转到`https://www.你的域名`（如果是主域名优先的话，也可以配置跳转到不带www的，不过默认是保留原有WWW状态） 常见问题快速解决 问题1：强制HTTPS后网站打不开 - 排查原因：可能是SSL证书没有正确部署，或者强制HTTPS的配置冲突 - 解决方法： 1. 登录宝塔面板后台→网站→对应站点设置→SSL，先取消勾选强制HTTPS 2. 重新检查证书文件是否正确上传/申请 3. 重启Nginx/Apache服务（宝塔面板左侧「软件商店」→找到Nginx/Apache→点击「设置」→「服务」→「重启」） 4. 确认没问题后再勾选强制HTTPS 问题2：数据库批量替换后文章内容乱码 - 排查原因：phpMyAdmin的字符集设置不对，或者SQL语句中的引号使用错误 - 解决方法： 1. 重新进入phpMyAdmin，选中你的ZBlog数据库，点击顶部「操作」选项卡，确认「排序规则」是`utf8mb4_general_ci`（ZBlog PHP版推荐的字符集） 2. 如果使用了中文引号，换成英文引号重新执行SQL语句 3. 如果已经乱码，且有数据库备份，直接在宝塔面板后台→数据库→对应数据库→「导入」导入最新的备份 问题3：Let's Encrypt证书申请失败 - 排查原因：可能是域名DNS解析未生效、服务器防火墙未开放80端口、或者域名被Let's Encrypt拉黑 - 解决方法： 1. 访问站长工具（https://tool.chinaz.com/dns/），输入你的域名，确认全国大部分地区的DNS解析结果都是你的服务器公网IP 2. 登录宝塔面板后台→左侧「安全」，确认80端口（HTTP端口）是放行状态 3. 如果80端口无法放行（比如部分云服务器限制），可以选择「DNS验证」的方式申请Let's Encrypt证书（SSL选项卡→Let's Encrypt→切换到DNS验证，按提示添加TXT解析记录）