应选带版本号和平台标识的 eclipse-temurin 或 amazoncorretto 镜像（如 eclipse-temurin:17-jre-jammy），并确保架构匹配、权限正确、时区与编码配置到位、java 前台运行。
Java 版本选哪个？别直接拉 latest
群晖 Docker 里跑 Java，最常踩的坑是镜像版本和宿主机架构不匹配，比如在 x86_64 机器上拉了 arm64v8/openjdk:17，容器根本起不来；或者用了 openjdk:latest，结果某天更新后 JDK 突然变成 21，应用因 UnsupportedClassVersionError 直接崩溃。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 查清你的群晖 CPU 架构：DSM → 控制面板 → 信息中心 → 系统架构（常见为
x86_64或arm64） - 固定使用带版本号和平台标识的镜像，例如：
eclipse-temurin:17-jre-jammy（Debian 基础，x86_64 通用）或eclipse-temurin:17-jre-focal（Ubuntu 20.04 基础，兼容性更广） - 避免
openjdk官方镜像（已归档），优先用eclipse-temurin或amazoncorretto，它们对 ARM 支持更稳定
挂载目录权限问题：/workspace 权限拒绝？
Java 应用（比如 Spring Boot 的 jar 文件）放在群晖共享文件夹里，Docker 容器一启动就报 java.io.FileNotFoundException: /workspace/app.jar (Permission denied)——这不是 Java 错，是 Linux 用户权限映射没对上。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 不要用 DSM 图形界面直接“添加文件夹”进容器，而是在 Docker → 映像 → 启动 → 卷 → 手动填写路径，格式为：
/volume1/docker/java-app:/workspace:ro - 确保宿主机上该路径（如
/volume1/docker/java-app）的群组是users，且权限设为755（DSM 中右键文件夹 → 属性 → 权限 → 编辑） - 容器内默认用户是
root，但某些精简镜像（如temurin）会切到非 root 用户（1001），此时需加启动参数：--user 0:0或在 DSM 的“高级设置”→“用户定义的 UID/GID”填0
时区、编码、中文乱码怎么一次性搞定？
Spring Boot 日志时间全是 UTC、控制台输出中文变问号、读取配置文件时 UTF-8 字符解析失败——这些不是代码问题，是容器环境缺失基础 locale 配置。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 启动容器时必须加环境变量：
-e TZ=Asia/Shanghai -e LANG=C.UTF-8 -e LANGUAGE=en_US:zh_CN - 如果用 DSM Web 界面配置，进“高级设置”→“环境变量”，逐条添加，值别漏引号（DSM 会自动加）
- 不推荐在 Dockerfile 里改
/etc/timezone，因为群晖的容器运行时机制会覆盖它；硬编码时区比依赖系统同步更可靠 - Java 启动参数也要同步补上：
-Dfile.encoding=UTF-8 -Duser.timezone=GMT+08，尤其当应用自己解析时间或读写文本时
如何让 Java 进程真正被 Docker 管理？别用 nohup &
有人把 java -jar app.jar & 写进启动脚本，结果容器状态显示“已运行”，但 docker logs 为空，重启后 Java 进程消失——这是因为 Docker 只监控 PID 1 进程，& 启动的子进程脱离了生命周期管理。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 启动命令必须是前台执行，禁止
&、nohup、screen；正确写法：java -Dfile.encoding=UTF-8 -jar /workspace/app.jar - 若需 JVM 参数调优，统一写在 CMD 中，不要拆成多个 shell 命令
- 想加健康检查？在 DSM “高级设置”→“健康检查”里填：
curl -f http://localhost:8080/actuator/health || exit 1（前提是应用暴露了 endpoint） - 日志别重定向到文件（如
> /var/log/app.log），Docker 默认捕获 stdout/stderr；要用 logback 就配ConsoleAppender
Java 在群晖 Docker 里不是装上就能跑，关键在环境对齐：架构、权限、时区、进程模型，四者错一个，都会表现为“启动了但不工作”。尤其是挂载路径的权限和用户映射，最容易被 DSM 界面的简化操作掩盖。
