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. 进阶配置（可选）

• 启用用户认证：

  1. 创建密码文件：

     sudo mosquitto_passwd -c /etc/mosquitto/passwd your_username

  2. 修改配置文件：

     allow_anonymous false
     password_file /etc/mosquitto/passwd

  3. 重启服务：

     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