hengyunabc/arthas Docker Image Overview

hengyunabc/arthas

阿里巴巴Java诊断工具Arthas，用于Java应用的问题排查与性能分析等诊断场景，提供专业高效的诊断能力。

40 收藏0 次下载

🔒 更安全的专业镜像服务

中文简介版本下载

🔒 更安全的专业镜像服务

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）

首先停止并删除可能存在的旧容器（若首次使用可跳过此步）：

sh
docker stop arthas-demo || true && docker rm arthas-demo || true

启动包含演示应用的容器：

sh
docker run --name arthas-demo -it 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：

sh
docker 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: [***]
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本地访问）

如需自定义配置（如修改端口、日志级别），可通过启动容器时添加环境变量或命令参数实现，具体参考官方文档。

五、参考资料

官方GitHub仓库：[***]
官方文档：[***]

轩辕镜像配置手册

探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式

登录仓库拉取

通过 Docker 登录认证访问私有仓库

Linux

在 Linux 系统配置镜像服务

Windows/Mac

在 Docker Desktop 配置镜像

Docker Compose

Docker Compose 项目配置

K8s Containerd

Kubernetes 集群配置 Containerd

K3s

K3s 轻量级 Kubernetes 镜像加速

Dev Containers

VS Code Dev Containers 配置

MacOS OrbStack

MacOS OrbStack 容器配置

宝塔面板

在宝塔面板一键配置镜像

群晖

Synology 群晖 NAS 配置

飞牛

飞牛 fnOS 系统配置镜像

极空间

极空间 NAS 系统配置服务

爱快路由

爱快 iKuai 路由系统配置

绿联

绿联 NAS 系统配置镜像

威联通

QNAP 威联通 NAS 配置

Podman

Podman 容器引擎配置

Singularity/Apptainer

HPC 科学计算容器配置

其他仓库配置

ghcr、Quay、nvcr 等镜像仓库

专属域名拉取

无需登录使用专属域名

需要其他帮助？请查看我们的常见问题Docker 镜像访问常见问题解答或提交工单

镜像拉取常见问题

轩辕镜像免费版与专业版有什么区别？

免费版仅支持 Docker Hub 访问，不承诺可用性和速度；专业版支持更多镜像源，保证可用性和稳定速度，提供优先客服响应。

轩辕镜像支持哪些镜像仓库？

专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等；免费版仅支持 docker.io。

流量耗尽错误提示

当返回 402 Payment Required 错误时，表示流量已耗尽，需要充值流量包以恢复服务。

410 错误问题

通常由 Docker 版本过低导致，需要升级到 20.x 或更高版本以支持 V2 协议。

manifest unknown 错误

先检查 Docker 版本，版本过低则升级；版本正常则验证镜像信息是否正确。

镜像拉取成功后，如何去掉轩辕镜像域名前缀？

使用 docker tag 命令为镜像打上新标签，去掉域名前缀，使镜像名称更简洁。

查看全部问题→

用户好评

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

oldzhang

运维工程师

Linux服务器

"Docker访问体验非常流畅，大镜像也能快速完成下载。"