From 13568a83b756480e67d24fc4e78ac79b64e1a35b Mon Sep 17 00:00:00 2001 From: Gloridust Date: Sun, 14 Jun 2026 00:03:16 +0800 Subject: [PATCH] =?UTF-8?q?docs(readme):=20=E5=A4=87=E6=B3=A8=20NAS/?= =?UTF-8?q?=E9=A3=9E=E7=89=9B=E9=A6=96=E6=AC=A1=E5=BB=BA=E5=AE=9E=E4=BE=8B?= =?UTF-8?q?=E9=95=9C=E5=83=8F=E6=8B=89=E5=8F=96=E8=B6=85=E6=97=B6=E7=9A=84?= =?UTF-8?q?=E8=A7=A3=E6=B3=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit NAS 自带的 Docker Hub 加速通常只覆盖界面手动拉取，不覆盖面板经 docker.sock 触发的拉取， 导致首次新建实例直连 registry-1.docker.io 超时。README 快速开始加提示：先手动拉一次 gloridust/wechat-on-cloud:latest（本地有了面板就复用不再联网），或配守护进程镜像加速 / 换 WOC_IMAGE_PREFIX 到国内源。 Co-Authored-By: Claude Opus 4.8 --- README.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/README.md b/README.md index 025da2c..bca1ecf 100644 --- a/README.md +++ b/README.md @@ -120,6 +120,11 @@ docker compose up -d # compose 默认优先用本地镜像，不会 之后被授权的用户换任意设备打开同一地址登录面板，看到自己有权访问的实例，进入即是**同一个**微信会话。 +> **🛠️ NAS / 飞牛(fnOS) 用户必看——首次新建实例若卡住报 `创建容器失败：… registry-1.docker.io … timeout`**： +> 这是 Docker **守护进程**拉取微信镜像超时。NAS 自带的「Docker Hub 加速」一般只作用于你在 NAS 界面**手动拉镜像**，不覆盖面板（经 docker.sock）触发的拉取，于是直连 `docker.io` 超时。 +> **最省事的解法**：先在 NAS 的 **Docker → 镜像 → 拉取** 里手动拉一次 `gloridust/wechat-on-cloud:latest`（和你拉 `woc-panel` 同样的方式）。镜像到本地后，面板新建实例会直接复用、不再联网拉取 → 立即成功。 +> 想一劳永逸：给 Docker 守护进程配「镜像加速器」（`/etc/docker/daemon.json` 的 `registry-mirrors`，改完重启 Docker），或把 `WOC_IMAGE_PREFIX` 换成国内可达源（如 `ghcr.nju.edu.cn/gloridust`）后重建面板。 + > 宿主只对外暴露面板的 `36080` 一个端口；微信实例容器仅在 docker 网络内、由面板反代，不直连宿主。要改端口/版本/账号见 `.env`（可配置项见 [.env.example](.env.example)）。镜像会按 CPU 架构自动适配（[详见文档](doc/运行原理.md#架构自动适配)）。 ### 面板能做什么