Dockerfile中添加ngrok命令失败：无法识别config子命令

问题 #

在Dockerfile中添加RUN ngrok config add-authtoken ${NGROK_TOKEN}命令后，执行docker build时触发错误，提示Unrecognized command: config，从错误输出可确认当前使用的ngrok版本为2.3.41。

错误原因 #

ngrok 2.x版本不支持config子命令，配置authtoken的正确命令为直接使用authtoken，而ngrok config add-authtoken是ngrok 3.x版本的语法。

解决方案 #

有两种处理方式：

方式1：适配ngrok 2.x版本 #

将报错的RUN命令替换为2.x版本支持的命令：

RUN ngrok authtoken ${NGROK_TOKEN}

方式2：升级到ngrok 3.x版本 #

如果需要使用3.x的新特性，可以在安装时指定最新版本：

RUN npm install -g \
   ngrok@latest \
   pm2 \
   typescript

升级后原ngrok config add-authtoken ${NGROK_TOKEN}命令即可正常使用，但需注意3.x版本的其他命令语法可能与2.x存在差异。

修改后的完整Dockerfile示例 #

FROM node:16

ARG NGROK_TOKEN

RUN npm install -g \
   ngrok \
   pm2 \
   typescript

WORKDIR /app

RUN ngrok authtoken ${NGROK_TOKEN} # 已修正命令

# ...内容后续省略...

执行的build命令保持不变：

docker build --file="./Dockerfile" --build-arg="NGROK_TOKEN=abc" .

内容的提问来源于stack exchange，提问作者passionateLearner