企业官网建设流程全解析

1Panel装OpenResty拉镜像失败？3步修好

【免费下载链接】1Panel新一代的 Linux 服务器运维管理面板项目地址: https://gitcode.com/feizhiyun/1Panel

1Panel 里装 OpenResty，装到一半直接断，docker 日志翻了三遍，只看到pull access denied，或者一直卡在Downloading layer不动。别慌，大概率是镜像源的问题，不是 OpenResty 本身配错了。本文覆盖 1Panel 应用商店部署 OpenResty 的 Docker 环境，amd64 和 aarch64 都适用；宿主机裸装 OpenResty 的不适用。

先对号入座：OpenResty 拉镜像失败的 3 类表现

• 任务卡在"拉取镜像"，转圈几十秒后超时→ 默认 Docker Hub 直连不稳，国内网络最常见
• 报错pull access denied for 1panel/openresty→ 镜像名/tag 对不上，或走错源
• 重装后提示"容器未创建"，但应用目录还在→ 上次失败留下残留，compose 没跑完
• ⚠️aarch64 设备必挂、x86 正常→ 该 tag 没推 arm64 镜像，换个带架构后缀的 tag 再试

对号入座完再动手，别一上来就强制卸载。

修复顺序：清残留 → 加镜像源 → 手动拉镜像

清掉残留安装

上次失败的安装会留在/opt/1panel/apps/openresty/下，目录不清掉，新任务会读旧 compose 直接报错。

🔧 面板操作：【应用管理】→【已安装】→ OpenResty → 强制卸载。卸载后 SSH 里确认目录已清空：

ls /opt/1panel/apps/openresty/ 2>/dev/null && echo "有残留" || echo "干净"

看到干净，这步就过了。

加国内镜像加速源

Docker 拉1panel/openresty走的是 daemon 级registry-mirrors，没配就直连 Docker Hub，国内基本拉不动。

🔧 面板操作：【主机】→【设置】→ Docker → 镜像加速，填入国内加速地址（阿里云、腾讯云镜像站），保存后 1Panel 会自动重写 daemon.json 并重启 Docker。验证是否生效：

docker info | grep -A3 "Registry Mirrors"

输出里出现你填的加速地址，说明源已经写进去了。

手动拉取镜像再装

说白了，面板安装本质就是一条docker pull，它失败是静默的，手动拉一次进度和错误都看得见，别再靠面板日志猜。镜像名和 tag 以【应用商店】里 OpenResty 详情显示、或任务日志中完整 pull 行为准，原样复制：

docker pull 1panel/openresty:<tag> docker images | grep openresty

第二条命令能列出本地镜像 = 网络这条路通了。回面板【应用商店】重装 OpenResty，这次装的过程直接走本地镜像，不会再卡。

验证 OpenResty 装好的 3 个信号，以及防再犯

✅ 应用状态显示"已启动"，容器Up✅ 进容器执行nginx -t，返回syntax is ok✅ 面板【网站】能新建站点并正常访问

如果还是不对，回到第②段第 3 条，九成是残留没清干净。

防再犯，就两条：

• 先拉镜像再装应用：面板安装是静默失败，养成先手动docker pull验证网络的习惯，能省掉一半排障时间
• daemon.json 别手动改：镜像加速走 1Panel 的【镜像加速】入口，它会自动处理 Docker 重启；手动改容易把registry-mirrors和其他配置打架

1Panel 部署 OpenResty 装不上，基本就这两类原因：网络拉不动镜像，或者残留没清干净。如果是另一种报错，贴出来一起看。

【免费下载链接】1Panel新一代的 Linux 服务器运维管理面板项目地址: https://gitcode.com/feizhiyun/1Panel