事先准备

1、安装好 PHP 网站运行环境（例如使用 LNMP 一键包工具进行环境安装）

2、已经在网站环境中安装好 WHMCS 6.x 版本，建议版本号至少为 WHMCS 6.3.x 或更高。

3、已订购 Legendsock 模块授权，在客户中心下载最新版本后、上传至 WHMCS 根目录（如下图）

教程正文

配置模块信息

1、进入 WHMCS 后台 Setup -> Addon Modules 启用“Legendsock Manager”，按照如下图配置信息：

2、完成如上配置信息后，进入 WHMCS 后台 Addons -> Legendsock Manager 则可以查看到如下图信息：

3、如果没有提示授权错误、而是提示你未设置数据库，那么你的信息就填写正确了，如果提示授权错误请检查授权是否填写正确。

新增数据库

1、进入 phpmyadmin 程序，新建一个数据库：

数据库增加成功后，进入数据库后，进入权限 -> 添加用户：

为这个数据库添加一个数据库登陆账户，Host 必须设为 %

确认数据库、数据库用户都添加成功后，进行下一步。

2、进入 WHMCS 后台 Setup -> Products / Services -> Servers 页面，点击 Add New Server：

2、填写数据库信息，Type 选择 Legendsock Server

如果填写完信息，按”Test Connection“显示”SUCCESSFUL!“则说明可用，若不可以、请自行检查步骤。

3、保存数据库信息后，单击 Create New Group 新建一个服务组：

将刚才新建的数据库信息添加到这个服务组中：

4、设置数据库的节点与通知信息

进入 WHMCS 后台 Addons -> Legendsock Manager 对刚才新建的数据库信息单击”初始化表“：

单击初始化表后，提示”ID: XX 初始化成功，所需表已自动创建“则说明成功，初始化后、我们可以单击”编辑节点或通知“：

按照预留的示范格式修改好后，确认数据库 ID 编号无错、单击”提交修改“可提交节点或通知信息。

新增产品信息

1、新建一个 Shadowsocks 的”产品组“

进入 WHMCS 后台 Setup -> Products / Services -> Products / Services 单击 Create a New Group：

输入这个产品组的相应信息后保存，如下图：

2、新建产品

在当前页面单击 Create a New Product：

单击按钮后，输入这个产品的名字，例如”加速套餐 A“：

Details 中，取消 Require Domain 的选框，产品类型可随意选择，但为了分类、建议选择 Other：

Pricing 中，选择 recurring 并选择你需要的付款周期，例如 Monthly(月付) 和 Annually(年付)：

Module Settings 中，Module Name 选择 Legendsock Server，Server Group 选择前面新建的服务组，其他信息按照需要配置：

Custom Fields 中，新增一个”password|你要显示的字“，然后勾选 required field 和 show on order：

3、设置可选流量

进入 WHMCS 后台 Setup -> Products / Services -> Configurable Options 单击 Create a New Group：

保存如上信息后，单击 Add New Configurable Option 后，弹出框中的 Option Name 填写”traffic|你要显示的字“，Option Type 选择 Quantity，在 add option 中输入流量单位（用于显示）：

如上信息配置完毕后，请注意保存。

新增时钟守护任务

为 WHMCS 所在的 VPS 添加如下 cron jobs：

0 * * * * /home/wwwroot/test.com/modules/addons/legendsock/hour.php?user=admin&pass=123456

如上 cron jobs 用于前台每小时流量报表，修改前请将 /home/wwwroot/test.com/ 改为你 WHMCS 的目录，将 admin 改为你在配置模块时填写的 WHMCS 账户，123456 改为你在配置模块时填写的 WHMCS 密码。

至此，产品设置部分就全部完成了，可以作为用户订购产品测试购物流程。

购物流程截图

1、打开 http://WHMCS地址/cart.php 订购

2、选择参数并自定义密码

3、注册账户，完成下单后在后台开通，勾选”Run Module Create“后，审核订单

4、点击 item -> Product / Service 进入产品页面，将第一个 ss 产品的端口进行修改（作为起点，例如 3000）

这个用户设为 3000，那么下个用户订购时、端口将自动设为 3001

常见错误与排错方法

为什么无法自动开通？

1、产品设置中，你可能并未设置自动开通

2、数据库信息配置错误，请检查信息，查看 Legendsock Manager 可否打开

为什么端口修改失败？

1、数据库已存在此端口

如果已经有端口是 123，那么你无法将另外一个产品的端口设为 123