Arthas 3.5.0 版本发布，支持反编译打印行号和统一鉴权

Arthas是 Alibaba 开源的 Java 诊断工具，深受开发者喜爱。

• Github： https://github.com/alibaba/arthas
• 文档：https://arthas.aliyun.com/doc/

Arthas 最新发布了 3.5.0 版本，最近几个 release 版本带来下面两个主要特性：

• 反编译支持行号
• Telnet/Websocket/HTTP API 统一支持全面的鉴权

反编译支持行号

Arthas 开源之后的第一个 issue 就是jad命令能否支持显示行号：

• https://github.com/alibaba/arthas/issues/1

jad命令多年以后终于支持行号了，“不忘初心”😂，效果如下：

$ jad demo.MathGame main

       public class MathGame {
           private static Random random = new Random();
           public int illegalArgumentCount = 0;

           public static void main(String[] args) throws InterruptedException {
               MathGame game = new MathGame();
               while (true) {
/*16*/             game.run();
/*17*/             TimeUnit.SECONDS.sleep(1L);
               }
           }

           public void run() throws InterruptedException {
               try {
/*23*/             int number = random.nextInt() / 10000;
/*24*/             List<Integer> primeFactors = this.primeFactors(number);
/*25*/             MathGame.print(number, primeFactors);
               }
               catch (Exception e) {
/*28*/             System.out.println(String.format("illegalArgumentCount:%3d, ", this.illegalArgumentCount) + e.getMessage());
               }
           }

           public static void print(int number, List<Integer> primeFactors) {
               StringBuffer sb = new StringBuffer(number + "=");
/*34*/         for (int factor : primeFactors) {
/*35*/             sb.append(factor).append('*');
               }
/*37*/         if (sb.charAt(sb.length() - 1) == '*') {
/*38*/             sb.deleteCharAt(sb.length() - 1);
               }

如果想不显示行号，使用--lineNumber false参数即可。

鉴权支持

鉴权主要通过两方面来支持：

• as.sh/arthas-boot命令行参数支持配置用户名和密码
• 增加auth命令

配置用户名和密码

在 Arthas attach 时，可以在命令行指定密码。比如：

java -jar arthas-boot.jar --password ppp

• 可以通过 --username 选项来指定用户，默认值是arthas。

• 也可以在 arthas.properties 里中配置 username/password 。命令行的优先级大于配置文件。

• 如果只配置username，没有配置password，则会生成随机密码，打印在~/logs/arthas/arthas.log中

  Using generated security password: 0vUBJpRIppkKuZ7dYzYqOKtranj4unGh
  

在 telnet console 里鉴权

连接到 arthas 后，直接执行命令会提示需要鉴权：

[arthas@37430]$ help
Error! command not permitted, try to use 'auth' command to authenticates.

使用auth命令来鉴权，成功之后可以执行其它命令。

[arthas@37430]$ auth ppp
Authentication result: true

• 可以通过 --username 选项来指定用户，默认值是arthas。

Web console 密码验证

打开浏览器，会有弹窗提示需要输入 用户名 和 密码。

成功之后，则可以直接连接上 web console 。

HTTP API 验证

Arthas 采用的是 HTTP 标准的 Basic Authorization，客户端请求时增加对应的 Authorization header 即可。

• 参考：https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication

例如，用户名是：admin，密码是 admin，则组合为字符串： admin:admin，base64 结果是： YWRtaW46YWRtaW4=，则 HTTP 请求增加Authorization header：

curl 'http://localhost:8563/api' \
  -H 'Authorization: Basic YWRtaW46YWRtaW4=' \
  --data-raw '{"action":"exec","command":"version"}' 

总结

• Jad wiki: https://arthas.aliyun.com/doc/jad.html
• Auth wiki: https://arthas.aliyun.com/doc/auth.html
• Release 日志: https://github.com/alibaba/arthas/releases/tag/arthas-all-3.5.0

招聘

最后打个广告，我们正在寻找小伙伴，特别是深圳的同学，欢迎大家加入。

• 阿里云-云原生-中间件招聘（深圳 /杭州）