5分钟上手Pipy：从安装到部署的超简单实践指南

5分钟上手Pipy：从安装到部署的超简单实践指南

【免费下载链接】pipyPipy is a programmable proxy for the cloud, edge and IoT.项目地址: https://gitcode.com/gh_mirrors/pi/pipy

Pipy是一款面向云、边缘和物联网的可编程代理工具，采用C++编写，兼具轻量级和高性能特性，通过定制版JavaScript语言PipyJS实现全可编程能力。无论是作为高性能反向代理，还是进行协议转换、网络流量记录、消息签名验证等操作，Pipy都能轻松胜任。

一、超简单安装步骤

1.1 Homebrew快速安装（推荐）

对于macOS或WSL用户，通过Homebrew安装Pipy只需3步：

$ brew update $ brew tap flomesh-io/pipy $ brew install pipy

1.2 脚本自动安装

如果你的系统没有Homebrew，可以使用官方提供的安装脚本：

curl -fsSL https://gitcode.com/gh_mirrors/pi/pipy/raw/master/get-pipy.sh | sh

该脚本会自动检测系统架构（x86_64或aarch64）和操作系统（Linux、macOS等），并安装到/usr/local/bin目录。

1.3 源码编译安装

如果你需要最新开发版本，可以从源码编译：

git clone https://gitcode.com/gh_mirrors/pi/pipy cd pipy make sudo make install

二、5分钟启动第一个代理服务

2.1 验证安装

安装完成后，运行以下命令检查版本：

pipy --version

如果安装成功，会显示当前Pipy版本信息。

2.2 启动管理控制台

直接运行pipy命令会启动管理控制台：

pipy

默认情况下，管理控制台会在6060端口运行，你可以通过--admin-port参数修改端口：

pipy --admin-port=8080

2.3 运行示例代理

Pipy提供了丰富的示例，位于samples目录。例如启动一个简单的HTTP服务器：

pipy samples/serve/main.js

这个示例会启动一个静态文件服务器，默认监听8080端口。

三、核心功能快速体验

3.1 简单代理服务

创建一个proxy.js文件，内容如下：

pipy.listen(8080, $=>$ .connect('https://example.com') )

运行这个脚本：

pipy proxy.js

现在访问http://localhost:8080就会代理到https://example.com。

3.2 负载均衡示例

Pipy内置负载均衡功能，以下是一个简单的负载均衡配置：

var servers = [ 'http://192.168.1.100:8080', 'http://192.168.1.101:8080' ] pipy.listen(80, $=>$ .roundRobin(servers) .connect() )

四、学习资源与文档

4.1 官方文档

Pipy提供了详细的文档，位于docs目录，包括：

• 快速入门指南：docs/getting-started/quick-start.mdx
• 核心概念：docs/intro/concepts.mdx
• API参考：docs/reference/api.mdx

4.2 教程与示例

Pipy提供了一系列教程，位于tutorial目录，从基础到高级逐步引导你掌握Pipy的使用：

• 入门教程：tutorial/01-hello/main.js
• 代理教程：tutorial/03-proxy/main.js
• 负载均衡教程：tutorial/05-load-balancing/main.js

五、常见问题解决

5.1 端口占用

如果启动时提示端口被占用，可以使用--admin-port参数指定其他端口：

pipy --admin-port=8888

5.2 升级Pipy

使用Homebrew安装的用户可以通过以下命令升级：

brew update brew upgrade pipy

5.3 获取帮助

如果在使用过程中遇到问题，可以查看帮助文档：

pipy --help

或者参考官方FAQ：FAQ

通过以上简单步骤，你已经掌握了Pipy的基本安装和使用方法。Pipy的强大之处在于其可编程性，通过PipyJS，你可以定制各种复杂的代理逻辑，满足不同场景的需求。开始你的Pipy之旅吧！

【免费下载链接】pipyPipy is a programmable proxy for the cloud, edge and IoT.项目地址: https://gitcode.com/gh_mirrors/pi/pipy