From 9fcc2c674309b42a1d4077e6b4c2a2334d49e57c Mon Sep 17 00:00:00 2001 From: wizardchen Date: Sat, 26 Sep 2026 15:26:09 +0800 Subject: [PATCH] fix(dev): propagate dev.sh exit status and pull MinIO from pgsty/minio MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit scripts/dev.sh ended with an unconditional `exit 0`, so a failed `make dev-start` (e.g. an image pull error) printed "服务启动失败" but still reported success to callers and CI. Drop it so the script exits with the status of the dispatched command; help still exits 0, unknown commands 1. MinIO closed anonymous pulls on quay.io on 2026-09-24 (Docker Hub was already gone), so quay.io/minio/minio now answers 401 for every tag and a fresh `dev-start` fails. No registry serves RELEASE.2025-09-07T16-13-09Z anonymously any more. Switch compose and Helm to the community rebuild pgsty/minio, pinning RELEASE.2026-08-04T00-00-00Z where a tag was pinned before, and update the docs that named quay.io. --- docker-compose.dev.yml | 4 ++-- docker-compose.yml | 4 ++-- helm/values.yaml | 2 +- scripts/dev.sh | 2 -- website-docs/01-getting-started/02-installation.md | 2 +- website-docs/01-getting-started/05-troubleshooting.md | 2 +- website-docs/06-development/01-dev-guide.md | 2 +- 7 files changed, 8 insertions(+), 10 deletions(-) diff --git a/docker-compose.dev.yml b/docker-compose.dev.yml index d27830e8..39f9031b 100644 --- a/docker-compose.dev.yml +++ b/docker-compose.dev.yml @@ -82,7 +82,7 @@ services: - full minio: - image: quay.io/minio/minio:latest + image: pgsty/minio:latest container_name: WeKnora-minio-dev ports: - "${MINIO_PORT:-9000}:9000" @@ -438,7 +438,7 @@ services: - full langfuse-minio: - image: quay.io/minio/minio:RELEASE.2025-09-07T16-13-09Z + image: pgsty/minio:RELEASE.2026-08-04T00-00-00Z container_name: WeKnora-langfuse-minio-dev restart: unless-stopped entrypoint: sh diff --git a/docker-compose.yml b/docker-compose.yml index 0aca5247..3d7b50fa 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -614,7 +614,7 @@ services: - full minio: - image: quay.io/minio/minio:RELEASE.2025-09-07T16-13-09Z + image: pgsty/minio:RELEASE.2026-08-04T00-00-00Z container_name: WeKnora-minio ports: - "${MINIO_PORT:-9000}:9000" @@ -868,7 +868,7 @@ services: - full langfuse-minio: - image: quay.io/minio/minio:RELEASE.2025-09-07T16-13-09Z + image: pgsty/minio:RELEASE.2026-08-04T00-00-00Z container_name: WeKnora-langfuse-minio restart: unless-stopped entrypoint: sh diff --git a/helm/values.yaml b/helm/values.yaml index 19c1b853..71583ecc 100644 --- a/helm/values.yaml +++ b/helm/values.yaml @@ -429,7 +429,7 @@ minio: # -- Enable MinIO enabled: false image: - repository: quay.io/minio/minio + repository: pgsty/minio tag: latest # -- Root user rootUser: minioadmin diff --git a/scripts/dev.sh b/scripts/dev.sh index d3836a55..32bfa76c 100755 --- a/scripts/dev.sh +++ b/scripts/dev.sh @@ -597,5 +597,3 @@ case "$CMD" in exit 1 ;; esac - -exit 0 diff --git a/website-docs/01-getting-started/02-installation.md b/website-docs/01-getting-started/02-installation.md index 1f07b344..d2a2588a 100644 --- a/website-docs/01-getting-started/02-installation.md +++ b/website-docs/01-getting-started/02-installation.md @@ -211,7 +211,7 @@ secrets: # 必填项,或用 existingSecret 引用 systemAesKey: "" # 32 字节 AES-256 主密钥 ``` -`global.maxFileSizeMB` 与 Compose 的 `MAX_FILE_SIZE_MB` 含义相同,chart 会把它写入 frontend(Nginx 请求体上限)、app(上传限制)与 docreader(gRPC 消息上限)三处。可选的 MinIO 镜像为 `quay.io/minio/minio`。 +`global.maxFileSizeMB` 与 Compose 的 `MAX_FILE_SIZE_MB` 含义相同,chart 会把它写入 frontend(Nginx 请求体上限)、app(上传限制)与 docreader(gRPC 消息上限)三处。可选的 MinIO 镜像为社区构建的 `pgsty/minio`。 ```bash helm install weknora ./helm -n weknora --create-namespace \ diff --git a/website-docs/01-getting-started/05-troubleshooting.md b/website-docs/01-getting-started/05-troubleshooting.md index 90f3c56e..3c3ba30c 100644 --- a/website-docs/01-getting-started/05-troubleshooting.md +++ b/website-docs/01-getting-started/05-troubleshooting.md @@ -23,7 +23,7 @@ docker compose logs --tail=200 postgres redis | 私网数据源、模型或向量库连接被拒绝 | 检查 SSRF 校验和端口策略;按[配置参考](04-configuration.md)仅放行需要的目标 | | 报错提示「仅允许白名单出站」 | 部署开启了 `SSRF_DNS_WHITELIST_ONLY`,不在白名单的主机在 DNS 解析前即被拒绝。把目标主机加入 `SSRF_WHITELIST` 或 `SSRF_WHITELIST_EXTRA` 后重建 app / docreader 容器,见[配置详解](04-configuration.md) | | 登录接口返回 HTML 404 | 检查 `SEARXNG_PORT` 是否与 `APP_PORT`(默认 8080)相同。Linux 上 SearXNG 绑定 `127.0.0.1:8080` 后,`localhost:8080` 的请求会先到 SearXNG。保持 SearXNG 使用 8888 或其他空闲端口 | -| 拉取 MinIO 镜像提示 `pull access denied` | MinIO 已不再向 Docker Hub 发布镜像。当前 Compose 与 Helm 使用 `quay.io/minio/minio`;自定义编排文件需同步修改镜像地址 | +| 拉取 MinIO 镜像提示 `pull access denied` 或 `401 UNAUTHORIZED` | MinIO 官方已关闭 Docker Hub 与 quay.io 的匿名拉取。当前 Compose 与 Helm 改用社区构建的 `pgsty/minio`;自定义编排文件需同步修改镜像地址 | | 升级后嵌入页面或签名链接失效(嵌入页提示 `embed session signing key is not configured`,启动日志有 `[startup-env] no usable signing key`) | 签名密钥取 `SYSTEM_SIGNING_KEY`,未设置时回退到 `SYSTEM_AES_KEY`;示例密钥和长度不足 16 的密钥不能签名。用 `openssl rand -hex 32` 生成并配置 `SYSTEM_SIGNING_KEY` 即可,**不要为此修改 `SYSTEM_AES_KEY`**,否则已保存的凭据无法解密。v0.8.2 更换了嵌入会话的签名算法,升级前签发的嵌入会话全部失效,访客需重新进入;多副本部署须使用同一个密钥 | | 升级后钉钉机器人不再回复 | v0.8.2 起钉钉只支持 Stream 模式,升级迁移会把 `webhook` 渠道改为 `websocket`。需在钉钉开发者后台为该应用开启 Stream 模式,见[IM 集成](../03-features/12-im-integration.md) | | 后台队列持续积压 | 结合最老任务等待时间、活跃 worker 和下游配额定位;提高 worker 数不会增加模型供应商配额,见[容量估算](../02-architecture/05-async-tasks.md#capacity-planning) | diff --git a/website-docs/06-development/01-dev-guide.md b/website-docs/06-development/01-dev-guide.md index 902dc9c6..296f3bef 100644 --- a/website-docs/06-development/01-dev-guide.md +++ b/website-docs/06-development/01-dev-guide.md @@ -68,7 +68,7 @@ make dev-restart # 重启 | `redis` | `redis:7.0-alpine`(`--requirepass`) | `6379` | 默认启动 | | `docreader` | 本地构建 `docker/Dockerfile.docreader` | `50051`(gRPC) | 默认启动 | | `searxng`(+`searxng-init`) | `searxng/searxng:latest` | `127.0.0.1:8888` | `--searxng` / `--full`(compose profile `searxng`) | -| `minio` | `quay.io/minio/minio:latest` | `9000` / 控制台 `9001` | `--minio` / `--full` | +| `minio` | `pgsty/minio:latest` | `9000` / 控制台 `9001` | `--minio` / `--full` | | `qdrant` | `qdrant/qdrant:v1.16.2` | `6333` / `6334` | `--qdrant` / `--full` | | `opensearch` | `opensearchproject/opensearch:3.3.2`(关闭 security,纯 HTTP) | `9200` | profile `opensearch` / `full` | | `opensearch-dashboards` | `opensearchproject/opensearch-dashboards:3.3.0` | `5601` | profile `opensearch-ui`(按需单独启动) |