Flutter代理服务器插件angel3_proxy的使用

Flutter代理服务器插件angel3_proxy的使用

Angel3中间件用于将请求转发到另一个服务器（例如webdev serve）。它还支持WebSocket。

引入依赖

首先，在你的pubspec.yaml文件中添加angel3_proxy依赖：

dependencies:
  angel3_proxy: ^x.x.x

基本用法

以下是一个基本示例，展示了如何设置一个代理服务器，将所有请求转发到本地服务器。

import 'package:angel3_proxy/angel3_proxy.dart';
import 'package:http/http.dart' as http;

void main() async {
  // 创建一个代理实例，将请求转发到本地服务器。
  var proxy1 = Proxy('http://localhost:3000');

  // 将代理实例挂接到应用的所有路由上。
  app.fallback(proxy1.handleRequest);
}

限制代理范围

你还可以限制代理仅服务于特定路径下的请求。例如，只处理以/remote开头的请求。

// 创建一个代理实例，将请求转发到本地服务器，并限制公共路径为'/remote'。
var proxy2 = Proxy('http://localhost:3000', publicPath: '/remote');

// 将代理实例挂接到应用的特定路由上。
app.all('/remote/*', proxy2.handleRequest);

映射请求到远程服务器的特定路径

你可以将请求映射到远程服务器上的特定路径。例如，将所有请求映射到/path路径。

// 创建一个代理实例，将请求转发到本地服务器，并替换路径为'/path'。
var proxy3 = Proxy('http://localhost:3000').replace(path: '/path');

// 将代理实例挂接到应用的特定路由上。
app.all('/path/*', proxy3.handleRequest);

完整示例

以下是一个完整的示例，展示了如何使用angel3_proxy插件来实现一个代理服务器，可以处理不同路径的请求，并且支持WebSocket。

import 'dart:io';
import 'package:angel3_framework/angel3_framework.dart';
import 'package:angel3_framework/http.dart';
import 'package:angel3_proxy/angel3_proxy.dart';
import 'package:logging/logging.dart';

final Duration timeout = Duration(seconds: 5);

void main() async {
  var app = Angel();

  // 将任何以`/pub`开头的请求转发到pub.dartlang.org。
  var pubProxy = Proxy(
    'https://pub.dartlang.org',
    publicPath: '/pub',
    timeout: timeout,
  );
  app.all('/pub/*', pubProxy.handleRequest);

  // 惊喜！我们也可以代理WebSocket。
  //
  // 在 http://www.websocket.org/echo.html 上玩一玩。
  var echoProxy = Proxy(
    'http://echo.websocket.org',
    publicPath: '/echo',
    timeout: timeout,
  );
  app.get('/echo', echoProxy.handleRequest);

  // Pub的HTML假设站点样式等位于绝对路径`/static`。这在当前情况下不适用。让我们修复这个问题：
  app.get('/static/*', (RequestContext req, res) {
    return pubProxy.servePath(req.path, req, res);
  });

  // 其他任何请求应转发到dartlang.org。
  var dartlangProxy = Proxy(
    'https://dartlang.org',
    timeout: timeout,
    recoverFrom404: false,
  );
  app.all('*', dartlangProxy.handleRequest);

  // 如果无法连接到dartlang.org，则显示错误信息。
  app.fallback(
    (req, res) => res.write('无法连接到Pub或dartlang.'),
  );

  app.logger = Logger('angel')
    ..onRecord.listen(
      (rec) {
        print(rec);
        if (rec.error != null) print(rec.error);
        if (rec.stackTrace != null) print(rec.stackTrace);
      },
    );

  var server = await AngelHttp(app).startServer(InternetAddress.loopbackIPv4, 8080);
  print('监听中 http://${server.address.address}:${server.port}');
  print(
      '查看这个！ http://${server.address.address}:${server.port}/pub/packages/angel_framework');
}