1Panel 面板常见问题排查思路：17 个高频场景一篇看完!

用 1Panel 时多多少少都会遇到一些卡住的瞬间——容器拉不下来、网站无法访问、证书申请总是失败……不知道从哪查起，比"问题本身"还更让人头疼。

本文整理了 17 个最常见的故障场景与排查思路，按主题分组归类，方便日常对照查阅。

一、安装与升级

1. Docker 安装失败 / 镜像拉取超时

遇到 Docker 安装报错或镜像拉取超时，参考社区帖子的排查步骤：bbs.fit2cloud.com/t/topic/5886/16。

如果是内网环境，请使用官方提供的离线安装方式：1panel.cn/docs/v2/installation/package_installation/。

2. 系统升级失败

升级遇到问题时，参考社区帖子排查：bbs.fit2cloud.com/t/topic/5579。

二、应用与网站访问

3. 应用、网站无法访问

按以下顺序排查：

• 查看日志：包括容器日志、网站日志；
• 检查网络：服务器防火墙、云服务器安全组是否放行端口；
• 检查域名解析：DNS 是否生效，反向代理设置是否正确。

4. 安装的应用无法通过 IP:端口访问

• 进入 已安装应用 → 参数 → 编辑 → 高级设置，确认是否勾选了"端口外部访问"，未勾选则勾选并保存；
• 检查云主机安全组是否放开对应端口；
• 检查应用容器状态，必要时查看容器日志。

5. 反向代理 1Panel 一直转圈圈

1Panel 自身不支持除 / 之外的路径反代，大部分其他应用也是相同限制。请把 1Panel 部署在独立的子域名上（例如 panel.example.com），而不是放到 example.com/panel 子路径下。

6. 登录成功之后又跳转回登录页

通常由于切换过 http 与 https，导致浏览器中残留旧的 Cookie 失效。清理浏览器 Cookie 后重新登录即可解决。

三、PHP 网站

7. PHP 网站 Access denied

这种情况一般由文件权限导致，依次尝试：

1. 进入 网站设置 → 基本 → 网站目录，检查"用户和用户组"（默认应为 1000:1000，不要修改），点击保存；
2. 删除网站目录下的 .user.ini 和 .htaccess 文件；
3. 到 应用商店 → 已安装，点击重建 PHP 应用。

如果上述操作仍未解决，可能是数据库连接或其他错误，请查看 PHP 容器日志或对应 PHP 应用的日志。

8. PHP 镜像 Build 失败

报错示例：failed to solve: process "/bin/sh -c chmod +x install.sh && sh install.sh"。

原因通常是构建过程网络解析异常。修改服务器 DNS 为 8.8.8.8 或 114.114.114.114 后重试。

四、OpenResty

9. 网站设置后页面报错

这是 OpenResty 返回的错误，说明配置文件有问题。建议把页面提示的错误信息复制下来，直接粘贴到搜索引擎（百度、Google、必应）查找解决方案——绝大多数 OpenResty 错误都能在搜索结果中找到对应处置办法。

10. OpenResty 应用状态异常

一般是 OpenResty 容器本身异常。查看容器日志，复制错误信息搜索引擎检索即可定位原因。

11. OpenResty 状态页面报错

1. 检查网站列表中是否添加了 127.0.0.1 的域名，有的话删除；
2. 检查 WAF 是否将 Go-http-client 加入了 User-Agent 黑名单，有的话移除；
3. 检查 OpenResty 主配置文件是否被删除或清空，路径示例：/opt/1panel/apps/openresty/openresty/conf/conf.d/default.conf。

五、证书相关

12. Cloudflare 站点 HTTPS 无法访问

• 在 Cloudflare 后台将证书模式改为严格 (Full Strict)；
• 在 1Panel 中导入 Cloudflare 提供的证书。

13. 申请证书失败

1Panel 的证书申请由第三方 lego 插件实现，部分逻辑无法直接修改。已知容易失败的原因与解决方案：

1. IPv6 异常：开启了 IPv6 但实际不可达的机器容易失败 → 禁用 IPv6；
2. CNAME 解析：部分 CNAME 域名解析会导致失败 → 申请证书时勾选禁用 CNAME；
3. 本地 DNS 异常：腾讯云等机器的默认 DNS 类似 127.0.0.53，会导致 lego 解析失败 → 申请证书时手动指定公共 DNS（8.8.8.8 或 114.114.114.114）；
4. DNS 生效慢导致超时：部分 DNS 提供商记录传播很慢 → 申请证书时勾选跳过 DNS 验证。

六、1Panel 与基础环境

14. 1Panel 启动失败

查看 1Panel 主日志：默认路径 /opt/1panel/log/1Panel.log。日志会指明启动失败的具体原因。

15. 应用安装失败

典型报错：stat /opt/1panel/apps/redis/redis/docker-compose.yml: no such file or directory。排查步骤：

• 执行 docker-compose version 检查版本，需要 v2.x 及以上；
• 查看系统日志，确认是否是应用安装包下载失败；
• 1Panel 仅支持 systemd 管理的 Docker，snap 安装的 Docker 不受支持。

16. disk I/O error

磁盘读写报错时，第一时间查看服务器磁盘的使用情况（df -h、iostat），通常是磁盘已满或硬件 I/O 异常。

17. 飞牛 OS 运行环境创建失败

飞牛 OS 默认的 Docker Compose 版本不满足 1Panel 要求，需要手动安装独立的 docker-compose：参考 Docker 官方独立安装文档。

没找到你的问题？

如果以上排查思路都不能解决你的情况，可以前往 飞致云社区 发帖向我们求助。发帖之前请先阅读 发帖须知，提供完整的环境信息和报错日志能让响应快很多。