hengyunabc/arthas
hengyunabc
阿里巴巴Java诊断工具Arthas，用于Java应用的问题排查与性能分析等诊断场景，提供专业高效的诊断能力。
40 次收藏下载次数: 0状态：社区镜像维护者：hengyunabc仓库类型：镜像最近更新：8 个月前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 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 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
Arthas Docker镜像文档
一、镜像概述与主要用途
1.1 镜像简介
Arthas（Alibaba Java诊断利器）是由阿里巴巴开发的一款开源Java诊断工具，旨在帮助开发者在线诊断Java应用运行时问题，无需重启应用即可实现故障排查、性能分析等功能。本Docker镜像封装了Arthas工具及演示应用，提供便捷的容器化部署与使用方式。
1.2 主要用途
- 实时诊断Java应用运行时异常与故障
- 分析Java应用性能瓶颈（如CPU、内存、线程问题）
- 监控方法执行流程与入参/返回值
- 动态修改类代码（热更新）以快速验证修复方案
- 查看JVM运行时状态与配置信息
二、核心功能与特性
2.1 核心功能
- 在线诊断：无需重启应用，通过命令行交互实时诊断
- JVM监控：查看JVM内存、GC、类加载、线程等信息（如
jvm、thread命令） - 方法追踪：监控指定方法的调用次数、耗时、入参/返回值（如
trace、watch命令） - 热更新支持：动态替换已加载类的字节码（如
redefine命令） - 类反编译：实时反编译已加载类文件（如
jad命令） - 性能分析：生成火焰图分析CPU热点（如
profiler命令）
2.2 特性优势
- 轻量级：无需依赖额外组件，直接附着于目标JVM进程
- 跨平台：支持所有基于JVM的Java应用（JDK 6+）
- 安全性：通过本地进程附着，避免远程诊断风险
- 丰富命令集：提供20+诊断命令，覆盖各类诊断场景
三、使用场景与适用范围
3.1 典型使用场景
- 线上故障排查：生产环境Java应用无响应、异常抛出等问题定位
- 性能瓶颈分析：CPU使用率过高、内存泄漏、线程阻塞等性能问题诊断
- 开发调试辅助：本地/测试环境快速验证代码逻辑、复现线上问题
- 版本兼容性验证：动态修改类代码验证修复方案，无需重新部署应用
3.2 适用范围
- 所有基于JVM的Java应用（包括Spring Boot、Dubbo、Tomcat等框架）
- 开发、测试、生产环境均可使用（生产环境建议限制权限）
- 支持Linux/macOS/Windows（容器化部署推荐Linux环境）
四、使用方法与配置说明
4.1 环境要求
- Docker Engine 1.13.0+
- 目标Java应用需运行在JVM 6+环境
4.2 快速启动与使用
4.2.1 步骤1：启动Arthas演示应用（arthas-demo）
首先停止并删除可能存在的旧容器（若首次使用可跳过此步）：
shdocker stop arthas-demo || true && docker rm arthas-demo || true
启动包含演示应用的容器：
shdocker run --name arthas-demo -it docker.xuanyuan.run/hengyunabc/arthas:latest /bin/sh -c "java -jar /opt/arthas/arthas-demo.jar"
说明：
arthas-demo.jar为Arthas提供的演示Java应用，用于模拟待诊断的目标应用。
4.2.2 步骤2：启动Arthas诊断工具（arthas-boot）
通过docker exec进入运行中的arthas-demo容器，并启动Arthas：
shdocker exec -it arthas-demo /bin/sh -c "java -jar /opt/arthas/arthas-boot.jar"
执行后，Arthas会自动检测容器内的Java进程，输出类似以下内容：
* [1]: 9 jar [INFO] arthas home: /opt/arthas [INFO] Try to attach process 9 [INFO] Attach process 9 success. [INFO] arthas-client connect 127.0.0.1 3658 ,---. ,------. ,--------.,--. ,--. ,---. ,---. / O \ | .--. ''--. .--'| '--' | / O \ ' .-' | .-. || '--'.' | | | .--. || .-. |`. `-. | | | || |\ \ | | | | | || | | |.-' | `--' `--'`--' '--' `--' `--' `--'`--' `--'`-----' wiki: https://alibaba.github.io/arthas version: 3.0.5 pid: 9 time: 2018-12-18 11:30:36
此时已成功进入Arthas交互终端，可直接输入诊断命令（如thread查看线程、jad com.example.demo.DemoController反编译类）。
4.3 配置说明
本镜像默认配置如下：
- Arthas安装路径：
/opt/arthas - 演示应用路径：
/opt/arthas/arthas-demo.jar - 默认端口：3658（Arthas客户端连接端口，无需手动暴露，通过
docker exec本地访问）
如需自定义配置（如修改端口、日志级别），可通过启动容器时添加环境变量或命令参数实现，具体参考https://alibaba.github.io/arthas/%E3%80%82
五、参考资料
- 官方GitHub仓库：https://github.com/alibaba/arthas
- 官方文档：https://alibaba.github.io/arthas/
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull hengyunabc/arthas:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"