跳到主要内容

安装指南（代理）

本文介绍如何在设备上安装 cert-ctrl 代理。服务器部署请查看其它文档，这里只覆盖负责拉取、解密并安装证书的终端代理。

快速安装​

根据平台挑选对应脚本：

  • Linux/WSL/FreeBSD：install.sh（脚本会自动识别 FreeBSD 并执行对应流程）
  • macOS：install-macos.sh
  • Windows（PowerShell）：install.ps1

Linux/WSL 安装脚本（install.sh）​

curl -fsSL https://install.lets-script.com/install.sh | sudo bash

若需要先下载审阅：

curl -fsSL https://install.lets-script.com/install.sh -o install.sh
cat install.sh   # 自行审阅
sudo bash install.sh

脚本将完成：

  • 下载匹配架构的最新代理
  • 安装到 /usr/local/bin（需要 root）并做基本校验
  • 可选择启用 systemd service

✅ 已在 Ubuntu、Debian、Rocky Linux、SUSE（SLE 与 openSUSE）、Alpine 等发行版验证通过；脚本会自动接入对应平台的服务管理器（优先 systemd，Alpine 使用 OpenRC，FreeBSD 使用 rc.d）。 我们也会在 Rocky、Alpine、SUSE 构建上持续跑冒烟测试，尽早发现潜在回归。

FreeBSD 主机（install.sh）​

FreeBSD 直接使用与 Linux 相同的 install.sh，脚本会自动识别并执行 BSD 专属步骤：

fetch -o install.sh https://install.lets-script.com/install.sh
sh install.sh

在 FreeBSD 上，它会：

  • 将代理放入 /usr/local/bin 并检查依赖库
  • 首次安装时写入 /usr/local/etc/certctrl-agent.conf
  • 安装 /usr/local/etc/rc.d/certctrl-agent，以便 service certctrl-agent start|stop|restart

macOS 安装脚本（install-macos.sh）​

macOS 版本会自动创建 LaunchDaemon：

curl -fsSL https://install.lets-script.com/install-macos.sh -o install-macos.sh
sudo bash install-macos.sh

常用 launchctl 命令：

sudo launchctl print system/com.coderealm.certctrl
sudo launchctl kickstart -k system/com.coderealm.certctrl
sudo launchctl bootout system /Library/LaunchDaemons/com.coderealm.certctrl.plist

Windows（PowerShell）​

irm https://install.lets-script.com/install.ps1 | iex

或先行下载：

Invoke-WebRequest -Uri "https://install.lets-script.com/install.ps1" -OutFile install.ps1
Get-Content install.ps1
PowerShell -ExecutionPolicy Bypass -File .\install.ps1

脚本将完成：

  • 下载代理到 Program Files 或用户本地 bin
  • 在 %APPDATA%\cert-ctrl 下创建配置目录
  • 可选择注册 Windows Service

登录代理（cert-ctrl login）​

安装完成后，请使用服务器账号登录，以便代理完成设备注册并获取任务。

如有需要，先设置相关环境变量，然后执行：

cert-ctrl login