为了配置Surge的网络代理规则并正确使用它，按照以下步骤操作

步骤1：安装Surge

确保你已安装了Surge工具,可以通过以下命令安装：

npm install -g surge

步骤2：创建规则文件

创建一个名为 rulesets.js 的文件，用于定义你的代理规则，这个文件会包含一个数组，每个元素是一个配置对象，包含 match 和 handler。

const rules = [
  {
    match: '^/api/.*',
    handler: function (request) {
      // 修改请求的URL
      const url = new URL(request.url);
      url.host = 'your-proxy-host.example.com';
      return url.toString();
    }
  }
];

步骤3：运行Surge代理服务器

在项目根目录中启动Surge代理服务器,并应用你刚刚创建的规则：

surge run --rulesets rulesets.js

步骤4：测试代理规则

• 使用浏览器：在浏览器中访问你要代理的域名或路径，检查是否正确代理。
• 使用curl命令：在终端中运行：

curl -v http://localhost:400/path-you-expect

步骤5：验证和调整规则

• 确保每个 match 正确匹配请求路径。
• 检查 handler 函数是否正确修改了URL、请求头或响应。
• 如果需要更复杂的逻辑,可以在 handler 中添加更多处理步骤。

示例：完整的规则配置

假设你想将所有以 /api/ 开头的请求代理到 https://your-proxy-host.example.com：

const rules = [
  {
    match: '^/api/.*',
    handler: function (request) {
      const url = new URL(request.url);
      url.host = 'your-proxy-host.example.com';
      return url.toString();
    }
  }
];

进阶使用技巧

• 动态规则：根据请求头或查询参数动态调整URL。

const rules = [
  {
    match: '^/users/[^/]*',
    handler: function (request) {
      const { query } = request;
      const userId = query.userId;
      const url = new URL(request.url);
      url.search = `?id=${userId}`;
      return url.toString();
    }
  }
];

• 重写路径：将 /api/v1/ 请求重写为 /v2/：

const rules = [
  {
    match: '^/api/v1/.*',
    handler: function (request) {
      const url = new URL(request.url);
      url.path = '/v2/' + url.path.replace('/api/v1/', '');
      return url.toString();
    }
  }
];

• 添加请求头：在每个请求中添加一个 X-Forwarded-For 头：

const rules = [
  {
    match: '*',
    handler: function (request) {
      const url = new URL(request.url);
      url.headers['X-Forwarded-For'] = request.ip;
      return url.toString();
    }
  }
];

注意事项

• 路径匹配：使用 ^/ 表示从根路径开始， 表示到末尾。
• 多个规则：确保规则顺序合理，避免规则冲突。
• 错误处理：在 handler 中处理可能的错误，如无法解析URL。

通过以上步骤,你应该能够成功配置并使用Surge作为网络代理，满足你的开发需求。