Easegress 网关安装指南：从入门到精通

Easegress 网关安装指南：从入门到精通

easegress A Cloud Native traffic orchestration system 项目地址: https://gitcode.com/gh_mirrors/eas/easegress

前言

Easegress 是一款高性能、可扩展的云原生 API 网关，本文将详细介绍多种安装方式，帮助开发者快速搭建 Easegress 环境。无论您是刚接触网关的新手，还是经验丰富的系统管理员，都能找到适合的安装方案。

预编译二进制安装（推荐新手）

对于大多数用户而言，使用预编译的二进制文件是最简单快捷的安装方式。

安装步骤

1. 获取安装包
   根据您的操作系统平台（Linux/macOS/Windows等）下载对应的压缩包。Easegress 为不同平台提供了优化过的二进制版本。

2. 解压文件
   使用解压工具（如 tar、unzip）解压下载的压缩包，会得到一个包含可执行文件的目录。

3. 配置环境变量
   将解压后的目录添加到系统 PATH 环境变量中，或者直接将二进制文件移动到系统已有的 PATH 目录（如 /usr/local/bin）。

验证安装

执行以下命令验证安装是否成功：

easegress-server --version

正常情况会显示当前安装的版本号，如 Easegress v2.6.1。

源码编译安装（适合开发者）

如果您需要定制化功能或想了解内部实现，可以从源码编译安装。

准备工作

• 确保已安装 Go 1.20 或更高版本
• 安装必要的构建工具（make、git等）

编译步骤

1. 获取源码
   可以通过版本控制工具获取最新代码，或者直接下载源码包。

2. 进入项目目录

   cd easegress
   

3. 执行编译

   make
   

   编译完成后，可执行文件会生成在 bin 目录下。

4. 配置环境
   将生成的二进制文件目录加入 PATH：

   export PATH="$PATH:`pwd`/bin"
   

5. 特殊功能支持
   如需 WebAssembly 支持，需执行：

   make wasm
   

系统服务安装（生产环境推荐）

对于生产环境，建议配置为系统服务实现开机自启和自动管理。

Systemd 服务安装

执行官方提供的安装脚本：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/megaease/easegress/main/scripts/install.sh)"

安装完成后，您可以使用标准的 systemd 命令管理 Easegress 服务：

systemctl start easegress  # 启动服务
systemctl enable easegress # 设置开机自启
systemctl status easegress # 查看服务状态

Docker 容器化安装

对于容器化环境，Easegress 提供了官方镜像。

安装步骤

1. 拉取镜像

   docker pull megaease/easegress:latest
   

2. 运行容器

   docker run -d -p 10080:10080 -p 10081:10081 megaease/easegress
   

   其中：

   • 10080 端口用于 HTTP 流量
   • 10081 端口用于 HTTPS 流量

安装后配置建议

1. 防火墙设置
   确保相关端口（默认 10080/10081）在防火墙中开放。

2. 日志配置
   生产环境建议配置日志轮转和持久化存储。

3. 监控集成
   Easegress 支持 Prometheus 等监控系统，建议安装后配置监控。

常见问题解答

Q: 安装后无法启动服务怎么办？
A: 检查日志文件（默认位置 /var/log/easegress.log）获取详细错误信息。

Q: 如何升级到新版本？
A: 二进制安装方式只需替换二进制文件；容器方式重新拉取最新镜像即可。

Q: 支持哪些CPU架构？
A: Easegress 支持 x86_64 和 ARM64 架构。

通过以上多种安装方式，您可以根据实际需求选择最适合的方案部署 Easegress 网关。建议生产环境采用 Systemd 或 Docker 方式，以获得更好的可维护性。

easegress A Cloud Native traffic orchestration system 项目地址: https://gitcode.com/gh_mirrors/eas/easegress