Semaphore UI 文档

Semaphore UI 是一个自托管的 Web 界面和 API，用于运行 Ansible、Terraform/OpenTofu、Shell、PowerShell 和 Python 自动化。它为您的团队提供一个统一的地方来运行 playbook 和脚本、加密保存凭据、调度作业，并查看谁在何时运行了什么。

它以单个 Go 二进制文件或 Docker 镜像的形式发布，可运行于 Linux、macOS 和 Windows，并将数据存储在 SQLite、MySQL 或 PostgreSQL 中。

第一次使用 Semaphore？简介介绍了它能做什么、一次部署由哪些部分组成，以及安装前需要准备什么。

快速开始

用一条命令以 SQLite 方式运行 Semaphore，然后打开 http://localhost:3000，使用 admin / changeme 登录。

docker run -d -p 3000:3000 \
  -e SEMAPHORE_DB_DIALECT=sqlite \
  -e SEMAPHORE_ADMIN=admin \
  -e SEMAPHORE_ADMIN_PASSWORD=changeme \
  -e SEMAPHORE_ADMIN_NAME=Admin \
  -e SEMAPHORE_ADMIN_EMAIL=admin@localhost \
  -v semaphore-data:/var/lib/semaphore \
  semaphoreui/semaphore:latest

生产环境请参阅安装，了解 Docker Compose、软件包、Kubernetes 和二进制文件安装方式。然后按照快速入门运行您的第一个任务。

安装与配置

启动服务器并将其连接到您的数据库、身份提供方和网络。

• 安装
• 配置
• 反向代理与 TLS
• LDAP 和 OpenID Connect
• 安全加固

运行自动化

将工作组织为项目，连接代码仓库和凭据，并按需或按计划运行任务。

• 快速入门：六步运行第一个任务
• 项目（Project）和团队（Team）
• 任务模板（Task Templates）和任务（Tasks）
• 密钥库（Key Store）、清单（Inventory）、变量组（Variable Groups）
• 计划任务（Schedule）和工作流（Workflow）（Pro）

规模化运维

分布式执行、冗余运行，并保持服务可观测且持续更新。

• 运行器（Runner）
• 高可用
• 升级
• 日志和指标
• 通知

参考

当您已经明确要找什么时，可在此查阅精确的选项和端点。

• 配置文件和环境变量
• REST API
• CLI
• CI/CD 集成
• 故障排查 FAQ

按工具分类的指南

AnsibleTerraform / OpenTofuShellPowerShellPython

帮助与社区

• **提问：**请在 Discord 上提问。
• **缺陷与功能请求：**请在 GitHub 上提交 issue。
• 源代码：github.com/semaphoreui/semaphore。
• Pro 与企业版：许可证激活。