# 腾讯 IM 图片本地归档

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

可选环境变量：

```ini
# 建议在生产环境显式配置为代码目录之外、具备持久化和备份的绝对路径
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 部署时必须挂载持久化卷。

服务启动时会主动创建并检查该目录是否可读写。启动日志中应出现：

```text
腾讯 IM 图片归档目录已就绪,/opt/apps/private-files/im-chat
```

如果日志中出现 `EACCES`，需要给实际运行 Node/PM2 的 Linux 用户授予该目录的
读写权限。

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

```text
GET /im-chat/image/:msgId
```

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