经常有同学在使用 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、网站设置之后页面报错
这种情况是 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 插件 其中的逻辑我们暂时无法更改
目前已知可能会导致失败的原因
- ipv6 部分有 ipv6 或者 ipv6 设置打开但是实际没有 ipv6 的机器容易失败，解决方案：禁用 ipv6
- 部分有 CNAME 解析的域名会失败 ， 解决方案：申请证书时候勾选禁用 CNAME
- 腾讯云机器使用默认的 DNS 类似 127.0.0.53 会导致失败 ，解决方案：申请证书的时候填写公共 DNS 8.8.8.8 或者 114.114.114.114
- 部分 DNS 生效时间过长导致超时，解决方案：申请证书时候勾选跳过 DNS 验证
13、OpenResty 状态页面报错
- 检查网站是不是添加了 127.0.0.1 的域名，有的话删掉
- 检查 waf 是否增加了 Go-http-client 这个 user-agent 黑名单，有的话删掉
- 检查 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
- 修改服务器 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