1Panel 问题排查思路

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

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

如果你碰到 Docker 安装失败的问题 ， 可以使用离线包安装

如果你碰到镜像拉取超时的问题 请参考
https://bbs.fit2cloud.com/t/topic/5886/16

2、系统升级失败

3、应用、网站无法访问

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

4、PHP 网站 Access denied

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

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

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

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

Pasted image 202307211554341043×482 35.8 KB

这种情况是 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

如果你的问题不在此范围，可以发帖告诉我们，发帖之前清阅读 1Panel 提问指南
1Panel 永久折扣优惠链接 凌霞软件

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

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

找不到参数-编辑-高级设置 中的 《端口外部访问》這個路徑version 1.4.3

PHP 和 openresty 没有这个设置

数据库这些不想开启外部访问的。。安装会报错。。

贴一下错误日志。

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 全默认不点端口外部访问

应用安装出现以下问题

image952×536 132 KB

重启 docker 即可解决

这三点都排查了确认没问题，但是还是无法通过 IP:端口 的形式访问应用

看一下端口是否正常提供服务

问题已解决。应用的默认网络用的是 1-panel-network ，切换成 host 或者 bridge 后就能访问了。

不知道 1-panel-network 出了什么问题，无法外网访问。但今天早上重新试了一下，又可以了…玄学

可以登陆，但是进去了提示这个

这都没有解决的吗？
全靠自己摸索

有些问题不是 1Panel 可以解决的
有些问题我们会优化

常见问题都在这了，牛。

飞牛OS系统 安装后无法访问

[1Panel Log]: 启动 1Panel 服务
[1Panel Log]: 1Panel 服务启动成功!
● 1panel.service - 1Panel, a modern open source linux panel
Loaded: loaded (/etc/systemd/system/1panel.service; enabled; vendor preset: enabl> Active: active (running) since Mon 2024-09-30 03:18:48 UTC; 15ms ago
Main PID: 2402 (1panel)
Tasks: 3 (limit: 2301)
Memory: 1.0M
CPU: 3ms
CGroup: /system.slice/1panel.service
└─2402 /usr/bin/1panel

Sep 30 03:18:48 l685588 systemd[1]: 1panel.service: Deactivated successfully.
Sep 30 03:18:48 l685588 systemd[1]: Stopped 1Panel, a modern open source linux panel.
Sep 30 03:18:48 l685588 systemd[1]: Started 1Panel, a modern open source linux panel.

这个是啥问题