jenkins/jnlp-agent-coreruntime Docker Image

镜像概述

本镜像为集成了.NET Core运行时的入站代理镜像，旨在提供开箱即用的环境，用于接收、处理外部入站请求，并基于.NET Core环境运行相关代理服务或应用程序。通过预安装.NET Core运行时，简化基于.NET Core开发的代理服务部署流程，降低环境配置复杂度。

核心功能与特性

• 预配置.NET Core环境：已集成指定版本的.NET Core运行时，无需额外安装即可直接运行.NET Core开发的代理应用。
• 入站请求处理能力：支持接收并处理外部入站请求，兼容HTTP、HTTPS等常见网络协议。
• 轻量级架构：基于精简基础镜像构建，体积小巧，资源占用低，适合容器化部署场景。
• 可扩展性：支持通过环境变量或配置文件自定义代理规则，便于功能扩展与业务适配。
• 跨平台兼容：支持在Linux等主流容器运行环境中稳定运行。

使用场景与适用范围

• .NET Core代理服务开发：适用于基于.NET Core框架开发的入站代理服务，简化开发与部署流程。
• 微服务入口层：可作为微服务架构的请求入口，集中接收外部请求并转发至内部服务，实现流量管理。
• 协议转换与流量过滤：用于处理特定协议的入站流量，如HTTP转RPC、请求过滤、负载均衡等场景。
• 开发测试环境：提供一致的运行环境，便于开发团队快速搭建和验证入站代理服务功能。

使用方法与配置说明

基本部署示例

通过docker run命令快速启动镜像：

bash
docker run -d \
  --name inbound-agent \
  -p 8080:8080 \  # 映射容器端口至主机
  -e PROXY_PORT=8080 \  # 代理服务监听端口
  -e TARGET_SERVICE=http://backend:80 \  # 目标服务地址
  your-image-name:tag  # 替换为实际镜像名称和标签

环境变量配置

支持以下环境变量自定义代理行为（具体参数以实际镜像版本为准）：

配置文件挂载

如需复杂配置，可通过卷挂载自定义配置文件：

bash
docker run -d \
  --name inbound-agent \
  -p 8080:8080 \
  -v /host/config:/app/config \  # 挂载本地配置文件目录
  your-image-name:tag

容器编排示例（Docker Compose）

使用docker-compose.yml配置服务：

yaml
version: '3'
services:
  inbound-agent:
    image: docker.xuanyuan.run/your-image-name:tag
    ports:
      - "8080:8080"
    environment:
      - PROXY_PORT=8080
      - TARGET_SERVICE=http://backend-service:80
    restart: unless-stopped

自定义代理应用部署

如需运行自定义.NET Core代理应用，可通过卷挂载应用文件：

bash
docker run -d \
  --name custom-agent \
  -p 8080:8080 \
  -v /host/app:/app \  # 挂载本地.NET Core应用
  your-image-name:tag \
  dotnet /app/YourProxyApp.dll  # 启动自定义应用