Skip to content

Open-source LLM knowledge platform: turn raw documents into a queryable RAG, an autonomous reasoning agent, and a self-maintaining Wiki.

feat: support app and docreader build download mirrors (#4073)

LL_Ricky602d0c388bf1
diff --git a/.env.example b/.env.example
index d2a304a2c..cd0d6fe8f 100644
--- a/.env.example
+++ b/.env.example
@@ -32,12 +32,16 @@
# ========== A1. 镜像版本与构建 ==========
# WeKnora 镜像版本标签:latest(稳定版)/ main(最新开发版)。升级到固定版本时,请填写目标 release 的 git tag(如 v0.7.0,注意 v 前缀),并执行 docker compose pull 拉取对应镜像。
WEKNORA_VERSION=latest
-# Alpine apk 镜像源(构建 app 镜像用,留空用默认源;国内可设 mirrors.tencent.com 加速)。
+# Debian APT 镜像源主机名(构建 app 镜像用,留空用默认源;国内可设 mirrors.tencent.com 加速)。
APK_MIRROR_ARG=mirrors.tencent.com
# 构建 app 镜像时是否链接 anydoc 进程内解析引擎(默认 1)。设 0 可跳过 Rust 工具链、缩短构建时间,引擎在设置页显示为不可用。
# WITH_ANYDOC=1
# docreader 镜像构建时 apt 镜像源(留空用默认源)。
# APT_MIRROR=
+# docreader 镜像构建时 Playwright 浏览器制品源(留空用官方 CDN)。
+# PLAYWRIGHT_DOWNLOAD_HOST=
+# 仅覆盖 WebKit 制品源,设置后优先于 PLAYWRIGHT_DOWNLOAD_HOST。
+# PLAYWRIGHT_WEBKIT_DOWNLOAD_HOST=
# 从源码构建 frontend 镜像时写入系统信息页的短 commit。make docker-build-frontend
# 与 start_all.sh --no-pull 会从 git 自动填充;直接 docker compose build 时请自行导出,否则显示 unknown。
# VITE_FRONTEND_COMMIT=
diff --git a/docker-compose.yml b/docker-compose.yml
index 68e3ba00d..a46fb2523 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -419,6 +419,8 @@ services:
dockerfile: docker/Dockerfile.docreader
args:
- APT_MIRROR=${APT_MIRROR:-}
+ - PLAYWRIGHT_DOWNLOAD_HOST=${PLAYWRIGHT_DOWNLOAD_HOST:-}
+ - PLAYWRIGHT_WEBKIT_DOWNLOAD_HOST=${PLAYWRIGHT_WEBKIT_DOWNLOAD_HOST:-}
container_name: WeKnora-docreader
# docreader gRPC ships without auth/TLS and is only consumed by the app
# container over the WeKnora-network (DOCREADER_ADDR defaults to
diff --git a/docker/Dockerfile.app b/docker/Dockerfile.app
index 21a272928..eb92daf72 100644
--- a/docker/Dockerfile.app
+++ b/docker/Dockerfile.app
@@ -1,7 +1,12 @@
# Build extension and daemon from the same pinned source on the runtime architecture.
FROM --platform=$TARGETPLATFORM node:24-bookworm-slim@sha256:ba849c60be29959425b8734d57b8b4b7d56f98edd9504c9af091d5281095a71e AS browserskill
WORKDIR /build
-RUN apt-get update && \
+# Use the same optional Debian mirror as the Go builder and runtime stages.
+ARG APK_MIRROR_ARG
+RUN if [ -n "$APK_MIRROR_ARG" ]; then \
+ sed -i "[email protected]@${APK_MIRROR_ARG}@g" /etc/apt/sources.list.d/debian.sources; \
+ fi && \
+ apt-get update && \
apt-get install -y --no-install-recommends git python3 ca-certificates curl build-essential cmake pkg-config && \
rm -rf /var/lib/apt/lists/*
ENV RUSTUP_HOME=/usr/local/rustup CARGO_HOME=/usr/local/cargo
diff --git a/docker/Dockerfile.docreader b/docker/Dockerfile.docreader
index f858c058b..7a49103f0 100644
--- a/docker/Dockerfile.docreader
+++ b/docker/Dockerfile.docreader
@@ -142,8 +142,16 @@ ENV PATH="${VIRTUAL_ENV}/bin:${PATH}"
COPY --from=builder /usr/local/bin /usr/local/bin
-# 安装 Playwright 浏览器(网页解析)
-RUN python -m playwright install webkit
+# 安装 Playwright 浏览器(网页解析)。可在构建时切换为内部制品库或镜像源。
+ARG PLAYWRIGHT_DOWNLOAD_HOST=""
+ARG PLAYWRIGHT_WEBKIT_DOWNLOAD_HOST=""
+RUN if [ -n "$PLAYWRIGHT_WEBKIT_DOWNLOAD_HOST" ]; then \
+ PLAYWRIGHT_WEBKIT_DOWNLOAD_HOST="$PLAYWRIGHT_WEBKIT_DOWNLOAD_HOST" python -m playwright install webkit; \
+ elif [ -n "$PLAYWRIGHT_DOWNLOAD_HOST" ]; then \
+ PLAYWRIGHT_DOWNLOAD_HOST="$PLAYWRIGHT_DOWNLOAD_HOST" python -m playwright install webkit; \
+ else \
+ python -m playwright install webkit; \
+ fi
RUN python -m playwright install-deps webkit
COPY docreader/pyproject.toml docreader/uv.lock ./
diff --git a/scripts/build_images.sh b/scripts/build_images.sh
index f500b61bd..7f95d52a4 100755
--- a/scripts/build_images.sh
+++ b/scripts/build_images.sh
@@ -141,6 +141,7 @@ build_app_image() {
--build-arg GOPRIVATE_ARG=${GOPRIVATE:-""} \
--build-arg GOPROXY_ARG=${GOPROXY:-"https://goproxy.cn,direct"} \
--build-arg GOSUMDB_ARG=${GOSUMDB:-"off"} \
+ --build-arg APK_MIRROR_ARG="${APK_MIRROR_ARG:-}" \
--build-arg VERSION_ARG="$VERSION" \
--build-arg COMMIT_ID_ARG="$COMMIT_ID" \
--build-arg BUILD_TIME_ARG="$BUILD_TIME" \
@@ -169,7 +170,9 @@ build_docreader_image() {
--platform $PLATFORM \
--build-arg PLATFORM=$PLATFORM \
--build-arg TARGETARCH=$TARGETARCH \
- --build-arg APT_MIRROR=${APT_MIRROR:-} \
+ --build-arg APT_MIRROR="${APT_MIRROR:-}" \
+ --build-arg PLAYWRIGHT_DOWNLOAD_HOST="${PLAYWRIGHT_DOWNLOAD_HOST:-}" \
+ --build-arg PLAYWRIGHT_WEBKIT_DOWNLOAD_HOST="${PLAYWRIGHT_WEBKIT_DOWNLOAD_HOST:-}" \
-f docker/Dockerfile.docreader \
-t wechatopenai/weknora-docreader:latest \
.
diff --git a/website-docs/01-getting-started/02-installation.md b/website-docs/01-getting-started/02-installation.md
index d2a2588a2..ca86f3ab5 100644
--- a/website-docs/01-getting-started/02-installation.md
+++ b/website-docs/01-getting-started/02-installation.md
@@ -133,7 +133,7 @@ make dev-logs / dev-status / dev-stop / dev-restart
| Dockerfile | 产物镜像 | 要点 |
| --- | --- | --- |
| `docker/Dockerfile.app` | `wechatopenai/weknora-app` | 三阶段:先构建 BrowserSkill 的 `bsk` 与配套 Chrome 扩展(装入 `/opt/weknora/browserskill/`,见[本机浏览器](../05-clients/09-local-browser.md));再用 `golang:1.26-bookworm` 编译(`make build-prod`,默认 `WITH_ANYDOC=1` 链接进程内 office 解析引擎,注入版本信息,预下载 DuckDB 扩展 `cmd/download/duckdb`)→ `debian:12.12-slim` 运行层(含 `migrate` 迁移工具、python3/node/uvx(供 stdio MCP 使用)、ffmpeg(ASR)、gosu 降权,以及第三方许可证文本)。入口 `scripts/docker-entrypoint.sh`:修复挂载目录属主;若挂载了 docker.sock,按 socket GID 把 appuser 加入对应组(compose `group_add` 在 gosu 后无效),再以 appuser 运行 `./WeKnora`。`EXPOSE 8080` |
-| `docker/Dockerfile.docreader` | `wechatopenai/weknora-docreader` | Python 3.10 + uv 依赖锁定;生成 protobuf;运行层安装 LibreOffice、OpenJDK 17、antiword、Playwright(webkit)与 `grpc_health_probe`。轻量版不含 PaddleOCR。`EXPOSE 50051`。支持 `APT_MIRROR` 构建参数 |
+| `docker/Dockerfile.docreader` | `wechatopenai/weknora-docreader` | Python 3.10 + uv 依赖锁定;生成 protobuf;运行层安装 LibreOffice、OpenJDK 17、antiword、Playwright(webkit)与 `grpc_health_probe`。轻量版不含 PaddleOCR。`EXPOSE 50051`。支持 `APT_MIRROR`、`PLAYWRIGHT_DOWNLOAD_HOST` 和 `PLAYWRIGHT_WEBKIT_DOWNLOAD_HOST` 构建参数 |
| `docker/Dockerfile.odl-hybrid` | `weknora-odl-hybrid:local` | 安装 `opendataloader-pdf[hybrid]`(Docling),监听 5002,默认 `--no-ocr`;仅本地构建不发布 |
| `docker/Dockerfile.sandbox` | `wechatopenai/weknora-sandbox` | Agent 会话沙箱镜像。基础环境为 Python 3.12-slim + Node 20 + uv/pnpm,默认 `root` 执行,保留 `user`(UID 1000) 供显式选择。默认构建目标 `sandbox` 供 Docker 后端使用;另有 `cube`(含 Cube envd)、`desktop` / `desktop-cube`(带图形桌面)等目标,见[沙箱部署](../06-development/04-sandbox-deployment.md) |
| `frontend/Dockerfile` | `wechatopenai/weknora-ui` | 两阶段:digest 锁定的 `node:24-bookworm-slim`(`$BUILDPLATFORM`,避免多架构 CI 用 QEMU 跑 Vite)内 `npm ci` + `npm run build`(`VITE_IS_DOCKER` / `VITE_FRONTEND_COMMIT`),可选 `NPM_REGISTRY` / `NODE_MAX_OLD_SPACE_SIZE`;运行层为按 digest 固定的 `nginx:1.30.3-alpine`(兼容 CentOS 7 旧内核)。无需宿主机预构建 `dist/` |
@@ -148,6 +148,16 @@ make docker-build-docreader
make docker-build-frontend
```
+docreader 在国内或企业内网构建时,可同时切换 APT 和 Playwright 制品源:
+
+```bash
+APT_MIRROR=https://your-apt-mirror.example.com \
+PLAYWRIGHT_WEBKIT_DOWNLOAD_HOST=https://your-playwright-mirror.example.com \
+./scripts/build_images.sh --docreader
+```
+
+`APT_MIRROR` 需传入保留 `/debian` 和 `/debian-security` 路径结构的镜像站根地址;Playwright 制品源需保留官方制品的路径结构。仅配置 WebKit 时优先使用 `PLAYWRIGHT_WEBKIT_DOWNLOAD_HOST`,它的优先级高于通用的 `PLAYWRIGHT_DOWNLOAD_HOST`。
+
## 四、Makefile 部署相关目标速查
| 目标 | 作用 |