如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具,协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题,请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可:
请先完整阅读并严格遵守以下文档中的全部规则与要求:
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前,不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式,不推荐豆包 AI;Cursor 等编辑器可在对话 @ 该链接,或加入 User Rules。 若 AI 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
该镜像基于CentOS操作系统,提供OpenJDK 11 (JDK)开发环境,专为Java应用的容器化部署设计。
主要包含以下核心组件:
/deployments/run-java.sh:优化容器环境下Java应用的启动流程,支持fat-jars和主类两种启动方式。需将此镜像作为基础镜像(通过FROM指令),并在应用启动脚本中集成agent-bond-opts输出的JVM参数。示例:
bash# 在应用启动脚本中添加 export JAVA_OPTIONS="$JAVA_OPTIONS $(agent-bond-opts)" # 启动应用时使用JAVA_OPTIONS(如Tomcat)
Agent Bond通用选项
| 环境变量 | 描述 | 默认值 |
|---|---|---|
| AB_OFF | 设置后禁用agent-bond(输出空值) | 未设置(启用) |
| AB_ENABLED | 启用的子代理列表(逗号分隔),允许值:jolokia、jmx_exporter | jolokia,jmx_exporter |
Jolokia专项配置
| 环境变量 | 描述 | 默认值 |
|---|---|---|
| AB_JOLOKIA_CONFIG | Jolokia配置文件路径 | /opt/jolokia/jolokia.properties |
| AB_JOLOKIA_HOST | 绑定主机地址 | 0.0.0.0 |
| AB_JOLOKIA_PORT | 监听端口 | 8778 |
| AB_JOLOKIA_USER | 认证用户名(默认关闭认证) | 未设置 |
| AB_JOLOKIA_HTTPS | 启用HTTPS(默认生成自签名证书) | 未设置(HTTP) |
| AB_JOLOKIA_PASSWORD | 认证密码(默认关闭认证) | 未设置 |
| AB_JOLOKIA_ID | 代理ID | $HOSTNAME(容器ID) |
| AB_JOLOKIA_OPTS | 附加选项(格式:key=value,key=value) | 未设置 |
| AB_JOLOKIA_AUTH_OPENSHIFT | OpenShift TLS客户端认证(值为证书中的相对可分辨名称) | 未设置 |
jmx_exporter专项配置
| 环境变量 | 描述 | 默认值 |
|---|---|---|
| AB_JMX_EXPORTER_OPTS | 配置格式:<port>:<配置路径> | 未设置 |
| AB_JMX_EXPORTER_PORT | 监听端口 | 9779 |
| AB_JMX_EXPORTER_CONFIG | 配置文件路径 | /opt/agent-bond/jmx_exporter_config.json |
默认命令为/deployments/run-java.sh,用于容器环境下Java应用的标准化启动,支持:
bash./run-java.sh <子命令> <选项>
子命令
| 子命令 | 描述 |
|---|---|
run | 启动Java应用(默认子命令,可省略) |
options | 输出JVM选项(用于自定义启动,如Maven) |
run子命令)通过环境变量配置启动行为,核心参数如下:
应用路径与类路径
| 环境变量 | 描述 | 默认值 |
|---|---|---|
| JAVA_APP_DIR | 应用根目录 | 脚本所在目录 |
| JAVA_LIB_DIR | jar文件目录(含classpath文件) | $JAVA_APP_DIR |
| JAVA_CLASSPATH | 显式类路径 | 自动生成(见下文) |
| JAVA_MAIN_CLASS | 主类名(启用时添加所有jar到类路径) | 未设置 |
| JAVA_APP_JAR | 可执行jar路径(java -jar启动) | 自动检测($JAVA_APP_DIR下单个jar) |
JVM资源配置
| 环境变量 | 描述 | 默认值 |
|---|---|---|
| JAVA_OPTIONS | 附加JVM参数 | 未设置 |
| JAVA_MAJOR_VERSION | Java主版本(影响参数兼容性) | 自动检测 |
| JAVA_MAX_MEM_RATIO | 容器内存占比(计算-Xmx) | <300M时25,否则50 |
| JAVA_INIT_MEM_RATIO | 容器内存占比(计算-Xms) | 未设置 |
| JAVA_MAX_CORE | 限制核心数(影响GC线程等) | 自动检测 |
调试与诊断
| 环境变量 | 描述 | 默认值 |
|---|---|---|
| JAVA_DEBUG | 启用远程调试 | 未设置 |
| JAVA_DEBUG_SUSPEND | 调试挂起模式 | 未设置 |
| JAVA_DEBUG_PORT | 调试端口 | 5005 |
| JAVA_DIAGNOSTICS | 输出诊断信息 | 未设置 |
代理配置
| 环境变量 | 描述 |
|---|---|
| HTTP_PROXY | HTTP代理(转换为http.proxyHost/Port) |
| HTTPS_PROXY | HTTPS代理(转换为https.proxyHost/Port) |
| no_proxy/NO_PROXY | 非代理主机(转换为http.nonProxyHosts) |
JAVA_CLASSPATH,直接使用.)JAVA_APP_DIR,添加JAVA_APP_DIRJAVA_MAIN_CLASS:
JAVA_APP_JAR(若设置)$JAVA_APP_DIR/classpath文件存在,追加其内容(单行冒号分隔或每行一个jar路径)$JAVA_APP_DIR/*(所有jar按字母顺序)bash# 设置应用目录 export JAVA_APP_DIR=/deployments # 配置JVM最大内存为容器内存的40% export JAVA_MAX_MEM_RATIO=40 # 启动应用并传入参数 ./run-java.sh --user maxmorlock --password secret
options子命令)用于为其他Java应用(如Maven)提供容器优化的JVM参数,支持以下选项:
| 选项 | 描述 |
|---|---|
--debug | 调试选项(需JAVA_DEBUG) |
--memory | 内存配置 |
--proxy | 代理配置 |
--cpu | CPU核心调优 |
--gc | GC参数 |
--jit | JIT选项 |
--diagnostics | 诊断选项(需JAVA_DIAGNOSTICS) |
--java-default | 组合选项:--memory --jit --diagnostics --cpu --gc |
示例:为Maven配置容器优化参数
bashexport MAVEN_OPTS="$(run-java.sh options --memory)" mvn clean install
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。

来自真实用户的反馈,见证轩辕镜像的优质服务