mirror of
https://github.com/qaiu/netdisk-fast-download.git
synced 2026-02-04 04:16:18 +00:00
238 lines
6.4 KiB
Markdown
238 lines
6.4 KiB
Markdown
# 演练场增强功能 - 快速参考
|
||
|
||
## 🎯 功能一览
|
||
|
||
### 1️⃣ 编辑器增强
|
||
| 功能 | 操作 | 快捷键 |
|
||
|------|------|--------|
|
||
| 导入文件 | 更多 → 导入文件 | - |
|
||
| 粘贴代码 | 粘贴 按钮或 Ctrl+V | Ctrl+V |
|
||
| 支持的格式 | .js, .py, .txt | - |
|
||
|
||
### 2️⃣ 网络安全拦截
|
||
| 拦截项 | 示例 | 日志级别 |
|
||
|--------|------|---------|
|
||
| 本地地址 | 127.0.0.1, localhost | BLOCK |
|
||
| 私网地址 | 192.168.1.x, 10.0.0.x | BLOCK |
|
||
| 危险端口 | 22, 3306, 6379 | BLOCK |
|
||
| 正常请求 | https://example.com | ALLOW |
|
||
|
||
### 3️⃣ 控制台日志
|
||
```
|
||
[时间] [级别] [来源] 日志消息
|
||
|
||
来源标签：
|
||
[JAVA] - 后端Java日志（补丁注入、执行过程）
|
||
[PYTHON] - 用户Python代码日志
|
||
[JS] - JavaScript日志
|
||
```
|
||
|
||
---
|
||
|
||
## 📋 场景示例
|
||
|
||
### 场景1：导入Python脚本并执行
|
||
|
||
1. 点击"导入文件"→选择`parser.py`
|
||
2. 编辑器自动识别为Python模式
|
||
3. 设置测试参数（分享链接）
|
||
4. 点击"运行"执行
|
||
|
||
**预期日志输出**：
|
||
```
|
||
[10:15:30] INFO [JAVA] ✓ 网络请求安全拦截已启用 (检测到: requests) | 已动态注入 requests_guard 猴子补丁
|
||
[10:15:31] DEBUG [JAVA] 安全检查通过
|
||
[10:15:32] DEBUG [JAVA] 执行Python代码
|
||
[10:15:33] INFO [PYTHON] 正在解析: https://example.com/s/abc
|
||
[10:15:33] DEBUG [PYTHON] [Guard] 允许 GET https://example.com/s/abc
|
||
[10:15:34] INFO [JAVA] 解析成功
|
||
```
|
||
|
||
### 场景2：尝试访问本地地址（会被拦截）
|
||
|
||
**Python代码**:
|
||
```python
|
||
import requests
|
||
|
||
def parse(share_link_info, http_client, logger):
|
||
response = requests.get("http://127.0.0.1:8080/api") # ❌ 会被拦截
|
||
return response.text
|
||
```
|
||
|
||
**日志输出**:
|
||
```
|
||
[10:20:15] INFO [JAVA] ✓ 网络请求安全拦截已启用 (检测到: requests)
|
||
[10:20:16] DEBUG [JAVA] 执行Python代码
|
||
[10:20:17] ERROR [PYTHON] [Guard] 禁止访问本地地址：http://127.0.0.1:8080/api
|
||
```
|
||
|
||
### 场景3：粘贴多行代码
|
||
|
||
1. 复制多行JavaScript代码
|
||
2. 点击"粘贴"按钮
|
||
3. 代码一次性粘贴到编辑器
|
||
|
||
**提示信息**: `已粘贴 15 行内容`
|
||
|
||
---
|
||
|
||
## 🔒 安全检查规则
|
||
|
||
### 被拦截的地址
|
||
```
|
||
❌ 127.0.0.1 - 本地回环
|
||
❌ localhost - 本地主机
|
||
❌ ::1 - IPv6本地
|
||
❌ 10.0.0.0/8 - 私网A类
|
||
❌ 172.16.0.0/12 - 私网B类
|
||
❌ 192.168.0.0/16 - 私网C类
|
||
❌ 169.254.0.0/16 - Link-local
|
||
```
|
||
|
||
### 被拦截的端口（特殊检查）
|
||
```
|
||
22 - SSH
|
||
25 - SMTP
|
||
53 - DNS
|
||
3306 - MySQL
|
||
5432 - PostgreSQL
|
||
6379 - Redis
|
||
8080 - 常见开发端口
|
||
```
|
||
|
||
### 只允许
|
||
```
|
||
✅ http://example.com - 公网HTTP
|
||
✅ https://api.github.com - 公网HTTPS
|
||
```
|
||
|
||
---
|
||
|
||
## 🛠️ 技术细节
|
||
|
||
### 猴子补丁的工作原理
|
||
|
||
```
|
||
Python代码执行流程：
|
||
┌─────────────────────────────────────────────┐
|
||
│ 1. PyCodePreprocessor 分析代码 │
|
||
│ ↓ │
|
||
│ 2. 检测到 import requests │
|
||
│ ↓ │
|
||
│ 3. 从资源加载 requests_guard.py │
|
||
│ ↓ │
|
||
│ 4. 在代码头部注入补丁 │
|
||
│ ↓ │
|
||
│ 5. 注入完成，记录日志 │
|
||
│ ↓ │
|
||
│ 6. 执行增强后的代码 │
|
||
│ ↓ │
|
||
│ 7. 所有requests调用都经过补丁检查 │
|
||
│ ↓ │
|
||
│ 8. 合法请求继续，违规请求被拦截 │
|
||
└─────────────────────────────────────────────┘
|
||
```
|
||
|
||
### 代码注入示例
|
||
|
||
**原始代码**:
|
||
```python
|
||
"""网盘解析器"""
|
||
import requests
|
||
|
||
def parse(share_link_info, http_client, logger):
|
||
response = requests.get(share_link_info.share_url)
|
||
return response.text
|
||
```
|
||
|
||
**注入后的代码**:
|
||
```python
|
||
"""网盘解析器"""
|
||
|
||
# ===== 自动注入的网络请求安全补丁 (由 PyCodePreprocessor 生成) =====
|
||
[requests_guard.py 的完整内容 - 约400行]
|
||
# ===== 安全补丁结束 =====
|
||
|
||
import requests # ← 这时requests已经被补丁过了
|
||
|
||
def parse(share_link_info, http_client, logger):
|
||
response = requests.get(share_link_info.share_url)
|
||
return response.text
|
||
```
|
||
|
||
---
|
||
|
||
## 📊 日志级别说明
|
||
|
||
| 级别 | 含义 | 场景 |
|
||
|------|------|------|
|
||
| DEBUG | 调试信息 | 安全检查开始、执行步骤 |
|
||
| INFO | 一般信息 | 执行成功、补丁注入、请求允许 |
|
||
| WARN | 警告 | 可能的问题（一般不会出现） |
|
||
| ERROR | 错误 | 请求被拦截、执行失败 |
|
||
|
||
---
|
||
|
||
## ⚡ 性能指标
|
||
|
||
- **文件导入**: < 100ms
|
||
- **代码预处理**: < 50ms
|
||
- **补丁加载**: < 30ms（首次缓存）
|
||
- **网络请求验证**: < 5ms
|
||
|
||
---
|
||
|
||
## 🐛 常见问题
|
||
|
||
### Q1: 为什么我的requests请求被拦截了？
|
||
|
||
**A**: 检查请求URL是否为：
|
||
- 本地地址（127.0.0.1, localhost）
|
||
- 私网地址（192.168.x.x, 10.x.x.x等）
|
||
- 危险端口（22, 3306等）
|
||
|
||
在控制台日志中会显示具体原因。
|
||
|
||
### Q2: 粘贴时出现权限错误怎么办？
|
||
|
||
**A**: 某些浏览器在某些情况下会限制clipboard权限。
|
||
- 尝试使用 Ctrl+V 快捷键代替
|
||
- 确保页面URL是HTTPS（部分浏览器要求）
|
||
- 检查浏览器隐私设置中的剪贴板权限
|
||
|
||
### Q3: 导入的Python文件无法找到parse函数报错？
|
||
|
||
**A**: 确保：
|
||
1. 文件中有 `def parse(...)` 函数定义
|
||
2. 函数签名正确：`parse(share_link_info, http_client, logger)`
|
||
3. 函数返回字符串类型的URL
|
||
|
||
### Q4: 如何禁用网络请求拦截？
|
||
|
||
**A**: 当前版本无法禁用，这是安全功能。
|
||
- 如需特殊需求，请联系管理员
|
||
|
||
---
|
||
|
||
## 📱 移动端支持
|
||
|
||
- ✅ 文件导入在移动端正常工作
|
||
- ✅ 粘贴操作优化了移动端输入法问题
|
||
- ✅ 日志显示自动适应小屏幕
|
||
- ⚠️ 建议在PC上进行复杂编辑操作
|
||
|
||
---
|
||
|
||
## 📞 获取帮助
|
||
|
||
遇到问题可以：
|
||
1. 查看控制台日志（最详细的信息）
|
||
2. 查看完整的实现文档：[PLAYGROUND_ENHANCEMENT_IMPLEMENTATION.md](./PLAYGROUND_ENHANCEMENT_IMPLEMENTATION.md)
|
||
3. 联系技术支持
|
||
|
||
---
|
||
|
||
**最后更新**: 2026年1月18日
|
||
**版本**: 1.0
|
||
**状态**: ✅ 生产就绪
|