SSL工具箱(免费版)

概述

SSL工具箱(免费版)为个人用户提供HTTPS配置、TLS证书管理与基础连接排障能力。当你在请求中提及 SSL证书、HTTPS配置、Let's Encrypt、certbot、TLS配置、证书过期、混合内容、证书链错误 等关键词时,本工具会自动激活,根据任务推荐合适的工具与方法,并输出可执行的命令与配置。

本版本聚焦个人站点的基础SSL管理,适合个人博客、小型站点与本地开发环境。如需通配符证书、多域名SAN、高级排障、自动化审计与多服务器配置,请升级至 PRO 版本。

核心能力

核心功能执行

用input_params参数进行配置。

输入: 用户提供核心功能执行所需的指令和必要参数。 处理: 解析核心功能执行的输入参数,完成核心逻辑,返回结构化响应。 输出: 返回核心功能执行的响应数据,包含状态码、结果和日志。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

参数配置与调用

用config_options参数进行配置。

输入: 用户提供参数配置与调用所需的指令和必要参数。 处理: 解析参数配置与调用的输入参数,完成核心逻辑,返回结构化响应。 输出: 返回参数配置与调用的响应数据,包含状态码、结果和日志。

• 执行此能力时使用config_options参数,支持修改/重置/导入操作

结果处理与输出

用output_format参数进行配置。

输入: 用户提供结果处理与输出所需的指令和必要参数。 处理: 解析结果处理与输出的输入参数,完成核心逻辑,返回结构化响应。 输出: 返回结果处理与输出的响应数据,包含状态码、结果和日志。

• 执行此能力时使用output_format参数,支持导出/保存/转换操作 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：个人用户的、TLS、证书管理与基础连、接排障工具、工具箱、免费版、为个人用户提供、接排障能力、Let、Encrypt、免费证书申请与续、证书状态检查与详、常见错误诊断与修、证书类型选择指引等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。

使用场景

场景一:为个人站点启用HTTPS

用户希望为个人博客启用HTTPS,工具推荐Let's Encrypt免费证书。

# 使用certbot为Nginx申请证书
certbot certonly --nginx -d example.com -d www.example.com
# ...
# 验证证书已签发
ls /etc/letsencrypt/live/example.com/
# fullchain.pem  privkey.pem  chain.pem  cert.pem

配置Nginx使用证书:

server {
    listen 443 ssl http2;
    server_name example.com www.example.com;
# ...
    ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
# ...
    # 基础安全配置
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers HIGH:!aNULL:!MD5;
}

场景二:检查证书状态与有效期

用户希望检查某域名证书是否快过期。

# 查看远程证书有效期
echo | openssl s_client -connect example.com:443 2>/dev/null | openssl x509 -noout -dates
# ...
# 示例
# notBefore=Jun 19 00:00:00 2026 GMT
# notAfter=Sep 17 00:00:00 2026 GMT
# ...
# 查看证书完整详情
openssl s_client -connect example.com:443 -servername example.com

场景三:诊断证书错误

用户报告浏览器显示证书错误,工具诊断根因并给出修复。

不适用场景

以下场景SSL工具箱(免费版)不适合处理：

• 实际人员绩效评估
• 财务预算审批
• 合同法务审核

触发条件

需要项目管理、任务规划、进度跟踪、团队协作时使用。不适用于非本工具能力范围的需求。

快速开始

1. 阅读## 核心能力章节了解skill功能
2. 按## 依赖说明配置环境
3. 执行所需能力对应的命令
4. 参考## 错误处理章节处理异常
5. 查看## FAQ解答常见疑问

1. 申请免费证书

# 方式一:certbot(最常用)
certbot certonly --nginx -d example.com -d www.example.com
# ...
# 方式二:certbot standalone(无Web服务器时)
certbot certonly --standalone -d example.com
# ...
# 方式三:acme.sh(轻量)
acme.sh --issue -d example.com --nginx

2. 检查证书状态

# 查看远程证书有效期
echo | openssl s_client -connect example.com:443 2>/dev/null | openssl x509 -noout -dates
# ...
# 查看证书详情
echo | openssl s_client -connect example.com:443 2>/dev/null | openssl x509 -noout -text
# ...
# 查看本地证书文件
openssl x509 -in cert.pem -text -noout

3. 配置服务器

Nginx配置:

server {
    listen 443 ssl http2;
    server_name example.com;
# ...
    ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
# ...
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers HIGH:!aNULL:!MD5;
    ssl_prefer_server_ciphers on;
}
# ...
# HTTP跳转HTTPS
server {
    listen 80;
    server_name example.com;
    return 301 https://$host$request_uri;
}

Apache配置:

SSLEngine on
SSLCertificateFile /path/to/cert.pem
SSLCertificateKeyFile /path/to/privkey.pem
SSLCertificateChainFile /path/to/chain.pem

配置示例

核心任务速查表

常用证书命令

# 申请证书
certbot certonly --nginx -d example.com -d www.example.com
# ...
# 查看远程证书有效期
echo | openssl s_client -connect example.com:443 2>/dev/null | openssl x509 -noout -dates
# ...
# 查看远程证书完整信息
openssl s_client -connect example.com:443 -servername example.com

证书类型选择

最佳实践

1. 始终自动化续期

Let's Encrypt证书90天过期,务必自动化:

# 测试续期(不实际执行)
certbot renew --dry-run
# ...
# 添加cron定时续期
crontab -e
# 每天凌晨检查并续期
0 0 * * * certbot renew --quiet

2. 配置HTTP跳转HTTPS

server {
    listen 80;
    server_name example.com www.example.com;
    return 301 https://$host$request_uri;
}

3. 使用完整证书链

# 正确:使用fullchain.pem(包含中间证书)
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
# ...
# 错误:仅用cert.pem(缺少中间证书,部分客户端无法验证)
ssl_certificate /etc/letsencrypt/live/example.com/cert.pem;

4. 启用现代TLS协议

# 推荐:仅启用TLS 1.2与1.3
ssl_protocols TLSv1.2 TLSv1.3;
# ...
# 禁用:TLS 1.0与1.1(已不安全)
# ssl_protocols TLSv1 TLSv1.1;  # ❌

5. 解决混合内容

HTTPS页面引用HTTP资源会触发混合内容警告:

<!-- 错误:HTTP资源 -->
<img src="http://cdn.example.com/image.png">
# ...
<!-- 正确:HTTPS或协议相对 -->
<img src="https://cdn.example.com/image.png">
<img src="//cdn.example.com/image.png">

常见问题

Q1:免费版支持哪些服务器?

免费版提供Nginx与Apache基础配置模板。如需Node.js、Caddy、Traefik、HAProxy等,请使用PRO版。

Q2:Let's Encrypt证书有效期多久?

90天。务必配置自动续期,建议每天检查一次。certbot renew 只在证书剩余有效期<30天时实际续期,所以频繁检查是安全的。

Q3:免费版能否申请通配符证书?

免费版提供通配符证书的说明,但通配符证书需要DNS-01验证,配置较复杂。深度通配符与多域名管理请使用PRO版。

Q4:免费版与PRO版差异?

Q5:自签名证书能用吗?

仅适合本地开发,浏览器会警告。生产环境务必使用受信任CA签发的证书(如Let's Encrypt)。

Q6:本工具能做什么、不能做什么?

能做:HTTPS配置、证书申请与续期、常见错误诊断、基础服务器配置。 不能做:应用层鉴权(JWT/OAuth)、SSH密钥、VPN/隧道、防火墙配置 — 这些请用对应专用工具。

依赖说明

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
• 操作系统: Windows / macOS / Linux
• Web服务器: Nginx / Apache(配置HTTPS需要)

依赖详情

API Key 配置

• 本skill基于Markdown指令规范,无需额外API Key。
• Let's Encrypt 通过ACME协议自动签发证书,无需API Key。
• 域名DNS解析需提前配置好,指向你的服务器IP。

可用性分类

• 分类: MD+EXEC(纯Markdown指令,部分功能需exec命令行执行)
• 说明: 基于Markdown的AI Skill,通过自然语言指令驱动Agent完成操作。免费版聚焦个人站点的HTTPS配置、证书管理与基础连接排障。

错误处理

已知限制

• 需LLM支持,无LLM环境不可用
• 复杂业务场景建议结合人工经验判断
• 执行效率受模型能力与网络环境影响

示例

基本用法

输入：用户提供操作指令和必要参数

输出：返回执行结果,包含操作状态和输出数据

用户: 执行核心功能
Skill: 正在执行核心功能...
Skill: 执行完成,结果如下: 操作成功

输出格式

{
  "success": true,
  "data": {
    "result": "SSL工具箱(免费版)处理结果",
    "execution_time": "0.5s",
    "metadata": {
      "version": "1.0",
      "processor": "sslkit"
    }
  },
  "execution_log": ["解析输入参数", "执行核心处理", "格式化输出结果"],
  "error": null
}