chore: initial commit

README_NETWORK.md

@@ -0,0 +1,61 @@
+# 网络访问配置说明
+
+## 配置变更
+
+已成功配置应用支持网络访问和本地代理：
+
+### 1. Vite 配置 (`vite.config.ts`)
+- 设置 `host: '0.0.0.0'` - 允许从网络访问
+- 设置代理配置，将 `/api` 请求转发到 `http://localhost:3002`
+- 保持端口 `5173`
+
+### 2. 前端代码 (`src/App.tsx`)
+- 修改 API 调用从硬编码 `http://localhost:3002/api/generate-pdf` 改为相对路径 `/api/generate-pdf`
+- 这样可以通过 Vite 代理访问后端
+
+### 3. 服务器配置 (`server/src/index.js`)
+- 设置监听地址为 `'0.0.0.0'`，允许从网络访问
+- 更新 CORS 配置，允许来自 `localhost:5173` 和 `0.0.0.0:5173` 的请求
+
+## 启动方式
+
+### 方式一：使用启动脚本（推荐）
+```bash
+./start.sh
+```
+
+### 方式二：手动启动
+1. 启动 PDF 生成服务器：
+```bash
+cd server
+npm start
+# 或直接运行：node src/index.js
+```
+
+2. 在另一个终端启动前端：
+```bash
+npm run dev
+```
+
+## 访问方式
+
+### 本地访问
+- 前端：http://localhost:5173
+- 后端 API：http://localhost:3002/api/generate-pdf
+
+### 网络访问
+- 前端：http://<你的IP地址>:5173
+- 后端 API：http://<你的IP地址>:3002/api/generate-pdf
+
+## 工作原理
+
+1. 前端运行在 `0.0.0.0:5173`，可以通过网络访问
+2. 当点击"服务器生成"按钮时，前端发送请求到 `/api/generate-pdf`
+3. Vite 代理将 `/api` 请求转发到 `localhost:3002`
+4. 后端服务器处理请求，生成 PDF 并返回
+
+## 注意事项
+
+1. 确保防火墙允许端口 5173 和 3002 的访问
+2. 如果使用 Docker 或虚拟机，确保端口映射正确
+3. 后端服务器需要 Puppeteer 支持，确保已安装相关依赖