diff --git a/.env.example b/.env.example
index 78a3b72c..517921c8 100644
--- a/.env.example
+++ b/.env.example
@@ -13,4 +13,8 @@ ZEP_API_KEY=your_zep_api_key_here
 # 注意如果不使用加速配置，env文件中就不要出现下面的配置项
 LLM_BOOST_API_KEY=your_api_key_here
 LLM_BOOST_BASE_URL=your_base_url_here
-LLM_BOOST_MODEL_NAME=your_model_name_here
\ No newline at end of file
+LLM_BOOST_MODEL_NAME=your_model_name_here
+
+# ===== 前端 API 地址配置（远程/VPS 部署时需要） =====
+# 默认前端请求 http://localhost:5001；部署到远程服务器时需设置后端 API 的实际地址
+# VITE_API_BASE_URL=http://your-server-ip:5001
\ No newline at end of file
diff --git a/README.md b/README.md
index de082935..fca6bd76 100644
--- a/README.md
+++ b/README.md
@@ -125,6 +125,10 @@ LLM_MODEL_NAME=qwen-plus
 # Zep Cloud Configuration
 # Free monthly quota is sufficient for simple usage: https://app.getzep.com/
 ZEP_API_KEY=your_zep_api_key
+
+# Frontend API URL (required for remote/VPS deployment)
+# Defaults to http://localhost:5001; set to the public backend URL when deploying to a remote server
+# VITE_API_BASE_URL=http://your-server-ip:5001
 ```
 
 #### 2. Install Dependencies