先に結論
npm run <スクリプト> -- --token=<キー> のように、npm run の引数で API キーを渡すと、手元の npm 11.21.1 では次の3か所に平文で出ました。
| 出る場所 | 出たか | 消し方 |
|---|---|---|
ターミナル(> node deploy.js --token=... の行) |
出た |
--silent(--loglevel=silent) |
デバッグログ(既定は ~/.npm/_logs/*-debug-0.log) |
成功しても出た | --logs-max=0 |
実行中の ps(npm・sh・node の3プロセス) |
出た | 引数で渡さない |
npm_ で始まる npm トークンと、URL に書いた Basic 認証のパスワードは *** に置き換わりましたが、それ以外の形のキー(今回は sk-test-... のダミー)はそのままでした。
一番安全だったのは、キーを引数に書かず、環境変数のままスクリプトに読ませる書き方です(ログ・画面・ps のどこにも出ませんでした)。
使った値はすべてダミーです。
環境
- Linux、Node.js v24.22.1、npm 11.21.1
- ログの場所を確かめやすいように、検証中は
NPM_CONFIG_LOGS_DIRで作業フォルダに向けました(既定の場所は後述)
{
"name": "demo-argv",
"version": "1.0.0",
"private": true,
"scripts": {
"deploy": "node deploy.js",
"deploy:env": "node deploy.js --token=$DEMO_TOKEN",
"deploy:safe": "node deploy-env.js",
"wait": "node sleep.js"
}
}
console.log("deploy ok, args=", process.argv.length - 2)
const t = process.env.DEMO_TOKEN; console.log("deploy ok, token set:", Boolean(t))
1. 引数で渡すと、画面とログファイルの両方に出る
$ npm run deploy -- --token=sk-test-DUMMY0123456789
> demo-argv@1.0.0 deploy
> node deploy.js --token=sk-test-DUMMY0123456789
deploy ok, args= 1
npm はスクリプトを動かす前に、実行するコマンド行を > 付きで表示します。-- のあとの引数もここに入るので、キーがそのまま出ました。CI のログに残るのはこの行です。
そして、コマンドが成功してもデバッグログのファイルが作られ、そこにも入っていました。
7 verbose title npm run deploy --token=sk-test-DUMMY0123456789
8 verbose argv "run" "deploy" "--" "--token=sk-test-DUMMY0123456789"
9 verbose logfile logs-max:10 dir:.../2026-11-20T20_15_10_268Z-
16 verbose exit 0
exit 0 でも書かれていて、logs-max:10 のとおり最新10回分が残ります。公式ドキュメント(Logging)にも「すべてのログはデバッグログに書かれる」「既定の場所は npm キャッシュの中の _logs」とあります。手元のキャッシュは npm config get cache で ~/.npm だったので、既定なら ~/.npm/_logs/ です。
2. npm トークンと URL のパスワードだけは伏せ字になった
$ npm run deploy -- --token=npm_AbCdEfGhIjKlMnOpQrStUvWxYz0123456789
> node deploy.js --token=npm_***
$ npm run deploy -- --url=https://user:sk-test-DUMMYurl555@example.com/x
> node deploy.js --url=https://user:***@example.com/x
公式ドキュメントの「Logs and Sensitive Information」には、伏せる対象は「basic 認証 URL のパスワード」と「npm トークン」で、ベストエフォートだから頼らないように、と書かれています。実際、sk-test-... のような他サービス風のキーは1章のとおり伏せられませんでした。
3. --silent だけでは、ログファイルには残る
$ npm run --loglevel=silent deploy -- --token=sk-test-DUMMYsilent111
deploy ok, args= 1
画面の > 行は消えました。ところがログファイルは1つ作られていて、中身はこうでした。
8 verbose argv "run" "--loglevel" "silent" "deploy" "--" "--token=sk-test-DUMMYsilent111"
画面が静かになったので消えたと思いがちですが、ファイル側は別でした。ここが今回いちばん意外だった点です。
4. --logs-max=0 を足すと書かれない(既存のログも消えた)
$ ls repro_logs | wc -l
1
$ npm run --loglevel=silent --logs-max=0 deploy -- --token=sk-test-DUMMYboth222
deploy ok, args= 1
$ ls repro_logs | wc -l
0
新しいログは作られず、それまであった1件も消えていました。公式ドキュメントでは --logs-max=0 は「ログを完全に止める」設定で、--loglevel=silent と組み合わせるよう案内されています。古いログが消えたのは手元で見た挙動で、ドキュメントの「上限を超えたら古い順に消す」動きが 0 件に対して働いたのだと思います(推測)。調査用にログを残しておきたい場合は注意が必要です。
5. 実行中は ps にも3つ並ぶ
$ ps -eo args | grep DUMMYps444
npm run wait --token=sk-test-DUMMYps444
sh -c node sleep.js --token=sk-test-DUMMYps444
/usr/local/lib/nodejs/node sleep.js --token=sk-test-DUMMYps444
npm 本体のプロセス名、間に入る sh -c、実際の node の3つすべてに入りました。同じマシンの別ユーザーから見える点は、コマンド引数一般の話として以前の記事(https://qiita.com/supportapp3/items/cd1f04df4b681507e3e1 )で確かめたとおりです。
--silent --logs-max=0 は画面とファイルには効きますが、ここは消せません。
6. package.json に $DEMO_TOKEN と書く場合
$ DEMO_TOKEN=sk-test-DUMMYenv999 npm run deploy:env
> node deploy.js --token=$DEMO_TOKEN
画面の > 行は展開前の $DEMO_TOKEN のままで、npm の argv にも入らないのでログファイルにも出ませんでした。ただし展開するのは間の sh なので、実行中の node は ps 上で node deploy.js --token=sk-test-DUMMYenv999 と展開後の値になっていました。
7. 出なかった書き方:環境変数をスクリプトで直接読む
$ DEMO_TOKEN=sk-test-DUMMYsafe333 npm run deploy:safe
> node deploy-env.js
deploy ok, token set: true
$ grep -c DUMMYsafe333 repro_logs/*
(0件)
process.env.DEMO_TOKEN をスクリプトの中で読むだけなら、画面・ログファイル・ps の引数のどこにもキーは出ませんでした。CI ならシークレットを環境変数に入れて、この形で読ませるのが手堅いと考えます。
すでに引数で渡していた場合
# 自分のログに残っていないか(既定の場所)
grep -l -- '--token=' ~/.npm/_logs/*.log
# CI で一時的に止めるなら
npm run --silent --logs-max=0 deploy
見つかったキーは、ログを消すより先に発行元で無効化して作り直すのが確実です。CI の画面ログは、npm の外(CI 側)に保存されているので、そちらの削除も必要です。
まとめ
-
npm run x -- --token=キーは、画面・~/.npm/_logsのデバッグログ(成功時も)・ps の3か所に出た - 伏せ字になるのは npm トークンと URL のパスワードだけ(公式にもベストエフォートと明記)
-
--silentは画面だけ。ファイルも止めるには--logs-max=0(手元では既存ログも消えた) - キーは引数にせず、環境変数をスクリプトで読む
参考
- npm Docs「Logging」 https://docs.npmjs.com/cli/v11/using-npm/logging
- npm Docs「config」logs-dir / logs-max https://docs.npmjs.com/cli/v11/using-npm/config