fix(dev): propagate dev.sh exit status and pull MinIO from pgsty/minio

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.
main
wizardchen 2026-09-26 15:26:09 +08:00 committed by lyingbug
parent 6c83d7ab47
commit 9fcc2c6743
7 changed files with 8 additions and 10 deletions

View File

@ -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

View File

@ -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

View File

@ -429,7 +429,7 @@ minio:
# -- Enable MinIO
enabled: false
image:
repository: quay.io/minio/minio
repository: pgsty/minio
tag: latest
# -- Root user
rootUser: minioadmin

View File

@ -597,5 +597,3 @@ case "$CMD" in
exit 1
;;
esac
exit 0

View File

@ -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 \

View File

@ -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) |

View File

@ -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`(按需单独启动) |