跟着网上宝塔教程搭建网站,很多人卡在半路上,教程只教怎么点,不讲报错怎么处理。我整理了自己实操遇到最多的问题,附带排查顺序 + 命令,新手可以对照自查,少重装几次服务器。环境:Linux(CentOS7 / Ubuntu20.04),宝塔正式版
一、安装阶段问题1. 宝塔安装命令跑一半失败、中断、下载超时现象:执行安装脚本,卡在下载依赖、一直超时,提示网络失败。原因:服务器 DNS 异常、无法访问宝塔下载源、系统不是纯净镜像、系统自带 yum/apt 锁占用。解决:
- 优先重装服务器系统,选择官方纯净版,不要用预装 LNMP、其他面板的系统;
- 先测试网络:
ping bt.cn丢包就是服务器外网不通,先找服务商排查网络;3. Ubuntu 提示 apt 锁:等自动结束,或者不要强制 kill;4. 换安装脚本,安装前切换 root 用户:sudo -i
提醒:轻量服务器很多默认不是 root,直接跑脚本会权限不足,先切 root!
2. 安装完成,复制地址打不开面板(最高频坑)很多新手以为放行宝塔防火墙就完事,云服务器安全组和宝塔防火墙是两层!排查顺序:
bt 14- 先去云服务商后台(阿里云 / 腾讯云 / 华为云)安全组放行面板端口;
- 再到宝塔面板【安全】里放行端口;
- 重启面板服务:
bt restartbt status重点:新版宝塔默认带安全入口,地址末尾带一串随机字符,少了这个路径直接 404,提示安全入口校验失败。忘记安全入口:bt 14 可以查到完整登录链接。
二、登录面板后常见报错3. 提示:请使用正确的入口登录面板原因:安全入口丢失、直接访问 IP: 端口,没带安全路径。修复:
bt 14复制返回的完整链接访问;如果想关闭安全入口(不推荐,降低安全):面板设置→安全设置关闭安全入口。
4. 面板可以登录,网站打不开(80/443 访问超时)排查顺序:
- 安全组放行 80、443;
- 宝塔安全放行 80、443;
- 检查 Nginx/Apache 是否启动:软件商店找到 Nginx,看状态,点重启;
bt nginx restart- 域名解析是否生效:ping 域名看 IP 是否是服务器 IP;
- 国内域名:没有备案,服务商拦截 80/443 端口,打不开属于正常。
5. 网站打开 403 Forbidden(权限问题)现象:能访问域名,页面 403。常见:网站目录权限不对、运行用户不匹配、缺少首页文件。解决:网站→设置→目录权限,一般设置:目录 755,文件 644;运行用户 www;不要直接给 777,安全风险很大。
6. SSL 证书申请成功,HTTPS 打不开、证书不安全踩坑点:
- 证书部署后,网站配置没有强制 HTTPS;
- 80 端口没放行,ACME 验证失败,证书申请失败;
- 网站内还有 http 图片 / 资源(混合内容,浏览器报不安全);
- 解析多条 CDN、代理,证书绑错节点。操作建议:申请证书前确认解析生效;部署后开启【强制 HTTPS】;检查网站程序内静态资源链接。
7. PHP 扩展安装失败、安装 PHP 报错依赖缺失现象:软件商店安装 PHP、Redis、SG11 扩展提示编译失败。原因:系统缺少底层依赖源、系统版本太新 / 太旧不兼容。方案:
- 优先选宝塔推荐兼容版本,不要追最新 PHP;
- CentOS:先更新源;Ubuntu:更新 apt;
- 看报错日志,很多是缺少 lib 库,论坛搜对应报错关键词。
8. 磁盘满了!面板操作卡顿、网站 500、备份失败现象:文件管理器上传报错、备份任务失败、面板点不动。查看占用:面板首页磁盘使用率;清理方向:
- 网站日志:Nginx 日志长期堆积;
- 旧备份包、安装包、缓存;
- MySQL binlog 日志(数据库大机器很容易爆盘);清理前记得备份重要数据。
三、数据库相关问题9. MySQL 启动失败、数据库连不上排查:
- 磁盘 100% 满会直接导致 MySQL 无法启动;
- 内存太小,MySQL 被 OOM 杀死;
- my.cnf 配置参数写太大,内存扛不住;命令:
bt mysql restart看返回报错,根据日志定位。
10. phpMyAdmin 打不开常见:phpmyadmin 对应的 PHP 版本不匹配;3306 端口限制;安全入口拦截。解决:更换兼容 PHP 版本,不要用过高 PHP。
四、安全相关避坑(很多教程不提)- 不要长期用默认面板端口,装好第一件事修改面板端口,开启 BasicAuth 认证二次验证;
- 不要随意放行 22 端口全网访问,SSH 建议限制 IP;
- 定期修改面板账号密码;
- 不要随便网上复制未知脚本到服务器终端执行。
五、通用排查万能流程(遇到报错先按这个走)- 先看服务器资源:CPU、内存、磁盘是否跑满;
- 网络:安全组→宝塔防火墙,两层端口都检查;
- 服务状态:Nginx / MySQL / PHP 是否正常运行;
- 看日志:Nginx 错误日志、网站日志、面板日志;
- 复制完整报错文字,去宝塔论坛搜索,绝大多数问题别人遇到过。
六、提问求助模板(发帖求助直接复制,方便别人帮你)系统:CentOS7 / Ubuntu20.04宝塔版本:问题现象:报错截图 / 报错文字:已经做过的排查:服务器厂商:阿里云 / 腾讯云轻量
结尾网上很多宝塔教程属于 “理想环境教程”,环境不一样就各种翻车。如果你遇到别的奇怪报错,可以在楼下留言,带上报错信息,大家一起交流踩坑经验。
|
|