1. 准备工作
确保玩客云已刷入Armbian系统,并能通过SSH正常连接。
更新系统软件包:
sudo apt update && sudo apt upgrade -y
2. 安装Mosquitto MQTT服务端
sudo apt install mosquitto mosquitto-clients -y
3. 配置Mosquitto
修改配置文件:
sudo vim /etc/mosquitto/mosquitto.conf
基础配置示例(按需调整):
# 监听所有IPv4地址的默认端口1883 listener 1883 0.0.0.0 # 允许匿名连接(测试用,生产环境建议关闭) allow_anonymous true # 持久化消息存储(可选) persistence true persistence_location /var/lib/mosquitto/ # 日志文件 log_dest file /var/log/mosquitto/mosquitto.log
4. 启动服务并设置自启
sudo systemctl enable mosquitto
sudo systemctl start mosquitto
5. 验证服务状态
sudo systemctl status mosquitto
检查日志是否有错误:
tail -f /var/log/mosquitto/mosquitto.log
6. 防火墙配置(如启用)
sudo ufw allow 1883/tcp # 开放MQTT默认端口
sudo ufw reload
7. 测试MQTT服务
topic是隐式创建的无需操作
订阅测试消息:
mosquitto_sub -h localhost -t "test/topic"
发布测试消息:
mosquitto_pub -h localhost -t "test/topic" -m "Hello from玩客云!"
明文连接没有密码和鉴权
8. 进阶配置(可选)
启用用户认证:
创建密码文件:
sudo mosquitto_passwd -c /etc/mosquitto/passwd your_username
修改配置文件:
allow_anonymous false password_file /etc/mosquitto/passwd
重启服务:
sudo systemctl restart mosquitto
启用SSL/TLS加密:
需准备证书并配置listener 8883
和cafile
、certfile
、keyfile
参数。
*********************************************************************************
1. 停止服务
sudo systemctl stop mosquitto # 停止正在运行的服务
sudo systemctl disable mosquitto # 禁用开机自启
2. 卸载软件包
仅卸载程序(保留配置文件):
sudo apt remove mosquitto mosquitto-clients -y
完全卸载(删除程序 + 配置文件):
sudo apt purge mosquitto mosquitto-clients -y # 彻底删除配置文件和日志
3. 清理残留文件(可选)
如果希望彻底删除所有相关文件(如日志、数据文件):
sudo rm -rf /etc/mosquitto/ # 配置文件目录
sudo rm -rf /var/lib/mosquitto/ # 持久化数据目录
sudo rm -rf /var/log/mosquitto/ # 日志目录
4. 验证卸载
sudo ufw delete allow 1883/tcp
sudo ufw reload
mosquitto -v # 若提示 "command not found" 表示卸载成功
5. 防火墙规则清理(可选)
如果之前开放了 MQTT 端口(如1883),可关闭:
sudo ufw delete allow 1883/tcp
sudo ufw reload
6. 重新安装(如果需要)
若未来需重新安装:
sudo apt install mosquitto mosquitto-clients -y