Skip to content

Commit 47114f4

Browse files
committed
docs: 更新本地代理文档,说明仅支持本地使用
- 添加重要提示:说明 HTTP 代理无法从 HTTPS 网站访问 - 更新快速开始指南:包含启动本地前端的步骤 - 添加使用场景对比表 - 解释为什么不支持 HTTPS 网站(Mixed Content、杀毒软件拦截等)
1 parent 17c981e commit 47114f4

1 file changed

Lines changed: 38 additions & 20 deletions

File tree

local-proxy/README.md

Lines changed: 38 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,10 @@
22

33
轻量级本地代理服务器,功能完全等同于 Cloudflare Worker,让你无需部署到云端即可使用。
44

5+
> **重要提示**:此本地代理仅支持 HTTP 协议,必须配合**本地运行的 Paper Burner 前端**使用。
6+
> 如果你从 HTTPS 网站(如 `https://paperburner.viwoplus.site`)访问,由于浏览器安全限制(Mixed Content),无法连接到本地 HTTP 服务。
7+
> 请使用我们提供的 Cloudflare Worker 或自行部署 HTTPS 代理。
8+
59
## 功能
610

711
- **OCR 代理**: MinerU / Doc2X
@@ -10,22 +14,35 @@
1014

1115
## 快速开始
1216

13-
### 方式一:直接运行(推荐)
17+
### 1. 启动本地代理
1418

1519
```bash
1620
cd local-proxy
1721
npm install
1822
npm start
1923
```
2024

21-
### 方式二:全局安装
25+
### 2. 启动本地前端
26+
27+
在项目根目录启动一个本地服务器:
2228

2329
```bash
24-
cd local-proxy
25-
npm install -g .
26-
paper-burner-proxy
30+
# 方式一:使用 npx serve
31+
npx serve -p 8080
32+
33+
# 方式二:使用 Python
34+
python -m http.server 8080
35+
36+
# 方式三:使用 VS Code Live Server 插件
2737
```
2838

39+
### 3. 配置使用
40+
41+
1. 访问 `http://localhost:8080`
42+
2. 进入设置页面
43+
3. 将代理地址设置为:`http://localhost:3456`
44+
4. 保存设置
45+
2946
## 配置
3047

3148
1. 复制配置文件:
@@ -44,13 +61,6 @@ paper-burner-proxy
4461
npm start
4562
```
4663

47-
## 在 Paper Burner 中使用
48-
49-
1. 启动本地代理服务器后,打开 Paper Burner
50-
2. 进入设置页面
51-
3. 将代理地址设置为:`http://localhost:3456`
52-
4. 保存设置
53-
5464
## API 路由
5565

5666
### OCR 服务
@@ -95,15 +105,23 @@ paper-burner-proxy
95105

96106
- Node.js >= 18.0.0
97107

98-
## 与 Cloudflare Worker 的区别
108+
## 使用场景对比
109+
110+
| 场景 | 推荐方案 |
111+
|------|----------|
112+
| 本地开发/测试 | 本地代理 + 本地前端 |
113+
| 日常使用(线上) | Cloudflare Worker |
114+
| 私有部署 | 自建 HTTPS 代理服务器 |
115+
116+
## 为什么不支持 HTTPS 网站?
117+
118+
浏览器的 **Mixed Content** 安全策略禁止 HTTPS 页面请求 HTTP 资源。虽然可以通过自签名证书启用 HTTPS,但:
119+
120+
1. 自签名证书需要手动信任,用户体验差
121+
2. 杀毒软件(如卡巴斯基)可能拦截自签名 HTTPS 流量
122+
3. 每次证书过期都需要重新配置
99123

100-
| 特性 | 本地代理 | CF Worker |
101-
|------|----------|-----------|
102-
| 部署 | 本地运行 | 云端部署 |
103-
| 费用 | 免费 | 免费额度有限 |
104-
| 延迟 | 取决于网络 | 边缘节点低延迟 |
105-
| 可用性 | 需要保持运行 | 24/7 可用 |
106-
| 配置 | .env 文件 | 环境变量 |
124+
因此,本地代理仅推荐用于**本地开发和测试**场景。
107125

108126
## License
109127

0 commit comments

Comments
 (0)