docs: clarify docker compose env file usage

Author: linshenkx

README.md

@@ -156,7 +156,7 @@ docker run -d -p 8081:80 \
 git clone https://github.com/linshenkx/prompt-optimizer.git
 cd prompt-optimizer
 
-# 2. Optional: Create .env file for API keys and authentication
+# 2. Create .env file for API keys and authentication
 cat > .env << EOF
 # API Key Configuration
 VITE_OPENAI_API_KEY=your_openai_api_key
@@ -171,11 +171,13 @@ ACCESS_USERNAME=your_username  # Optional, defaults to "admin"
 ACCESS_PASSWORD=your_password  # Set access password
 EOF
 
+# Because the compose file is under docker/, pass the root .env explicitly.
+
 # 3. Start the service
-docker compose -f docker/docker-compose.yml up -d
+docker compose --env-file .env -f docker/docker-compose.yml up -d
 
 # 4. View logs
-docker compose -f docker/docker-compose.yml logs -f
+docker compose --env-file .env -f docker/docker-compose.yml logs -f
 
 # 5. Access the service
 Web Interface: http://localhost:8081

README.zh-CN.md

@@ -160,15 +160,16 @@ docker run -d -p 8081:80 \
 git clone https://github.com/linshenkx/prompt-optimizer.git
 cd prompt-optimizer
 
-# 2. 可选：创建.env文件配置API密钥和访问认证
+# 2. 创建 .env 文件配置 API 密钥和访问认证
 cp env.local.example .env
 # 编辑 .env 文件，填入实际的 API 密钥和配置
+# docker-compose.yml 位于 docker/ 目录下，所以后续命令显式传入根目录 .env
 
 # 3. 启动服务
-docker compose -f docker/docker-compose.yml up -d
+docker compose --env-file .env -f docker/docker-compose.yml up -d
 
 # 4. 查看日志
-docker compose -f docker/docker-compose.yml logs -f
+docker compose --env-file .env -f docker/docker-compose.yml logs -f
 
 # 5. 访问服务
 Web 界面：http://localhost:8081

docs/deployment/docker-mcp-integration.md

@@ -57,9 +57,11 @@ cp env.local.example .env
 # 编辑.env文件，填入实际的API密钥
 ```
 
+由于 Compose 文件位于 `docker/` 目录下，下面的生产环境命令都显式传入仓库根目录的 `.env` 文件。
+
 ### 2. 启动服务
 ```bash
-docker compose -f docker/docker-compose.yml up -d
+docker compose --env-file .env -f docker/docker-compose.yml up -d
 ```
 
 ### 3. 访问服务
@@ -71,13 +73,13 @@ docker compose -f docker/docker-compose.yml up -d
 ### 4. 健康检查
 ```bash
 # 检查容器状态
-docker compose -f docker/docker-compose.yml ps
+docker compose --env-file .env -f docker/docker-compose.yml ps
 
 # 查看日志
-docker compose -f docker/docker-compose.yml logs -f
+docker compose --env-file .env -f docker/docker-compose.yml logs -f
 
 # 查看MCP服务器日志
-docker compose -f docker/docker-compose.yml exec prompt-optimizer supervisorctl tail -f mcp-server
+docker compose --env-file .env -f docker/docker-compose.yml exec prompt-optimizer supervisorctl tail -f mcp-server
 ```
 
 ## MCP服务器API
@@ -111,21 +113,21 @@ curl -X POST http://localhost:8081/mcp \
 
 ### 查看服务状态
 ```bash
-docker compose -f docker/docker-compose.yml exec prompt-optimizer supervisorctl status
+docker compose --env-file .env -f docker/docker-compose.yml exec prompt-optimizer supervisorctl status
 ```
 
 ### 重启MCP服务器
 ```bash
-docker compose -f docker/docker-compose.yml exec prompt-optimizer supervisorctl restart mcp-server
+docker compose --env-file .env -f docker/docker-compose.yml exec prompt-optimizer supervisorctl restart mcp-server
 ```
 
 ### 查看详细日志
 ```bash
 # Nginx日志
-docker compose -f docker/docker-compose.yml exec prompt-optimizer tail -f /var/log/nginx/error.log
+docker compose --env-file .env -f docker/docker-compose.yml exec prompt-optimizer tail -f /var/log/nginx/error.log
 
 # MCP服务器日志
-docker compose -f docker/docker-compose.yml exec prompt-optimizer tail -f /var/log/supervisor/mcp-server.out.log
+docker compose --env-file .env -f docker/docker-compose.yml exec prompt-optimizer tail -f /var/log/supervisor/mcp-server.out.log
 ```
 
 ## 开发模式

mkdocs/docs/zh/deployment/docker-basic.md

@@ -49,10 +49,10 @@ docker run -d -p 8081:80 --restart unless-stopped --name prompt-optimizer \
 
 ## 使用仓库自带的 Docker Compose
 
-仓库 `docker/` 目录已经带了 `docker-compose.yml`，可以直接使用：
+仓库 `docker/` 目录已经带了 `docker-compose.yml`。如果你在仓库根目录放了 `.env`，需要在命令里显式传入：
 
 ```bash
-docker compose -f docker/docker-compose.yml up -d
+docker compose --env-file .env -f docker/docker-compose.yml up -d
 ```
 
 默认端口映射是：
@@ -69,8 +69,8 @@ docker compose -f docker/docker-compose.yml up -d
 常用命令：
 
 ```bash
-docker compose -f docker/docker-compose.yml logs -f
-docker compose -f docker/docker-compose.yml down
+docker compose --env-file .env -f docker/docker-compose.yml logs -f
+docker compose --env-file .env -f docker/docker-compose.yml down
 ```
 
 ## 开发用 Compose

mkdocs/docs/zh/deployment/docker-troubleshooting.md

@@ -12,7 +12,7 @@
 排查前先分清：
 
 - `docker run -p 8081:80 ...`
-- `docker compose -f docker/docker-compose.yml up -d` 使用仓库自带 Compose 配置
+- `docker compose --env-file .env -f docker/docker-compose.yml up -d` 使用仓库自带 Compose 配置
 - `docker compose -f docker/docker-compose.dev.yml up -d --build`
 
 因为三种方式默认端口不一样，很多“服务打不开”其实只是看错了端口。
@@ -41,8 +41,8 @@ docker logs prompt-optimizer
 如果你用的是仓库自带 compose，再看：
 
 ```bash
-docker compose -f docker/docker-compose.yml ps
-docker compose -f docker/docker-compose.yml logs -f
+docker compose --env-file .env -f docker/docker-compose.yml ps
+docker compose --env-file .env -f docker/docker-compose.yml logs -f
 ```
 
 常见原因：
@@ -156,8 +156,8 @@ extra_hosts:
 可以按这个顺序试：
 
 ```bash
-docker compose -f docker/docker-compose.yml down
-docker compose -f docker/docker-compose.yml up -d
+docker compose --env-file .env -f docker/docker-compose.yml down
+docker compose --env-file .env -f docker/docker-compose.yml up -d
 ```
 
 或者：