配置说明

平台所有配置文件集中存放在发行版根目录下的 etc/ 目录中。修改配置后需重启服务生效（部分支持热更新的插件除外）。

配置文件总览

文件	说明
`alinkiot.conf`	主配置文件：节点、日志、系统监控、MQTT 各协议监听器等
`acl.conf`	访问控制（ACL）规则：按用户 / IP 控制 Topic 的发布与订阅
`alinkiot.config`	Erlang 原生配置（`sys.config` 格式）：Dashboard（管理后台）与 MySQL 连接等应用参数
`tdengine.config`	TDengine 时序数据库连接配置
`ssl_dist.conf`	Erlang 节点间分布式通信的 TLS 配置
`vm.args.src`	Erlang 虚拟机启动参数
`certs/`	TLS 证书目录（服务端 / 客户端证书、CA 证书、私钥）

主配置 alinkiot.conf

节点

node.name = alinkiot
node.cookie = alinkiot_cookie
node.data_dir = data
node.crash_dump = log/crash.dump

认证与 ACL

acl_file = etc/acl.conf
allow_anonymous = true      # 是否允许匿名接入，生产环境建议改为 false
acl_nomatch = allow         # ACL 未命中时的默认动作

日志

log.to = file
log.level = warning         # 日志级别：debug / info / warning / error
log.dir = log               # 日志目录
log.file = alinkiot.log     # 当前日志文件名
log.rotation = on           # 开启日志滚动
log.rotation.size = 10MB    # 单文件大小上限，超过后滚动
log.rotation.count = 5      # 保留的历史文件数量（alinkiot.log.1 ~ .5）

日志目录结构与查看方式详见日志查询。

协议监听器

MQTT 接入相关的监听器配置位于主配置文件 etc/alinkiot.conf。平台支持 TCP / SSL / WebSocket / WSS 四种接入方式，分别对应独立的 listener.* 配置块，默认监听端口如下：

协议	配置项	默认监听	用途
MQTT over TCP	`listener.tcp.external`	`0.0.0.0:1883`	标准 MQTT 明文接入
MQTT over SSL	`listener.ssl.external`	`8883`	MQTT over TLS 加密接入
MQTT over WebSocket	`listener.ws.external`	`8083`	浏览器 / Web 客户端接入，路径 `/mqtt`
MQTT over WSS	`listener.wss.external`	`8084`	WebSocket over TLS 接入，路径 `/mqtt`

通用监听器参数

每个监听器都支持以下常用参数：

参数	说明
`acceptors`	接收进程数，影响新连接的并发处理能力
`max_connections`	该监听器允许的最大连接数
`max_conn_rate`	每秒允许的最大新建连接数（限流）
`active_n`	每次从 socket 读取的报文批量数
`zone`	绑定的 zone（控制该监听器的会话、流控、ACL 等策略）
`access.N`	监听器级访问控制规则（如 `allow all`）

TCP 接入

listener.tcp.external = 0.0.0.0:1883
listener.tcp.external.acceptors = 8
listener.tcp.external.max_connections = 1024000
listener.tcp.external.max_conn_rate = 1000
listener.tcp.external.active_n = 100
listener.tcp.external.zone = external

SSL（MQTT over TLS）接入

listener.ssl.external = 8883
listener.ssl.external.acceptors = 16
listener.ssl.external.max_connections = 102400
listener.ssl.external.max_conn_rate = 500
listener.ssl.external.active_n = 100
listener.ssl.external.zone = external
listener.ssl.external.handshake_timeout = 15s
listener.ssl.external.keyfile = etc/certs/key.pem
listener.ssl.external.certfile = etc/certs/cert.pem
listener.ssl.external.cacertfile = etc/certs/cacert.pem

证书文件位于 etc/certs/ 目录；替换为自有证书后重启服务生效。

WebSocket 接入

listener.ws.external = 8083
listener.ws.external.mqtt_path = /mqtt
listener.ws.external.acceptors = 4
listener.ws.external.max_connections = 102400
listener.ws.external.max_conn_rate = 1000
listener.ws.external.active_n = 100
listener.ws.external.zone = external

Web 客户端连接地址形如 ws://<服务器地址>:8083/mqtt。

WSS（WebSocket over TLS）接入

listener.wss.external = 8084
listener.wss.external.mqtt_path = /mqtt
listener.wss.external.acceptors = 4
listener.wss.external.max_connections = 102400
listener.wss.external.max_conn_rate = 1000
listener.wss.external.active_n = 100
listener.wss.external.zone = external

Web 客户端连接地址形如 wss://<服务器地址>:8084/mqtt，复用 etc/certs/ 下的证书。

设备侧如何使用这些端口接入，参见设备接入。

智能体调试配置

用于开启智能体（AI）接入的调试能力，便于联调时查看交互过程：

erl_cli.debug = true          # 是否开启智能体调试，开启后输出调试信息
erl_cli.token = zhengweixing  # 智能体接入调试 Token

调试配置仅建议在联调 / 测试环境开启，生产环境请关闭 erl_cli.debug 并妥善保管 Token。

配置开启后，在智能体对话中发送如下提示词即可建立远程连接：

你远程连接到 x.x.x.x，token=xxxxx

将 x.x.x.x 替换为平台所在的服务器地址，xxxxx 替换为上面配置的 erl_cli.token。

访问控制 acl.conf

ACL 规则按顺序匹配，命中即生效。规则形式为 {allow|deny, who, access, [topics]}：

%% 允许 dashboard 用户订阅系统主题
{allow, {user, "dashboard"}, subscribe, ["$SYS/#"]}.
%% 允许本机对所有主题收发
{allow, {ipaddr, "127.0.0.1"}, pubsub, ["$SYS/#", "#"]}.
%% 拒绝其它客户端订阅系统主题和通配全量主题
{deny, all, subscribe, ["$SYS/#", {eq, "#"}]}.
%% 兜底：其余一律放行
{allow, all}.

who：all / {user, "名称"} / {client, "ClientID"} / {ipaddr, "CIDR"}
access：subscribe / publish / pubsub
生产环境建议收紧兜底规则（将最后的 {allow, all}. 改为按需放行）。

管理后台与 MySQL alinkiot.config

alinkiot.config 采用 Erlang 原生配置格式（即 sys.config，内容为 [{App, [{Key, Value}, ...]}, ...] 的 Erlang 项列表），用于配置各应用的运行参数：

{alinkiot_dashboard, [
  {port, 18888},          %% 管理后台端口
  {docroot, "www/"},      %% 前端静态资源目录
  {expire, 18000},        %% 登录 Token 有效期（秒）
  {token_name, "token"}
]},
{alinkiot_mysql, [
  {mysql, [[
    {host, "127.0.0.1"}, {port, 3306},
    {user, "alinkiot"}, {password, "******"},
    {database, "alinkiot"},
    {pool_size, 10}
  ]]}
]}

管理后台默认端口 18888。数据库连接的 host / user / password / database 按实际环境修改，默认密码务必更换。

TDengine tdengine.config

{alinkiot_tdengine, [
  {host, "127.0.0.1"}, {port, 6041},
  {username, "root"}, {password, "******"},
  {database, "alinkiot"},
  {pool_size, 20},
  {flush_interval, 1000},   %% 批量写入刷新间隔（毫秒）
  {flush_msg_len, 20}       %% 批量写入条数阈值
]}

TDengine 用于存储设备上报的时序数据，连接参数按实际部署修改。

分布式 TLS ssl_dist.conf 与 certs/

ssl_dist.conf 配置 Erlang 节点间分布式通信的 TLS 证书，证书文件位于 etc/certs/：

[{server, [{certfile, "etc/certs/cert.pem"},
           {keyfile,  "etc/certs/key.pem"},
           {secure_renegotiate, true},
           {depth, 0}]},
 {client, [{secure_renegotiate, true}]}].

certs/ 目录包含服务端证书 / 私钥（cert.pem / key.pem）、客户端证书 / 私钥（client-cert.pem / client-key.pem）和 CA 证书（cacert.pem）。

vm.args.src

Erlang 虚拟机启动参数（如节点名、cookie、内存分配、端口范围等）。一般无需改动，确有调优需求时再按 Erlang/OTP 规范调整。

配置