66 lines
2.3 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
id: system-setting.video-process.howto
title: 视频转码与压缩设置
type: howto
feature: system-setting
scope: admin
locale: zh
aliases:
- 视频转换怎么开
- 视频压缩开关
- convert_video
- compress_video
- MOV 转 MP4
- 视频自动压缩
prerequisites:
- 需要系统管理员权限
- 服务器已具备 ffmpeg 等转码工具(容器化部署默认包含)
- 部署环境变量 SYSTEM_SETTING 不为 disabled
related_tools: []
related_pages: []
negative:
- 不会回溯处理历史上传的视频,只对新上传文件生效
- 转码 / 压缩失败时回退保留原文件,不会丢消息
- 不能选目标分辨率 / 码率,参数固定
last_verified: v1.7.90
---
# 视频转码与压缩设置
## 入口
桌面端:左上角头像 →「系统设置」→「系统设置」标签 →「消息相关」→「视频转换」/「视频压缩」。
涉及字段:
- `convert_video` — 视频转码开关,默认 `close`
- `compress_video` — 视频压缩开关,默认 `close`
## 各自作用
| 字段 | 作用 | 触发条件 |
|---|---|---|
| `convert_video` | 把 **MOV、WEBM** 格式视频转成 **MP4**,提升跨端兼容性 | 上传的视频后缀为 mov 或 webm |
| `compress_video` | 对 **MP4** 视频做压缩,减小体积 | 上传 / 转码后产物为 MP4 |
两者可独立开关,组合关系:
- 只开 `convert_video`MOV/WEBM → MP4原始码率体积不变
- 只开 `compress_video`MP4 直接压缩MOV/WEBM 不动
- 都开MOV/WEBM 先转 MP4 再压缩
- 都关:原文件直接保存,不做任何处理
## 开启代价
- 服务端需要 ffmpeg转码会占 CPU 与临时磁盘
- 用户上传后会有一段"处理中"的等待时间,处理完才能预览或发送
## 对原视频影响
原文件被处理后产物(转码后 MP4 / 压缩后 MP4替代原文件入库**原始 MOV / WEBM 不保留**。开关推送给前端后会在聊天预览处显示「视频处理中」气泡。
## 操作步骤
1. 进入「系统设置」→「系统设置」→「消息相关」
2. 「视频转换」「视频压缩」分别选「开启」或「关闭」
3. 「提交」保存,立即对后续上传生效
## 不支持
- 不能按文件大小阈值触发(小视频也会被压)
- 不支持自定义分辨率 / 码率 / 编码器
- 不能针对单个会话或单条消息关闭