Upload 5 files

Dockerfile

@@ -2,9 +2,11 @@
 FROM alpine:latest
 
 # 设置环境变量，用于指定目标 WebSocket 代理 URL
-# 这将被 Hugging Face Secret 覆盖 (在构建时)
-ARG TARGET_WSPROXY_URL="wss://your-first-space.hf.space/wsproxy"
-ENV TARGET_WSPROXY_URL=${TARGET_WSPROXY_URL}
+# 可以设置两种环境变量:
+# - URL: 原始 Space URL，如 https://your-first-space.hf.space
+# - TARGET_WSPROXY_URL: 完整的 WebSocket URL (可选的，优先级较低)
+ARG URL=""
+ENV URL=${URL}
 
 # 工作目录
 WORKDIR /app

FAQ.md

@@ -0,0 +1,67 @@
+# 常见问题解答 (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 可能需要客户端支持特殊的隧道方式。 

README.md

@@ -1,17 +1,29 @@
+---
+title: WebSocket代理转换器
+emoji: 🔄
+colorFrom: blue
+colorTo: indigo
+sdk: docker
+sdk_version: "latest"
+app_file: app.py
+app_port: 7860
+pinned: false
+---
+
 # WebSocket 代理转换器
 
-这个项目提供了一个简单的代理中转服务，将 WebSocket 代理转换为标准的 SOCKS5/HTTP 代理，使其更容易被普通应用程序使用。
+这个项目提供了一个简单的代理中转服务，将 WebSocket 代理转换为标准的 **HTTP 代理**，使其更容易被普通应用程序使用。
 
 ## 背景
 
-许多云平台（如 Hugging Face Spaces）不允许直接暴露代理端口，但允许通过 WebSocket 提供服务。这种情况下，直接使用标准的代理配置可能会遇到困难。这个项目解决了这个问题：
+许多云平台（如 Hugging Face Spaces）不允许直接暴露代理端口，但允许通过 WebSocket 提供服务。这个项目解决了这个问题：
 
 1. **第一个 Space**（Clash WebSocket 代理）: 通过 WebSocket 隧道（`/wsproxy`）提供代理服务
-2. **这个 Space**（代理转换器）: 将 WebSocket 代理转换为标准 SOCKS5 或 HTTP 代理
+2. **这个 Space**（代理转换器）: 将 WebSocket 代理转换为标准 HTTP 代理
 
 ## 特点
 
-- 自动将 WebSocket 代理转换为标准 SOCKS5/HTTP 代理
+- 自动将 WebSocket 代理转换为标准 HTTP 代理
 - 支持在 Hugging Face Spaces 等平台上部署
 - 轻量级、安全和高性能
 - 基于 [gost](https://github.com/ginuerzh/gost) 实现，成熟稳定
@@ -20,48 +32,54 @@
 
 ### 在 Hugging Face Space 上部署
 
-1. 创建一个新的 Space（使用 Docker 运行时）
+1. 创建一个新的 Space（选择 Docker 运行时）
 2. 上传这个目录中的所有文件
 3. 在 Space 的设置中添加一个密钥（Secret）:
-   - 名称: `TARGET_WSPROXY_URL`
-   - 值: 第一个 Space 的 WebSocket 代理地址，例如 `wss://your-first-space.hf.space/wsproxy`
+   - 名称: `URL`
+   - 值: 第一个 Space 的 URL，例如 `https://your-first-space.hf.space`（脚本会自动处理路径和协议转换）
 4. 部署并等待构建完成
 
 ### 本地部署（测试用途）
 
 ```bash
 # 设置目标 WebSocket 代理 URL
-export TARGET_WSPROXY_URL="wss://your-first-space.hf.space/wsproxy"
+export URL="https://your-first-space.hf.space"
 
 # 运行 Docker 容器
 docker build -t proxy-converter .
-docker run -p 1080:7860 -e TARGET_WSPROXY_URL=$TARGET_WSPROXY_URL proxy-converter
+docker run -p 8080:7860 -e URL=$URL proxy-converter
+# 然后配置 HTTP 代理为 http://localhost:8080
 ```
 
 ## 使用方法
 
-部署完成后，你可以使用以下代理设置：
+部署完成后，你可以使用以下 **HTTP 代理** 设置：
+
+- **推荐 (HTTPS)**: 
+  - 主机/服务器: `your-converter-space.hf.space`
+  - 端口: `443`
+  - URL (如果需要): `https://your-converter-space.hf.space`
+  - 类型: HTTP / HTTPS (客户端到代理服务器的连接是加密的)
 
-- **SOCKS5 代理**: 
-  - 主机: `your-space-name.hf.space`
-  - 端口: 443（或 Hugging Face 分配的端口）
-  - 类型: SOCKS5
-  - （注：可能需要使用 HTTP CONNECT 隧道连接）
+- **备选 (HTTP)**: 
+  - 主机/服务器: `your-converter-space.hf.space`
+  - 端口: `80`
+  - URL (如果需要): `http://your-converter-space.hf.space`
+  - 类型: HTTP (客户端到代理服务器的连接是未加密的)
 
-- **HTTP 代理**（如果在 Dockerfile 中启用）:
-  - URL: `http://your-space-name.hf.space`
-  - 端口: 443（或 Hugging Face 分配的端口）
+- **SOCKS5 代理**（如果修改了 `start.sh` 配置）: 
+  - 需要客户端支持通过 HTTP CONNECT 或其他隧道方式连接 SOCKS5。不推荐在 Hugging Face 上直接使用。
 
 ## 故障排除
 
-- **无法连接**：确保 `TARGET_WSPROXY_URL` 指向正确的第一个 Space 的 WebSocket 地址
-- **连接失败**：尝试在 Dockerfile 中切换协议类型（SOCKS5 / HTTP）
-- **性能问题**：Hugging Face 对免费 Spaces 有带宽和计算限制，请考虑升级或使用其他平台
+- **无法连接**：确保 `URL` 密钥指向正确的第一个 Space 的地址，并且两个 Space 都在运行。
+- **连接失败**：检查第一个 Space 的日志，确认 `/wsproxy` 是否正常工作。
+- **性能问题**：Hugging Face 对免费 Spaces 有带宽和计算限制，请考虑升级或使用其他平台。
 
 ## 自定义
 
-修改 `Dockerfile` 中的配置可以自定义代理类型、添加认证等。详细请参考 [gost 文档](https://github.com/ginuerzh/gost/blob/master/README_en.md)。
+修改 `start.sh` 中的配置可以自定义代理类型（改回 SOCKS5）、添加认证等。详细请参考 [gost 文档](https://github.com/ginuerzh/gost/blob/master/README_en.md)。
 
 ## 安全注意事项
 
-这种代理转换不提供加密，所以不要用于传输敏感数据，除非你信任 Hugging Face 的网络环境。如需加密传输，请考虑在此基础上���置 TLS。 
+这种代理转换不提供端到端的加密（仅在客户端到转换器 Space 和转换器 Space 到原始 Space 的 WebSocket 连接上可能有 TLS 加密）。请勿通过此代理传输高度敏感数据，除非你信任相关网络环境。 

start.sh

@@ -6,13 +6,37 @@ echo "  WebSocket Proxy Converter (by gost)"
 echo "======================================"
 echo "Starting service at port 7860..."
 
-# 检查目标 WebSocket 代理 URL 是否已设置
-if [ -z "$TARGET_WSPROXY_URL" ]; then
-    echo "Error: TARGET_WSPROXY_URL environment variable is not set."
-    echo "Please set it to your WebSocket proxy URL, like: wss://your-first-space.hf.space/wsproxy"
+# 检查目标 URL 是否已设置（兼容两种环境变量名）
+if [ -n "$URL" ]; then
+    # 用户设置了 URL 环境变量（Hugging Face Secret）
+    TARGET_BASE_URL="$URL"
+elif [ -n "$TARGET_WSPROXY_URL" ]; then
+    # 用户直接设置了完整的 WebSocket URL
+    TARGET_BASE_URL="$TARGET_WSPROXY_URL"
+else
+    echo "Error: Neither URL nor TARGET_WSPROXY_URL environment variable is set."
+    echo "Please set URL to your first Space URL, like: https://your-first-space.hf.space"
     exit 1
 fi
 
+# 检查是否已经包含 /wsproxy 路径
+if [[ "$TARGET_BASE_URL" != */wsproxy ]]; then
+    # 添加 /wsproxy 路径
+    TARGET_BASE_URL="${TARGET_BASE_URL}/wsproxy"
+fi
+
+# 检查是否需要转换 https:// 到 wss:// 或 http:// 到 ws://
+if [[ "$TARGET_BASE_URL" == https://* ]]; then
+    # 替换 https:// 为 wss://
+    TARGET_WSPROXY_URL="${TARGET_BASE_URL/https:\/\//wss:\/\/}"
+elif [[ "$TARGET_BASE_URL" == http://* ]]; then
+    # 替换 http:// 为 ws://
+    TARGET_WSPROXY_URL="${TARGET_BASE_URL/http:\/\//ws:\/\/}"
+else
+    # 假设已经是正确的 WebSocket URL
+    TARGET_WSPROXY_URL="$TARGET_BASE_URL"
+fi
+
 echo "Target WebSocket proxy: $TARGET_WSPROXY_URL"
 
 # 创建状态页面
@@ -69,6 +93,7 @@ cat > /app/html/index.html << EOF
         <ul>
             <li><strong>SOCKS5 代理地址:</strong> <code>$(hostname):7860</code></li>
             <li><strong>目标 WebSocket 代理:</strong> <code>${TARGET_WSPROXY_URL}</code></li>
+            <li><strong>源自URL:</strong> <code>${TARGET_BASE_URL}</code></li>
         </ul>
     </div>
     
@@ -90,18 +115,19 @@ cat > /app/html/index.html << EOF
 </html>
 EOF
 
-# 同时启动 HTTP 服务和 gost
-# 在后台启动 gost SOCKS5 服务
-echo "Starting gost SOCKS5 proxy..."
-gost -L "socks5://:7860" -F "$TARGET_WSPROXY_URL" &
+# 启动 gost 服务
+# 默认监听 HTTP 代理 (更兼容 Hugging Face)
+echo "Starting gost HTTP proxy..."
+gost -L "http://:7860" -F "$TARGET_WSPROXY_URL" &
 GOST_PID=$!
 
-# 可选：启用 HTTP 代理转发
-# 如果要使用 HTTP 代理而不是 SOCKS5，取消下面两行的注释，并注释掉上面的 gost 命令
-# echo "Starting gost HTTP proxy..."
-# gost -L "http://:7860" -F "$TARGET_WSPROXY_URL" &
+# 可选：启用 SOCKS5 代理转发 (需要客户端支持特定隧道)
+# 如果要使用 SOCKS5 代理而不是 HTTP，取消下面两行的注释，并注释掉上面的 gost HTTP 命令
+# echo "Starting gost SOCKS5 proxy..."
+# gost -L "socks5://:7860" -F "$TARGET_WSPROXY_URL" &
+# GOST_PID=$!
 
-# 启动一个简单的 HTTP 服务器提供状态页面，如果请求不是代理请求
+# 启动一个简单的 HTTP 服务器提供状态页面
 cd /app/html
 python3 -m http.server 7861 &
 HTTP_PID=$!
@@ -113,8 +139,9 @@ if ! ps -p $GOST_PID > /dev/null; then
 fi
 
 echo "Proxy converter is running..."
-echo "- SOCKS5 proxy at port 7860"
-echo "- Status page at port 7861"
+echo "- HTTP proxy listening internally at port 7860"
+echo "- Status page available at port 7861 (web UI)"
+echo "- Connected to target WebSocket: $TARGET_WSPROXY_URL"
 
 # 设置捕获信号
 trap "kill $GOST_PID $HTTP_PID; exit" SIGINT SIGTERM