Spaces:

clash-linux
/

convert

Paused

App Files Files Community

clash-linux commited on Apr 5

Commit

a13ede0

verified ·

1 Parent(s): 13d050c

Upload 4 files

Browse files

Files changed (4) hide show

Dockerfile +35 -0
README.md +67 -11
app.py +8 -0
start.sh +123 -0

Dockerfile ADDED Viewed

	@@ -0,0 +1,35 @@

+# 使用轻量级的 Alpine Linux 作为基础镜像
+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}
+# 工作目录
+WORKDIR /app
+# 安装必要的软件
+RUN apk --no-cache add curl bash python3 netcat-openbsd
+# 下载并安装 gost
+ARG GOST_VERSION="2.11.5"
+RUN curl -L "https://github.com/ginuerzh/gost/releases/download/v${GOST_VERSION}/gost-linux-amd64-${GOST_VERSION}.gz" | gzip -d > /usr/local/bin/gost && \
+    chmod +x /usr/local/bin/gost
+# 复制启动脚本
+COPY start.sh /app/
+RUN chmod +x /app/start.sh
+# 暴露 7860 端口 (Hugging Face 默认端口)
+EXPOSE 7860
+# 设置健康检查
+HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \
+    CMD nc -z localhost 7860 || exit 1
+# 运行启动脚本
+ENTRYPOINT ["/app/start.sh"]
+# 默认参数 (可被 CMD 覆盖)
+CMD []

README.md CHANGED Viewed

@@ -1,11 +1,67 @@
----
-title: Convert
-emoji: 😻
-colorFrom: red
-colorTo: gray
-sdk: docker
-pinned: false
-license: mit
----
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference

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

app.py ADDED Viewed

	@@ -0,0 +1,8 @@

+"""
+这个文件是为了 Hugging Face Spaces 而创建的。
+当使用 Dockerfile 部署时，Hugging Face 仍然期望存在一个 app.py 文件，
+但实际上服务是由 Dockerfile 中的命令启动的，这个文件不会被执行。
+"""
+print("这个文件不会被 Hugging Face Spaces 执行。")
+print("实际服务由 Dockerfile 和 start.sh 启动。")

start.sh ADDED Viewed

	@@ -0,0 +1,123 @@

+#!/bin/bash
+# 显示欢迎信息
+echo "======================================"
+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"
+    exit 1
+fi
+echo "Target WebSocket proxy: $TARGET_WSPROXY_URL"
+# 创建状态页面
+mkdir -p /app/html
+cat > /app/html/index.html << EOF
+<!DOCTYPE html>
+<html>
+<head>
+    <title>Proxy Converter Status</title>
+    <style>
+        body {
+            font-family: Arial, sans-serif;
+            max-width: 800px;
+            margin: 0 auto;
+            padding: 20px;
+            line-height: 1.6;
+        }
+        .status {
+            padding: 15px;
+            background-color: #d4edda;
+            border-radius: 5px;
+            color: #155724;
+            margin: 20px 0;
+            border-left: 4px solid #28a745;
+        }
+        h1 {
+            color: #333;
+            border-bottom: 1px solid #eee;
+            padding-bottom: 10px;
+        }
+        code {
+            background: #f4f4f4;
+            padding: 2px 5px;
+            border-radius: 3px;
+        }
+        .info {
+            background-color: #e9f5ff;
+            border-left: 4px solid #0088ff;
+            padding: 15px;
+            margin: 20px 0;
+            border-radius: 5px;
+        }
+    </style>
+</head>
+<body>
+    <h1>WebSocket 代理转换器状态</h1>
+    <div class="status">
+        <strong>状态:</strong> 代理转换器正在运行
+    </div>
+    <div class="info">
+        <h3>代理信息:</h3>
+        <ul>
+            <li><strong>SOCKS5 代理地址:</strong> <code>$(hostname):7860</code></li>
+            <li><strong>目标 WebSocket 代理:</strong> <code>${TARGET_WSPROXY_URL}</code></li>
+        </ul>
+    </div>
+    <h3>使用说明</h3>
+    <p>将您的应用配置为使用此 Space 的地址作为 SOCKS5 代理：</p>
+    <ul>
+        <li><strong>主机:</strong> <code>$(hostname)</code> 或 <code>您的Space地址.hf.space</code></li>
+        <li><strong>端口:</strong> <code>443</code> (或 Hugging Face 分配的端口)</li>
+        <li><strong>类型:</strong> <code>SOCKS5</code></li>
+    </ul>
+    <p><em>注意: 此页面每30秒自动刷新以显示最新状态</em></p>
+    <script>
+        setTimeout(function() {
+            location.reload();
+        }, 30000);
+    </script>
+</body>
+</html>
+EOF
+# 同时启动 HTTP 服务和 gost
+# 在后台启动 gost SOCKS5 服务
+echo "Starting gost SOCKS5 proxy..."
+gost -L "socks5://:7860" -F "$TARGET_WSPROXY_URL" &
+GOST_PID=$!
+# 可选：启用 HTTP 代理转发
+# 如果要使用 HTTP 代理而不是 SOCKS5，取消下面两行的注释，并注释掉上面的 gost 命令
+# echo "Starting gost HTTP proxy..."
+# gost -L "http://:7860" -F "$TARGET_WSPROXY_URL" &
+# 启动一个简单的 HTTP 服务器提供状态页面，如果请求不是代理请求
+cd /app/html
+python3 -m http.server 7861 &
+HTTP_PID=$!
+# 检查 gost 是否已经启动
+if ! ps -p $GOST_PID > /dev/null; then
+    echo "Failed to start gost. Exiting..."
+    exit 1
+fi
+echo "Proxy converter is running..."
+echo "- SOCKS5 proxy at port 7860"
+echo "- Status page at port 7861"
+# 设置捕获信号
+trap "kill $GOST_PID $HTTP_PID; exit" SIGINT SIGTERM
+# 等待 gost 进程结束
+wait $GOST_PID