群晖 DSM 7.7.1 部署 Mosquitto 2.0.22 MQTT 服务器（含外网访问完整指南）

写在前面：

折腾了很久，也在CSDN看了很多安装教程，始终都不能完成安装和访问，按照教程部署配置完之后，套件就会提示修复，导致安装失败，反复尝试终于搞定安装，供大家参考。各位一定要核对群晖和Mosquitto的版本号。此教程仅针对我提供的版本号。

2026.3.14

一、整体说明

本文档适配群晖 DSM 7.7.1 系统 + Mosquitto 2.0.22 版本，包含「本地部署（内网访问）」和「外网访问」两套完整方案，兼顾安全性与易用性，新手可全程复制命令执行。

核心适配点

• 移除 Mosquitto 2.0.22 不支持的 -u/-P 参数，改用「原生创建 + 手动修权限」；
• 剔除配置文件中版本不兼容的参数，避免启动失败；
• 外网访问提供「VPN（安全）」和「端口映射（便捷）」两种方案，按需选择。

二、前置准备

三、本地部署（内网访问）完整步骤

1. 彻底卸载旧版本（如果之前安装过，如没有请跳过）

# 1. 登录 SSH（替换为你的群晖 IP）
ssh admin@你的群晖内网IP -p 22

# 2. 切换 root 权限（输入 admin 密码）
sudo -i

# 3. 卸载并清理所有残留
synopkg stop mosquitto
synopkg uninstall mosquitto
rm -rf /var/packages/mosquitto
rm -rf /volume1/@appconf/mosquitto
rm -rf /volume1/@apphome/mosquitto
rm -rf /volume1/@appdata/mosquitto
rm -rf /volume1/@appstore/mosquitto

2. 添加第三方套件源（SynoCommunity）