腾讯 IM 图片本地归档

腾讯 IM 的图片消息在 /IMCallBack 入库后，会异步下载 TIMImageElem 中的 Type=1 原图并保存到服务器私有目录。归档状态保存在 Internet-hospital.im-chat-msg.imageArchive。

可选环境变量：

# 建议在生产环境显式配置为代码目录之外、具备持久化和备份的绝对路径
CONFIG_IM_IMAGE_ROOT=/data/hn-private-files/im-chat

# 默认 30MB
CONFIG_IM_IMAGE_MAX_BYTES=31457280

# 逗号分隔的腾讯图片域名后缀
CONFIG_IM_IMAGE_ALLOWED_HOSTS=.my-imcloud.com,.im.qcloud.com,.myqcloud.com

未设置 CONFIG_IM_IMAGE_ROOT 时，路径规则与现有 /upload 一致：以服务入口目录为基准，保存到 ../private-files/im-chat。例如：

源码从 hn-hlw-service/index.js 运行时，保存到项目组目录下的 private-files/im-chat，与现有 upload-files 同级。
bundle 位于 /opt/apps/hnhlw/bundle_xx.js 时，保存到 /opt/apps/private-files/im-chat，与 /opt/apps/upload-files 同级。

private-files 不会通过 Express 静态目录公开。该目录不能在发布时被清理； Docker 部署时必须挂载持久化卷。

归档成功后可通过下面的接口读取图片：

GET /im-chat/image/:msgId

当前接口按需求暂未启用 JWT，但仅允许通过 MsgId 查询数据库中归档成功的受控路径。生产使用前建议补充问诊订单权限验证。

1.4 KiB Raw Blame History Unescape Escape

腾讯 IM 图片本地归档

1.4 KiB

Raw Blame History