← 返回登录

ITDOG COMMUNITY · CLI

在命令行使用 ITDOG

用个人密钥登录 CLI，不需要在命令行输入账号密码，也不会影响浏览器登录。

准备

下载 CLI 并安装 Node.js

CLI 是一个 JavaScript 文件，不需要安装额外 npm 包。运行环境需要 Node.js；建议安装当前的 LTS 版本。

下载 itdog-cli.mjs ↓

前往 Node.js 官网下载 LTS。安装后在终端运行 node -v 确认安装成功。

01

生成命令行密钥

  1. 先在浏览器登录 ITDOG 普通权限账号。
  2. 打开个人设置，找到“命令行登录”，点击“生成命令行密钥”。
  3. 复制新密钥。它只显示这一次；请像密码一样保管，不要发给他人或贴到公开仓库。

命令行密钥仅对普通权限账号开放，有效期 365 天。超级管理员目前不能使用 CLI 登录。

02

登录 CLI

把下载的文件放到终端当前目录，在 macOS、Linux 或 Windows Terminal 中运行：

node itdog-cli.mjs auth login

按提示粘贴刚生成的密钥并回车。输入时屏幕不会显示密钥；CLI 会将它保存在当前操作系统账号的本地配置目录中。

03

查看登录状态并调用 API

node itdog-cli.mjs auth status
node itdog-cli.mjs api GET /api/me

CLI 会以你的普通用户身份调用 ITDOG API，并遵循该账号现有权限。带请求体的示例：

node itdog-cli.mjs api POST /api/posts '{"title":"我的帖子","content":"从 CLI 发布"}'
04

退出或撤销密钥

在终端退出本机登录：

node itdog-cli.mjs auth logout

若密钥遗失或怀疑泄漏，请在浏览器打开个人设置 → 命令行登录并撤销对应密钥。撤销后该密钥立即失效。