经常有同学在使用 1Panel 时碰到问题，不知道怎么排查，本文提供一个思路
1、Docker 安装失败 镜像拉取超时
如果你碰到 Docker 安装失败的问题 ， 可以使用离线包安装
如果你碰到镜像拉取超时的问题 请参考https://bbs.fit2cloud.com/t/topic/5886/16
2、系统升级失败
问题描述：
升级过程中出现错误，导致服务不可用
解决办法：
1pctl restore // 尝试回滚。
问题描述：
点击检测升级无法获取到最新版本。
解决办法：
先确认是否最新版本为 beta 版本，beta 版本需要在面板设置中 启用预览体验计划 ，才能正常获取到版本升级。
如果是 lts 版本无法正常获取，可以尝试下面方法：
wget https:/…
3、应用、网站无法访问
查看日志 包括 容器日志，网站日志
检查网络 比如 防火墙 和 安全组
检查网站域名解析 和 反代相关设置
4、PHP 网站 Access denied
这种情况一般是由权限导致的，尝试以下操作：
网站设置-基本-网站目录 《用户和用户组》（默认应为1000：1000 不要修改）点击保存
删除 .user.ini 文件 和 .htaccess 文件
在应用商店-已安装页面 重建 php 应用
如果上述操作不能解决问题，可能是数据库连接或者其他错误，请查看 PHP 容器的日志，或者安装的 PHP 应用的日志
5、网站设置之后页面报错
这种情况是 Openresty 返回的错误，是配置文件有误
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
如果你的问题不在此范围，可以发帖告诉我们，发帖之前清阅读 1Panel 提问指南 凌霞软件
2 个赞
安装的应用无法通过 IP：端口访问
查看已安装列表 应用-参数-编辑-高级设置 中的 《端口外部访问》是否勾选，没有的话勾选一下然后点确认
检查云主机安全组是否放开端口
检查应用的容器状态，查看容器日志
找不到参数-编辑-高级设置 中的 《端口外部访问》這個路徑version 1.4.3
kidd
2023 年10 月 13 日 09:21
7
stderr: Container 1Panel-halo-U8td Creating Container 1Panel-halo-U8td Created Container 1Panel-halo-U8td Starting Error response from daemon: driver failed programming external connectivity on endpoint 1Panel-halo-U8td (1286fd4c35aa4e39c22e79166edee6a64843a90a3b6764f22e0152f9e6f6d7a5): Error starting userland proxy: listen tcp4 127.0.0.1:8080: bind: cannot assign requested address
这是halo没勾外部访问
stderr: Container 1Panel-mariadb-TSor Creating Container 1Panel-mariadb-TSor Created Container 1Panel-mariadb-TSor Starting Error response from daemon: driver failed programming external connectivity on endpoint 1Panel-mariadb-TSor (8747327678d3fb5cf4f59c102f40e89538f6baa130ef8e318542bbba18200b5b): Error starting userland proxy: listen tcp4 127.0.0.1:3306: bind: cannot assign requested address
这是mariadb 全默认不点端口外部访问
1 个赞
1Panel-huiwan:
6、安装的应用无法通过 IP：端口访问
查看已安装列表 应用-参数-编辑-高级设置 中的 《端口外部访问》是否勾选，没有的话勾选一下然后点确认
检查云主机安全组是否放开端口
检查应用的容器状态，查看容器日志
这三点都排查了确认没问题，但是还是无法通过 IP:端口 的形式访问应用
问题已解决。应用的默认网络用的是 1-panel-network ，切换成 host 或者 bridge 后就能访问了。
不知道 1-panel-network 出了什么问题，无法外网访问。但今天早上重新试了一下，又可以了…玄学
1 个赞
有些问题不是 1Panel 可以解决的
[1Panel Log]: 启动 1Panel 服务
Sep 30 03:18:48 l685588 systemd[1]: 1panel.service: Deactivated successfully.
这个是啥问题
