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 可能需要客户端支持特殊的隧道方式。