noenv/openjdk

docker-openjdk

https://github.com/NoEnv/docker-openjdk/actions/workflows/build.yml/badge.svg](https://github.com/NoEnv/docker-openjdk/actions/workflows/build.yml) https://github.com/NoEnv/docker-openjdk/actions/workflows/server.yml/badge.svg](https://github.com/NoEnv/docker-openjdk/actions/workflows/server.yml)

镜像概述与主要用途

noenv/openjdk 是由 NoEnv 维护的 OpenJDK 官方实现的 Docker 镜像，旨在为 Java 应用程序提供轻量、可靠且标准化的运行环境。该镜像基于 OpenJDK 官方源码构建，集成了必要的运行时依赖，适用于各类 Java 应用（包括控制台程序、Web 应用、微服务等）的容器化部署。

核心功能与特性

• 多版本与架构支持：提供 OpenJDK 各 LTS 版本（如 8、11、17 等），支持多种硬件架构（amd64、arm64、arm/v7 等），满足跨平台部署需求。
• 轻量级设计：基于 Alpine Linux 或 Debian Slim 基础镜像构建，减少冗余依赖，降低镜像体积（通常比官方默认镜像小 30%+）。
• 安全合规：定期同步上游 OpenJDK 安全更新，包含最新安全补丁，降低运行时漏洞风险。
• 灵活配置：支持通过环境变量自定义 JVM 参数、工作目录、用户权限等，适配不同应用需求。
• 持续集成保障：通过 GitHub Actions 自动化构建与测试，确保镜像质量与兼容性。

使用场景与适用范围

适用场景

• 开发/测试环境中 Java 应用的快速启动与调试
• 生产环境中微服务架构的 Java 服务容器化部署
• CI/CD 流水线中 Java 应用的构建、测试与运行环节
• 边缘计算或嵌入式设备中资源受限场景的 Java 运行时

适用范围

• 基于 Java SE 的控制台应用、工具程序
• 基于 Spring Boot、Micronaut 等框架的 Web 应用与微服务
• 需要标准化 Java 运行时的企业级应用
• 对镜像体积、启动速度有要求的轻量化部署需求

详细使用方法与配置说明

前提条件

• 已安装 Docker Engine（20.10+）或 Docker Desktop
• 熟悉 Docker 基本命令（docker run、docker-compose 等）

1. 获取镜像

从 Docker Hub 拉取最新版本（默认标签为 latest，对应最新 LTS 版本）：

bash
docker pull noenv/openjdk:latest

如需指定 Java 版本，可使用版本标签（如 Java 17）：

bash
docker pull noenv/openjdk:17

查看所有可用标签：https://hub.docker.com/r/noenv/openjdk/tags

2. 基本使用（Docker Run）

运行 Java 控制台应用

将本地 JAR 文件挂载到容器中并执行：

bash
docker run -it --rm \
  -v $(pwd)/my-app.jar:/app/app.jar \
  noenv/openjdk:17 \
  java -jar /app/app.jar

运行 Spring Boot 应用

通过环境变量传递 JVM 参数（如内存配置）：

bash
docker run -d --name spring-app \
  -p 8080:8080 \
  -v $(pwd)/app.jar:/app.jar \
  -e JAVA_OPTS="-Xms512m -Xmx1g -XX:+UseContainerSupport" \
  noenv/openjdk:17 \
  java $JAVA_OPTS -jar /app.jar

3. 编排部署（Docker Compose）

创建 docker-compose.yml 文件，定义服务配置：

yaml
version: '3.8'
services:
  java-app:
    image: noenv/openjdk:17
    container_name: java-app
    restart: always
    ports:
      - "8080:8080"
    volumes:
      - ./app:/app  # 挂载应用代码或配置文件
      - app-logs:/var/log/app  # 持久化日志
    environment:
      - JAVA_OPTS="-Xmx1g -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=/var/log/app/dump.hprof"
      - TZ=Asia/Shanghai  # 设置时区
    working_dir: /app
    command: java $JAVA_OPTS -jar app.jar

volumes:
  app-logs:  # 声明持久化卷

启动服务：

bash
docker-compose up -d

4. 配置参数与环境变量

5. 高级配置示例

非 Root 用户运行

为增强安全性，指定非 root 用户运行应用（需确保挂载目录权限）：

bash
docker run -it --rm \
  -v $(pwd)/app.jar:/app.jar \
  -u 1000:1000 \  # UID:GID，需与宿主机目录权限匹配
  noenv/openjdk:17 \
  java -jar /app.jar

自定义 JVM 日志输出

将 JVM 日志重定向到文件或标准输出：

bash
docker run -d \
  -e JAVA_OPTS="-XX:+PrintGCDetails -Xlog:gc*:file=/var/log/gc.log:time" \
  -v $(pwd)/logs:/var/log \
  noenv/openjdk:17 \
  java $JAVA_OPTS -jar /app.jar

注意事项

1. 版本兼容性：确保应用的 Java 版本与镜像标签匹配（如 Java 8 应用需使用 noenv/openjdk:8）。
2. 持久化数据：敏感数据（如配置文件、日志）建议通过 docker volume 或宿主机挂载持久化，避免容器删除后数据丢失。
3. 资源限制：生产环境中建议通过 --memory、--cpus 参数限制容器资源，避免 JVM 内存溢出。
4. 安全最佳实践：优先使用非 root 用户运行容器，通过 docker scan 定期检查镜像漏洞。

相关链接

• Docker Hub 镜像仓库：https://hub.docker.com/r/noenv/openjdk
• 源码与构建脚本：https://github.com/NoEnv/docker-openjdk
• OpenJDK 官方文档：[***]# docker-openjdk

https://github.com/NoEnv/docker-openjdk/actions/workflows/build.yml/badge.svg](https://github.com/NoEnv/docker-openjdk/actions/workflows/build.yml) https://github.com/NoEnv/docker-openjdk/actions/workflows/server.yml/badge.svg](https://github.com/NoEnv/docker-openjdk/actions/workflows/server.yml)

镜像概述与主要用途

noenv/openjdk 是由 NoEnv 维护的 OpenJDK 官方实现 Docker 镜像，旨在为 Java 应用提供轻量、可靠的标准化运行环境。该镜像基于 OpenJDK 源码构建，支持多版本、多架构部署，适用于开发、测试及生产环境中各类 Java 应用的容器化需求。

核心功能与特性

• 多版本支持：提供 Java 8、11、17 等 LTS 版本及最新稳定版，满足不同应用兼容性需求。
• 跨架构兼容：支持 amd64、arm64、arm/v7 等主流架构，适配服务器、边缘设备等多种硬件环境。
• 轻量级设计：基于 Alpine Linux 或 Debian Slim 基础镜像，减少冗余依赖，降低镜像体积。
• 安全更新：定期同步 OpenJDK 官方安全补丁，通过自动化构建确保漏洞修复及时性。
• 灵活配置：支持通过环境变量自定义 JVM 参数、用户权限及工作目录，适配复杂应用场景。
• CI/CD 集成：通过 GitHub Actions 自动化测试与构建，保障镜像质量与兼容性。

使用场景与适用范围

适用场景

• 开发/测试环境 Java 应用的快速启动与调试
• 生产环境微服务架构的 Java 服务容器化部署
• CI/CD 流水线中 Java 应用的构建、测试与运行环节
• 资源受限场景（如边缘计算）的 Java 运行时部署

适用范围

• Java SE 控制台应用、工具程序
• Spring Boot、Micronaut 等框架的 Web 应用与微服务
• 企业级 Java 应用的标准化运行时环境
• 对镜像体积、启动速度有要求的轻量化部署需求

详细使用方法与配置说明

前提条件

• Docker Engine 20.10+ 或 Docker Desktop
• 基础 Docker 命令操作能力（docker run、docker-compose）

1. 获取镜像

拉取最新版本（默认对应最新 LTS 版本）：

bash
docker pull noenv/openjdk:latest

指定 Java 版本（如 Java 17）：

bash
docker pull noenv/openjdk:17

查看所有可用标签：https://hub.docker.com/r/noenv/openjdk/tags

2. 基础使用（Docker Run）

运行 JAR 应用

挂载本地 JAR 文件并执行：

bash
docker run -it --rm \
  -v $(pwd)/app.jar:/app/app.jar \
  noenv/openjdk:17 \
  java -jar /app/app.jar

自定义 JVM 参数

通过环境变量传递内存配置等参数：

bash
docker run -d --name java-service \
  -p 8080:8080 \
  -v $(pwd)/app.jar:/app.jar \
  -e JAVA_OPTS="-Xms512m -Xmx1g -XX:+UseContainerSupport" \
  noenv/openjdk:17 \
  java $JAVA_OPTS -jar /app.jar

3. 编排部署（Docker Compose）

创建 docker-compose.yml 配置文件：

yaml
version: '3.8'
services:
  java-app:
    image: noenv/openjdk:17
    container_name: java-app
    restart: always
    ports:
      - "8080:8080"
    volumes:
      - ./app:/app                  # 挂载应用代码/配置
      - app-logs:/var/log/app       # 持久化日志
    environment:
      - JAVA_OPTS="-Xmx1g -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=/var/log/app/dump.hprof"
      - TZ=Asia/Shanghai            # 设置时区
    working_dir: /app
    command: java $JAVA_OPTS -jar app.jar

volumes:
  app-logs:  # 声明持久化卷

启动服务：

bash
docker-compose up -d

4. 配置参数与环境变量

注意事项

1. 版本匹配：确保应用 Java 版本与镜像标签一致（如 Java 8 应用需使用 noenv/openjdk:8）。
2. 数据持久化：配置文件、日志等重要数据建议通过 docker volume 或宿主机挂载持久化。
3. 资源限制：生产环境建议通过 --memory、--cpus 参数限制容器资源，避免 JVM 内存溢出。
4. 安全最佳实践：优先使用非 root 用户运行容器（通过 -u 参数指定 UID/GID），降低权限风险。

相关链接

• Docker Hub 仓库：https://hub.docker.com/r/noenv/openjdk
• 源码与构建脚本：https://github.com/NoEnv/docker-openjdk
• OpenJDK 官方文档：[***]