EM-Proxy 技术文档

1. 安装指南

首先，确保您的系统中已经安装了Ruby。接下来，您可以通过Ruby的包管理器gem来安装EM-Proxy。

$ gem install em-proxy

安装成功后，您可以通过以下命令验证安装：

$ em-proxy -v

如果返回了版本信息，则表示EM-Proxy已成功安装。

2. 项目的使用说明

EM-Proxy是一个基于EventMachine的Ruby库，用于编写高性能的透明/拦截代理。以下是一个简单的使用示例：

$ em-proxy -l 8080 -r localhost:8081 -d localhost:8082,localhost:8083 -v

上述命令会在8080端口启动em-proxy，将请求重定向到8081端口，并且（可选地）将所有流量复制到8082和8083端口（并丢弃它们的响应）。

3. 项目API使用文档

以下是一个简单的API使用示例：

Proxy.start(:host => "0.0.0.0", :port => 80, :debug => true) do |conn|
  conn.server :srv, :host => "127.0.0.1", :port => 81

  # 修改/处理请求流
  conn.on_data do |data|
    p [:on_data, data]
    data
  end

  # 修改/处理响应流
  conn.on_response do |backend, resp|
    p [:on_response, backend, resp]
    resp
  end

  # 终止逻辑
  conn.on_finish do |backend, name|
    p [:on_finish, name]

    # 在双向模式中，当生产端完成时可以终止连接
    unbind if backend == :srv
  end
end

在/examples目录中，您可以找到更多示例，包括SMTP垃圾邮件过滤、流量复制、选择性转发、Beanstalkd拦截器等。

4. 项目安装方式

EM-Proxy的安装方式非常简单，只需使用Ruby的gem命令即可。请参考以下步骤：

1. 打开命令行工具。
2. 输入以下命令安装EM-Proxy：

$ gem install em-proxy

3. 安装成功后，您可以使用以下命令启动em-proxy并验证其是否正常工作：

$ em-proxy -v

以上就是EM-Proxy的技术文档。希望对您有所帮助。