在线更新（OTA）¶
有效订阅（以及免费版）都包含在线更新。
检查更新¶
- 界面内：vConfig 每天检查一次 vconfig.ai，有新版本时页顶显示横幅，系统设置 → 检查更新 里能看到当前版本与发布说明。
- 命令行：
vconfigctl update --check
执行更新¶
两种方式，效果相同（界面那条最终也是在宿主机上跑同一套流程）。
在界面上点¶
系统设置 → 检查更新 → 立即升级。有新版本时按钮才会出现，升级过程中界面上能看到 每一步的进度；容器重建时页面会短暂断连，稍候自动重连并继续显示。
需要宿主机上装有升级代理。2.450.0 及之后用一键脚本装的机器自带。更早装的机器界面上 不会出现这个按钮，在宿主机上执行一次即可补上（之后就一直能在界面上升级）：
curl -fsSL https://vconfig.ai/vconfigctl -o /usr/local/bin/vconfigctl && chmod +x /usr/local/bin/vconfigctl
vconfigctl enable-ui-update
第一行不能省：enable-ui-update 是 2.450.0 才有的子命令，而需要它的正是装得更早、
手上还是老 vconfigctl 的那批机器——直接敲第二行只会得到一句"未知命令"。
代理只做一件事：看到应用放出的升级信号，就在宿主机上执行 vconfigctl update。
不会把 Docker 套接字挂进容器——那等于把宿主机的 root 交给 Web 应用。
在宿主机上敲¶
vconfigctl update
老机器建议先把这个工具本身更新一下（同上一节的那行 curl），新版跑完升级会顺手把
界面上的升级按钮也装好，这样宿主机上敲的这一次就是最后一次。
更新流程：
- 下载新版镜像并校验 SHA-256。
- 自动备份数据库与数据卷。
- 切换容器到新版本（停机通常 < 30 秒）。
- 上一版镜像保留在本地，便于回滚。
- 确认新版起来之后，自动清理更早的升级包与镜像；备份默认只留最近 5 份（
VCONFIG_KEEP_BACKUPS可调）。清理只在升级成功后进行——失败时旧包和旧镜像正是回滚的依靠。
新版本首次启动时自动执行数据库结构迁移。
回滚¶
cd /opt/vconfig
# 把 .env 中的 VCONFIG_VERSION 改回上一版本，然后：
docker compose up -d
注意
只回滚到升级前的那个版本；若新版本已迁移数据库结构，需同时恢复 /opt/vconfig/backups 中对应的数据库备份。
发布通道¶
所有客户使用 stable 通道。每个版本的发布说明见更新日志。