Files
data-index-report/README_NETWORK.md
2026-05-18 13:52:47 +08:00

61 lines
1.6 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 网络访问配置说明
## 配置变更
已成功配置应用支持网络访问和本地代理:
### 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
- 后端 APIhttp://localhost:3002/api/generate-pdf
### 网络访问
- 前端http://<你的IP地址>:5173
- 后端 APIhttp://<你的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 支持,确保已安装相关依赖