szopen/openjdk

szopen/openjdk 镜像文档

镜像概述

szopen/openjdk 是基于官方 OpenJDK 构建的 Docker 镜像，主要解决 Java 应用在运行时的中文显示乱码问题及时区配置问题。该镜像预装常用中文字体，并默认将时区设置为东八区（Asia/Shanghai），确保应用在中文环境下正常运行。

核心功能与特性

• 中文字体支持：预装宋体（SimSun.ttf、simsun.ttc）及 arialuni.ttf 等中文字体，解决中文显示乱码问题
• 时区配置：默认设置时区为 Asia/Shanghai（+8），无需额外配置时区
• 多版本支持：提供 OpenJDK 8 和 11 版本，满足不同应用需求
• 兼容性：基于官方 OpenJDK 镜像构建，保持与官方镜像的兼容性

支持的标签

使用场景

• 需要生成含中文内容的报表、PDF、图片的 Java 应用
• 日志输出包含中文的 Java 服务
• 对时区敏感的应用（如定时任务、时间戳记录等）
• 需在容器环境中快速部署且依赖中文字体的 Java 项目

使用方法

基本使用（docker run）

运行一个简单的 Java 应用：

bash
docker run -d --name my-java-app \
  -v /path/to/your/app.jar:/app.jar \
  szopen/openjdk:latest \
  java -jar /app.jar

Docker Compose 配置

创建 docker-compose.yml 文件：

yaml
version: '3'
services:
  app:
    image: szopen/openjdk:11-jdk-cn
    container_name: java-app
    volumes:
      - ./app.jar:/app.jar
    command: java -jar /app.jar
    restart: always

启动服务：

bash
docker-compose up -d

配置说明

字体文件

镜像预装以下中文字体，位于 /usr/share/fonts 目录：

• arialuni.ttf
• simsun.ttc
• SimSun.ttf

时区配置

通过以下操作设置时区：

dockerfile
# 复制上海时区文件
/bin/cp /usr/share/zoneinfo/Asia/Shanghai /etc/localtime
# 设置时区环境变量
echo 'Asia/Shanghai' >/etc/timezone

字符集设置

默认字符集为 C.UTF-8，通过环境变量 LANG=C.UTF-8 配置。

Dockerfile 参考

镜像基于官方 OpenJDK 镜像构建，核心 Dockerfile 示例（以 11-jdk-cn 为例）：

dockerfile
FROM openjdk:11-jdk-stretch
ENV LANG C.UTF-8
COPY fonts /usr/share/fonts
RUN /bin/cp /usr/share/zoneinfo/Asia/Shanghai /etc/localtime && echo 'Asia/Shanghai' >/etc/timezone

更多版本的 Dockerfile 可参考：https://github.com/opensz/docker-lib/tree/master/openjdk