程序安装
备注：
Coolpy7所有发行版没有特别说明的情况下只支持64bit系统，因为32bit操作系统最大只支持4G内存，作为高性能的消息服务系统，CP7需要大于4G的内存运行。
Coolpy7会出现可运行于简易设备的版本，例如MIPS框架基本上使用于OpenWrt操作系统。还有基于ARM的相关微型设备等等。
基础功能服务器端
CP7核心服务器
CP7 TLS TCP 代理服务器
CP7 WebSocket 代理服务器
CP7 WebSocket TLS 代理服务器
CP7 数据库代理服务器
扩展功能服务器端
扩展功能 | 开源地址 | 状态 | 说明 |
CP7 TLS代理服务器 | 已对接 | 核心功能 | |
CP7 WS-TLS代理服务器 | 已对接 | 核心功能 | |
CP7 DbPoxy代理服务器 | 已对接 | 核心功能 | |
CP7 MQTT-SN代理服务器 | 已对接 | 扩展功能 | |
CoAP | 未对接 | 扩展功能 |
测试客户端开源地址 https://github.com/Coolpy7/coolpy7_benchmark
服务名称 | IP | 协议 | 端口 | 备注 |
CP7核心服务 | 192.168.200.201 | TCP | 1883 | |
CP7核心服务 TLS代理 | 192.168.200.202 | TCP | 8883 | |
CP7 Websocket代理服务 | 192.168.200.203 | TCP | 8083 | |
CP7 WS-TLS代理服务器 | 192.168.200.204 | TCP | 8084 | |
CP7数据库代理 | 192.168.200.205 | TCP | 无 | |
Mongodb数据库 | 192.168.200.206 | TCP | 27017 | Gridfs->OSS |
CP7核心服务是一个最原始最单纯功能完备的MQTT消息服务器端，包括功能有：QoS:0,QoS1,QoS2消息质量支持。Will消息支持等等。深入了解 https://mcxiaoke.gitbooks.io/mqtt-cn/content/
防止暴力连接攻击，对已连接客户端进行优先保护
防止空连接攻击，当用户连接建立后两秒钟内没有进行身份验证即主动关闭客户端连接
通过ssh进入服务器192.168.200.201，并确保你已经按照 https://coolpy7.gitbook.io/coolpy7book/kai-shi-shi-yong/start 配置服务器操作系统的网络优化配置。
CP7核心服务运行后会自行构当前目录下的data文件夹，此文件夹存放MQTT运行期所需求持久化的数据信息，使用的是开源项目 https://github.com/jacoblai/yiyidb，支持10亿级秒op的高性能数据库，数据库内核使用的是Leveldb技术。
# 下载服务器端git clone https://github.com/Coolpy7/Coolpy7.git && cd Coolpy7# 解压文件unzip go_build_Coolpy7_go_linux.zip# 提权chmod -R 777 go_build_Coolpy7_go_linux# 启动Coolpy7 启动参数# l 当前服务Host地址 (默认为:1883即本地1883端口,此参数一般默认即可，无需配置)# a 连接接入调度器最大线程，此值可防止暴力连接攻击，对已连接客户端进行优先保护 (默认值128)./go_build_Coolpy7_go_linux# 启动成功后会打印如下信息，即说明服务端已正常启动，host于1883端口，请确保相关防火墙配置可用2018/10/29 12:59:55 Coolpy7 tcp is listening on [::]:1883
一般需为程序提权才可以运行Linux服务，指令：chmod -R 777 go_build_Coolpy7_go_linux
此功能即为CP7核心服务提供TLS接入功能。通过ssh进入服务器192.168.200.202，并确保你已经按照 https://coolpy7.gitbook.io/coolpy7book/kai-shi-shi-yong/start 配置服务器操作系统的网络优化配置。
此服务开源地址：https://github.com/Coolpy7/Coolpy7-TLS-Poxy
TLS服务需要对应域名的数字证书
以阿里云为例可以进入对应域名的管理后台下载证书，把key和pem文件复制到data文件夹下，并命名为server.key和server.pem
# 下载CP7 TLS代理 服务器端git clone https://github.com/Coolpy7/Coolpy7-TLS-Poxy.git && cd Coolpy7-TLS-Poxy/bin# 提权chmod -R 777 go_build_Coolpy7_tls_go_linux_linux# 启动Coolpy7 tls poxy# r启动参数 CP7核心服务器所在ip或域名 (例：core.coolpy.net:1883 or 192.168.200.201:1883)# l启动参数 当前服务Host地址 (默认为:8883即本地8883端口,此参数一般默认即可，无需配置)./go_build_Coolpy7_tls_go_linux_linux -r=192.168.200.201:1883# 启动成功后会打印如下信息，即说明服务端已正常启动，host于8883端口，请确保相关防火墙配置可用2018/10/29 12:59:55 upstream 192.168.200.201:1883 ok2018/10/29 12:59:55 Coolpy7 TLS proxy is listening on [::]:8883
此功能即为CP7核心服务提供WebSocket接入功能。通过ssh进入服务器192.168.200.203，并确保你已经按照 https://coolpy7.gitbook.io/coolpy7book/kai-shi-shi-yong/start 配置服务器操作系统的网络优化配置。
千万级WebSocket代理服务器
支持防爆力攻击
# 下载服务器端git clone https://github.com/Coolpy7/Coolpy7.git && cd Coolpy7# 解压文件unzip go_build_Coolpy7_ws_go_linux.zip# 提权chmod -R 777 go_build_Coolpy7_ws_go_linux# 启动Coolpy7 WS Poxy# r启动参数 CP7核心服务器所在ip或域名 (例：core.coolpy.net:1883 or 192.168.200.201:1883)# l启动参数 当前服务Host地址 (默认为:8083即本地8083端口,此参数一般默认即可，无需配置)./go_build_Coolpy7_ws_go_linux# 启动成功后会打印如下信息，即说明服务端已正常启动，host于8083端口，请确保相关防火墙配置可用2018/10/29 12:59:55 upstream 192.168.200.201:1883 ok2018/10/29 12:59:55 Coolpy7 ws is listening on [::]:8083
此功能即为CP7 WebSocket代理服务提供TLS接入功能。通过ssh进入服务器192.168.200.204，并确保你已经按照 https://coolpy7.gitbook.io/coolpy7book/kai-shi-shi-yong/start 配置服务器操作系统的网络优化配置。
开源地址：https://github.com/Coolpy7/Coolpy7-WS-TLS-Poxy
# 下载CP7 WS TLS代理 服务器端git clone https://github.com/Coolpy7/Coolpy7-WS-TLS-Poxy.git && cd Coolpy7-WS-TLS-Poxy/bin# 提权chmod -R 777 go_build_Coolpy7_ws_tls_go_linux_linux# 启动Coolpy7 ws tls poxy# r启动参数 CP7 WebSocket 代理服务器所在ip或域名 (例：core.coolpy.net:8083 or 192.168.200.201:8083)# l启动参数 当前服务Host地址 (默认为:8084即本地8084端口,此参数一般默认即可，无需配置)./go_build_Coolpy7_tls_go_linux_linux -r=192.168.200.203:8083# 启动成功后会打印如下信息，即说明服务端已正常启动，host于8084端口，请确保相关防火墙配置可用2018/10/29 12:59:55 upstream 192.168.200.203:8083 ok2018/10/29 12:59:55 Coolpy7 TLS proxy is listening on [::]:8084
CP7 DbPoxy数据库代理服务器支持 MongoDB、Mysql、Mssql、Pgsql等主流数据库。当使用mongodb作为数据库即可使用Gridfs特性支持文件存储功能，即可实现对象存储（Object Storage Service，简称OSS）功能。
单个DbPoyx数据库代理运行实例只允许连接一种数据库。支持多实例连接多种数据库提供服务器。
开源地址：https://github.com/Coolpy7/DbPoxy
# 下载服务器端git clone https://github.com/Coolpy7/DbPoxy.git && cd DbPoxy/bin# 提权chmod -R 777 go_build_Coolpy7_db_poxy_go_linux_linux# 启动Coolpy7 DbPoxy# c启动参数 当前服务配置文件路径 (默认为/data/dbpoxy.yml 此参数一般默认即可，无需配置)./go_build_Coolpy7_db_poxy_go_linux_linux# 启动成功后会打印如下信息，即说明服务端已正常启动，host于8083端口，请确保相关防火墙配置可用2018/11/03 16:55:14 dbpoxy/mongodb/get OK, token: password2018/11/03 16:55:14 mongodb ping ok
本例使用mongodb演示并假设网络环境中在192.168.200.206中已运行一个未开户身份验证的mongod服务，并Host端口于27017
安装方式请参阅Mongodb官方文档：https://docs.mongodb.com/manual/installation/
配置文件说明
#使用mongodb作为普通数据服务DatabaseType: mongodb#mongodb数据库连接字符串,即当前环境已经在运行的何意一个mongodb数据库实例DatabaseConnectionString: mongodb://192.168.200.206:27017#使用postgres作为普通数据服务#更多sql数据库的连接字符串请参阅：https://github.com/go-xorm/xorm#DatabaseType: postgres #mssql mysql postgres mongodb oss-gridfs#DatabaseConnectionString: host=192.168.100.187 port=13246 user=postgres dbname=ldh sslmode=disable password=123456#使用mongodb作为OSS服务#DatabaseType: oss-gridfs#mongodb数据库连接字符串,即当前环境已经在运行的何意一个mongodb数据库实例#DatabaseConnectionString: mongodb://192.168.200.206:27017#Coolpy7 Core服务地址信息BrokerHost: 192.168.200.201BrokerPort: 1883#MQTT连接信息BrokerClientId: dbpoxyBrokerUser: dypoxyBrokerPassword: dypoxyBrokerClearSession: true#日志文件LogFilePath: dbpoxy.log#端访问相关配置信息#操作token，通过此定义可进行安全校验，在指令发出端需把此token填写一致指令才会被接受#如果填写空即不进入任何安全校验AccessToken: password#本实例的操作topic，指令发出端对应的发布地址，及qos消息质量控制OpTopics:Topic: dbpoxy/mongodb/getQos: 0
配置文件默认所有路径：/data/dbpoxy.yml
通过以上操作，我们已经得出一套完整的千万级MQTT消息系统。下一章介绍如何用客户端工具验证系统功能。
用户账户指南
当需要对接任何用户账号数据库时，请参阅 《Coolpy7(IOT)通用控制协议》一书，里边祥尽介绍如果通过协议实现对数据库的CURD操作。
