Confluence CLI (confcli)

通过命令行与 Confluence Cloud 交互。用于读取、创建、更新或搜索 Confluence 页面,管理附件、标签、评论或导出内容。

安装

概览

Confluence CLI(简称 confcli)是一个专为 Atlassian Confluence Cloud 设计的命令行工具,旨在通过终端高效地与 Confluence 知识库进行交互。它允许开发者和运维人员在无需打开浏览器的情况下,直接通过脚本或命令完成对页面、空间、附件、标签和评论等核心内容的管理操作。confcli 支持多种输出格式,包括 JSON、表格和 Markdown,便于与其他自动化流程集成。该工具强调安全性与可控性,所有写操作均需用户显式确认,并推荐使用 API Token 进行身份验证,避免敏感信息泄露。无论是日常的内容检索、批量导出,还是复杂的空间结构复制,confcli 都能显著提升在 Confluence 上工作的效率。

核心功能特点

  1. 支持通过命令行读取、创建、更新和删除 Confluence 页面及空间
  2. 提供灵活的页面引用方式:ID、URL 或 Space:Title 格式
  3. 支持附件上传、下载与管理,以及标签和评论的增删操作
  4. 具备强大的搜索功能,支持高级查询语法和分页获取结果
  5. 支持内容导出为 Markdown 格式,便于本地备份或迁移
  6. 所有写操作均需用户明确授权,默认启用 –dry-run 模式防止误操作

适用场景

confcli 特别适合需要在自动化流程中频繁操作 Confluence 的场景。例如,在 CI/CD 流水线中自动生成文档变更日志,或在每日构建完成后自动将测试报告上传至指定页面。对于 DevOps 团队而言,可以通过脚本定期导出关键页面的历史版本,实现轻量级的内容归档。此外,当企业需要统一多个子项目的文档结构时,confcli 的 copy-tree 功能可快速复制整个页面树,大幅减少手动重建的工作量。对于远程办公或偏好终端操作的开发者,confcli 提供了比 Web 界面更快捷的操作路径,尤其适合处理大量重复性任务。由于其基于环境变量认证且支持非交互式部署,也常被用于容器化或无头服务器环境中运行文档同步任务。