jori2022/apisix

镜像概述

该镜像基于APISIX 3.10.0-debian版本构建，在基础镜像上扩展了Node.js v22 LTS运行环境及JavaScript插件运行器（抽取自zenozeng/apisix-javascript-plugin-runner:0.2.1），主要用于支持APISIX网关的JavaScript外部插件运行，并修复了JS模块import时因缺少.js扩展名导致的报错问题。

核心功能与特性

• 基础镜像：基于APISIX 3.10.0-debian版本，确保与APISIX生态兼容
• Node.js环境：集成Node.js v22 LTS版本，提供稳定的JavaScript运行环境
• JS插件运行器：包含从zenozeng/apisix-javascript-plugin-runner:0.2.1抽取的核心组件，支持APISIX外部JavaScript插件执行
• 兼容性修复：解决了JavaScript模块import语句中缺少.js扩展名导致的加载报错问题

使用场景

适用于需要在APISIX网关中开发、部署和运行JavaScript外部插件的场景，例如：

• 自定义请求/响应处理逻辑
• 实现基于JavaScript的认证授权插件
• 开发日志收集、数据转换等功能插件
• 扩展APISIX网关的业务逻辑处理能力

使用方法

基本部署

通过docker run命令启动容器：

bash
docker run -d \
  --name apisix-js-plugin \
  -p 9080:9080 \  # APISIX默认端口
  -p 9091:9091 \  # APISIX控制平面端口
  -v /path/to/your/plugins:/usr/local/apisix/conf/plugins \  # 挂载自定义JS插件目录
  your-image-name:tag

配置说明

1. 插件开发：

   • 编写JavaScript插件时，确保import语句包含.js扩展名（例如：import { func } from './module.js'）
   • 将插件文件放置于挂载的插件目录中（如上述命令中的/path/to/your/plugins）

2. APISIX配置： 在APISIX配置文件（通常为config.yaml）中启用JavaScript插件运行器：

   yaml
   plugins:
     - ext-plugin
   ext-plugin:
     path_for_test: /usr/local/apisix/conf/plugins  # 插件目录路径
   

验证与测试

1. 启动容器后，通过APISIX Admin API检查插件状态：

   bash
   curl http://localhost:9091/v1/plugins
   

2. 部署包含JS插件的路由配置，验证插件功能是否正常运行。

注意事项

• 确保挂载的插件目录权限正确，容器内用户可读取插件文件
• Node.js依赖如需额外安装，可通过Dockerfile扩展或容器内执行npm install
• 生产环境建议使用docker-compose管理服务，并配置持久化存储