diff --git a/.env.example b/.env.example
new file mode 100644
index 0000000..fb041ac
--- /dev/null
+++ b/.env.example
@@ -0,0 +1,9 @@
+# 复制为 .env 后填入真实值；部署时在平台「环境变量」里填同名项，勿提交 .env。
+
+# MinerU 文档解析（必填，否则 pipeline 会报错）
+MINERU_API_KEY=
+
+# 阿里云 DashScope（区域检测 / 图像分类等会读）
+DASHSCOPE_API_KEY=
+# 一般可保持默认；自建兼容网关时再改
+DASHSCOPE_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
diff --git a/docker-compose.yaml b/docker-compose.yaml
index 66203cc..efa7ea7 100644
--- a/docker-compose.yaml
+++ b/docker-compose.yaml
@@ -5,6 +5,8 @@ services:
       - "80761:8010"
     environment:
       MINERU_API_KEY: ${MINERU_API_KEY:-}
+      DASHSCOPE_API_KEY: ${DASHSCOPE_API_KEY:-}
+      DASHSCOPE_BASE_URL: ${DASHSCOPE_BASE_URL:-https://dashscope.aliyuncs.com/compatible-mode/v1}
     volumes:
       - zld-data:/app/data