1Panel 常见问题排查思路

6 阅读

经常有同学在使用 1Panel 时碰到问题，不知道怎么排查，本文提供一个思路

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

参考 https://bbs.fit2cloud.com/t/topic/5886/16

如果你需要内网安装
https://1panel.cn/docs/v2/installation/package_installation/

2、系统升级失败

https://bbs.fit2cloud.com/t/topic/5579

3、应用、网站无法访问

  • 查看日志 包括 容器日志，网站日志
  • 检查网络 比如 防火墙 和 安全组
  • 检查网站域名解析 和 反代相关设置

4、PHP 网站 Access denied

这种情况一般是由权限导致的，尝试以下操作：

  • 网站设置-基本-网站目录 《用户和用户组》（默认应为1000：1000 不要修改）点击保存
  • 删除 .user.ini 文件 和 .htaccess 文件
  • 在应用商店-已安装页面 重建 php 应用

如果上述操作不能解决问题，可能是数据库连接或者其他错误，请查看 PHP 容器的日志，或者安装的 PHP 应用的日志

5、网站设置之后页面报错

f3a6b1b5f6b260fe325ae5af32a53465ef64de9d.png
这种情况是 Openresty 返回的错误，是配置文件有误
可以把错误复制 然后粘贴到 百度 Google 必应 的搜索栏，搜索一下，会得到答案

6、Cloudflare 网站 HTTPS 无法访问

  • 在 Cloudflare 中修改证书模式为严格模式
  • 1Panel 导入 Cloudflare 的证书

7、OpenResty 应用状态异常

这种情况一般是 OpenResty 容器异常，可以查看容器日志，并在搜索引擎搜索错误日志

8、安装的应用无法通过 IP：端口访问

  • 查看已安装列表 应用-参数-编辑-高级设置 中的 《端口外部访问》是否勾选，没有的话勾选一下然后点确认
  • 检查云主机安全组是否放开端口
  • 检查应用的容器状态，查看容器日志

9、1Panel 启动失败

查看 1Panel 日志文件 默认日志文件位置 /opt/1panel/log/1Panel.log

10、应用安装失败

报错 ：stat /opt/1panel/apps/redis/redis/docker-compose.yml: no such file or directory

  • 执行 docker-compose version 查看 docker-compose 版本 需要高于 v2.x
  • 查看系统日志 看看是否是应用安装包下载失败
  • Docker 仅支持 systemd 管理的 如果是 snap 安装的，则不支持

11、disk I/O error

查看服务器磁盘的使用情况

12、申请证书失败

目前证书申请用的是第三方 lego 插件 其中的逻辑我们暂时无法更改
目前已知可能会导致失败的原因

  1. ipv6 部分有 ipv6 或者 ipv6 设置打开但是实际没有 ipv6 的机器容易失败，解决方案：禁用 ipv6
  2. 部分有 CNAME 解析的域名会失败 ， 解决方案：申请证书时候勾选禁用 CNAME
  3. 腾讯云机器使用默认的 DNS 类似 127.0.0.53 会导致失败 ，解决方案：申请证书的时候填写公共 DNS 8.8.8.8 或者 114.114.114.114
  4. 部分 DNS 生效时间过长导致超时，解决方案：申请证书时候勾选跳过 DNS 验证

13、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 是否被删除或者清空

14、PHP 镜像 Build 失败

镜像 build 失败:failed to solve: process “/bin/sh -c chmod +x install.sh && sh install.sh

  1. 修改服务器 DNS 为 8.8.8.8 或者 114.114.114.114

15、飞牛 OS 运行环境创建失败

手动安装 docker-compose
参考 https://docs.docker.com/compose/install/standalone/

16、反向代理 1Panel 一直转圈圈

1Panel 不支持除了 / 之外的路径
大部分其他应用也不支持

17、登录成功之后跳转到登录页

由于切换过 http https ，导致前端 cookie 失效，需要清理浏览器 cookie

如果你的问题不在此范围，可以前往官方论坛发帖告诉我们，发帖之前清阅读 https://bbs.fit2cloud.com/t/topic/6395

评论