FAQ.md

# 常见问题解答 (FAQ)

## 基本问题

### Q: 这个工具是做什么的？
A: 这个工具可以将 WebSocket 代理转换为标准的 **HTTP 代理**，让你能够在像 Hugging Face Spaces 这样的云平台上使用代理服务。

### Q: 为什么需要这个工具？
A: 许多云平台（如 Hugging Face Spaces）不允许直接暴露普通代理端口，但允许 WebSocket 连接。这个工具通过 WebSocket 连接到第一个代理 Space，然后提供标准的 HTTP 代理服务，利用了平台的 HTTPS 处理能力。

### Q: 这个工具支持哪些代理协议？
A: 默认提供 **HTTP 代理** 服务。你可以修改 `start.sh` 文件中的配置来切换到 SOCKS5 代理，但 SOCKS5 在 Hugging Face 环境下直接使用可能比较困难。

## 部署问题

### Q: 如何在 Hugging Face Space 上部署这个工具？
A: 请参照 README.md 中的部署指南。简单来说，你需要：
1. 创建一个新的 Space（选择 Docker 运行时）
2. 上传所有文件
3. 在 Space 设置中添加一个名为 `URL` 的 Secret，值为你的第一个 Space 的 URL

### Q: 为什么我的部署失败了？
A: 常见原因包括：
- 没有在 Space 设置中添加正确的 `URL` Secret
- Secret 的值格式错误（应该是完整的 URL，如 `https://your-first-space.hf.space`）
- 第一个 Space 未正确配置或运行 WebSocket 端点 (`/wsproxy`)

### Q: 我能在本地部署吗？
A: 可以，请参照 README.md 中的本地部署说明，使用 Docker 构建和运行容器。本地测试时，HTTP 代理地址通常是 `http://localhost:8080` (根据 docker run 命令中的端口映射)。

## 使用问题

### Q: 如何在客户端使用这个代理？
A: 配置你的应用程序使用以下 **HTTP 代理** 设置：
- **推荐 (HTTPS)**:
  - 主机/服务器：你的第二个 Space 的地址（如 `your-converter-space.hf.space`）
  - 端口：443
  - 类型：HTTP / HTTPS
  - (如果需要填写完整的 URL): `https://your-converter-space.hf.space`
- **备选 (HTTP)**:
  - 主机/服务器：你的第二个 Space 的地址（如 `your-converter-space.hf.space`）
  - 端口：80
  - 类型：HTTP
  - (如果需要填写完整的 URL): `http://your-converter-space.hf.space`

### Q: 我连接不上代理，该怎么办？
A: 尝试以下方法：
1. 检查两个 Space 是否都正常运行（查看 Space 日志）
2. 确认第一个 Space 的 WebSocket 端点 (`/wsproxy`) 是否可访问（可以尝试用在线 WebSocket 测试工具连接）
3. 检查你的客户端是否正确配置了 HTTP 代理设置（主机、端口、类型）

### Q: 代理速度很慢，如何改善？
A: 性能受多个因素影响：
- Hugging Face Spaces 免费版有带宽和计算限制
- 两个 Space 之间的通信会增加延迟
- 考虑升级到付费版 Space 或使用其他平台

## 技术问题

### Q: 这个工具如何工作的？
A: 它使用 `gost` 工具在容器内部的 7860 端口监听 **HTTP 代理** 连接。当收到来自 Hugging Face (经过 HTTPS 解密后，或直接通过 HTTP) 的 HTTP 代理请求时，`gost` 将通过 WebSocket (`wss://.../wsproxy`) 连接到第一个 Space，并将流量转发。

### Q: 我可以添加认证功能吗？
A: 可以，修改 `start.sh` 中的 `gost` 命令为 `gost -L "http://username:password@:7860" -F "$TARGET_WSPROXY_URL"`。

### Q: 我可以切换回 SOCKS5 代理吗？
A: 可以，修改 `start.sh`，注释掉 HTTP 代理的启动命令，取消 SOCKS5 代理命令的注释。但请注意，在 Hugging Face 上直接使用 SOCKS5 可能需要客户端支持特殊的隧道方式。