SSL证书精灵使用说明

一、准备工作：

1、下载安装 Git for Windows：

主要是为了得到 bash.exe 程序来运行 acme.sh。

2、下载SSL证书精灵压缩包：

解压到你需要的目录下。下面以：d:/ssltool 为例。下边包含：vhost 模板子目录（用于 Apache 创建网站）、acme 子目录（用于 acme.sh 功能）。

3、DNS解析密钥：

如果需要以 DNS-01 方式验证并申请证书，请到阿里云、腾讯云（或dnspod）上开通相关的accessKey。此步骤为超级平台必须的，因为它一般不使用HTTP（TCP 80）端口，无法进行 HTTP-01 试试验证。

4、SSL证书服务商：

本工具目前支持 Let's Encrypt 和 LiteSSL 两个服务商，如果使用 LiteSSL 需要到 https://litessl.cn/ 申请 EABKID 和 EABHMACKEY。

二、准备SSL证书精灵：

运行参数设置：

bash文件位置在 Git 安装目录的 bin 子目录下。

acme.sh 位置一般在 SSL 证书精灵的解压目录下：acme/acme.sh。

apache 目录选择第一级目录，即 bin 目录的前一级。

网站根目录选择你创建的网站目录。

EAB KID 和 EAB MAC KEY 根据需要到 https://litessl.cn 自行申请。每台电脑（服务器）需要单独申请绑定使用，不能混用，切记。

三、Apache 建站与SSL证书申请更新：

如果你不需要建站，请忽略本章。

1、准备 Apache HTTP 系统：

请到官网下载最新版本的 Apache HTTPd 系统，如果有使用 PHP，还需要下载 mod_fcgid.so 模块。

默认模板还使用到 mod_log_rotate.so 模块，也请下载放到 Apache24 的 modules 目录下。

如果你的网站还需要使用到 PHP，请下载相关的 PHP 非线程安全版本。并编写 d:/ssltool/vhost/vhost.conf 模板文件中的 PHP 引用方式。

创建 wwwroot 目录。下面以：d:/wwwroot 为例。网站都是在这个目录下再创建子目录。

2、修改模板文件：

打开 d:/ssltool/vhost/vhost.conf文件进行修改。

模板包含 *:80 和 *:443 两个虚拟主机部分。其中 {{关键字}} 为 SSL 证书精灵在创建站点时自动替换的内容。分别是：

{{wwwDir}} 网站的目录

{{domain}} 网站的主域名（申请域名）

{{domain2}} 网站的其他域名

默认模板中引用了 Include conf/php/85.conf 来定义 PHP 的使用，内容如下：

<Files ~ ".php$">
	Options FollowSymLinks ExecCGI
	AddHandler fcgid-script .php
	FcgidWrapper "C:/php85/php-cgi.exe" .php
</Files>

根据实际情况修改即可。

3、创建站点：

点击【添加站点】按钮进行添加：

监控主机端口填写：域名(或IP):端口。端口如果不填写为默认 443。

申请域名为网站主域名。

如果还有其他域名，可填写多个，用空格分隔，申请 SSL 证书时会申请为多域名证书。

四、超级平台SSL证书申请更新：

如果你不使用超级平台，请忽略本章。

1、准备超级平台系统：

请加载最新的支持更新证书功能的管理模块（admin.dll）。并为 admin 模块对应的 INI 文件定义更新 SSL 证书的密码：

[Admin]
Username = 登录用户名
Password = 登录密码（请用MD5加密）
setssl = 更新SSL证书的密码（请用MD5加密）

为超级平台的 INI 增加定义：

[Modules]
ModuleCount = 2（模块数量）
……
;具有管理功能的模块
AdminModule = 1（模块编号）

……
ModuleName_1 = admin（模块名称）
ModuleIni_1 = server_admin.ini（使用的模块INI）
ModuleDLL_1 = admin.dll

以上设置重启超级平台程序后生效。注意：（）号内容为说明，实际文件中应该删除。

2、创建站点：

点击【添加站点】按钮，进行添加：

监控主机端口填写：域名(或IP):端口/管理模块名/setssl.gsp，其中管理模块名在 INI 定义。

申请域名：填写使用的域名。如果要有多个域名，在其他域名中填写（用空格分隔）。

提交密钥：即管理模块INI中所定义的 SetSSL 的密码。

SSL 服务商根据需要选择。

DNS 服务商目前支持阿里云和腾讯云两家（后续根据大家的使用情况增加其他家）。

Secret ID（Access ID）、Secret Key（Access Key）、EAB KID、EAB MAC KEY见上面第一章第3、4点。

如需到期自动申请证书，请勾选上边的【自动申请SSL证书】。

点击【确定】后保存即可。