# CLI 安装与登录 GEO Wiki Pro 提供命令行工具 `geo`，用于管理知识库的文档、分类、标签、用户等内容。本文档介绍安装与登录方法。 ## 安装 ### 环境要求 - Node.js >= 18 - npm >= 9 ### 全局安装 ```bash npm install -g geowiki-cli ``` 安装完成后验证是否成功： ```bash geo --version geo --help ``` ### 权限问题 如果遇到权限错误，可以使用以下方式解决： ```bash # 方式 1：使用 sudo sudo npm install -g geowiki-cli # 方式 2：修改 npm 全局目录 mkdir ~/.npm-global npm config set prefix '~/.npm-global' export PATH=~/.npm-global/bin:$PATH npm install -g geowiki-cli ``` ## 登录 CLI 支持两种登录方式：Token 登录（推荐）和密码登录。 ### Token 登录（推荐） ```bash geo login --url https://geowiki.pro --token geo_xxxxx ``` | 参数 | 缩写 | 说明 | 必需 | |------|------|------|------| | `--url` | `-u` | 服务器地址 | 是 | | `--token` | `-t` | API Token | 是 | ::: tip Token 登录无需 CAPTCHA，适合 CLI 和自动化脚本使用。Token 有效期为 90 天，在管理面板「设置 -> API Token」中生成。 ::: ### 密码登录 ```bash geo login --url https://geowiki.pro --user admin --pass your-password ``` | 参数 | 缩写 | 说明 | 必需 | |------|------|------|------| | `--url` | `-u` | 服务器地址 | 是 | | `--user` | `-U` | 用户名 | 是 | | `--pass` | `-p` | 密码 | 是 | ::: warning 密码登录需要 CAPTCHA 验证，适合浏览器场景。建议使用 Token 登录。 ::: ## 登录状态 查看当前连接状态： ```bash geo status ``` 登录成功后，Token 会自动保存到本地配置文件（`~/.geowiki/config.json`），后续命令会自动携带认证信息。 清除本地凭证并登出： ```bash geo logout ``` ## 常见问题 ::: faq **Q: 安装后找不到 `geo` 命令？** 确认 npm 全局 bin 目录在系统 PATH 中。运行 `npm config get prefix` 查看全局目录路径。 **Q: Token 过期了怎么办？** 在管理面板「设置 -> API Token」生成新 Token，然后运行 `geo login --url ... --token <新Token>` 重新登录。 **Q: 如何确认当前登录的用户？** 运行 `geo status` 可以查看当前服务器连接信息和用户信息。 ::: ## 下一步 安装和登录完成后，请参阅： - [CLI 快速参考](/docs/cli-quick-reference) -- 快速掌握常用命令 - [CLI 命令参考](/docs/cli-reference) -- 全部命令参数详解