跳到主要内容

使用手册

1. 系统配置要求​

1.1 服务器配置​

  • 完整版最小配置：8 核 16GB
  • 不包含 AI 的最小配置：4 核 8GB
  • 不包含 AI 和录像的最小配置：2 核 4GB

说明：需根据录像数量、并发入会人数等实际业务场景，酌情提高服务器配置。

1.2 EasyDSS 配置说明及部署环境要求​

系统架构组件​

EasyDSS 包含以下核心组件：

  • dss 服务：主应用服务，负责业务逻辑处理
  • easydss 服务：实时音视频通信服务，处理音视频流传输
  • egress 服务：录制服务，负责会议录制功能
  • ingress 服务：推流服务，支持 RTMP/WHIP 等方式接入
  • Redis：分布式缓存和消息队列
  • PostgreSQL：关系型数据库，存储业务数据
  • MinIO：对象存储服务，存储音视频文件、截图等媒体资源

部署环境要求​

整体部署（推荐）​
  • CPU：至少 8 核（推荐 16 核或以上，高并发音视频流场景优先升级）
  • 内存：至少 16GB RAM（推荐 32GB 或以上，根据并发量动态调整）
  • 磁盘空间：至少 100GB 可用空间（用于存储数据库、录制文件、媒体资源等）
  • 网络带宽：建议 100Mbps 或更高（取决于音视频流的数量和质量）
组件独立部署（推荐用于生产环境）​

  • easydss 服务：

    • CPU：至少 4 核（推荐 8 核或以上）
    • 内存：至少 8GB RAM（推荐 16GB 或以上）
    • 存储：至少 20GB 可用空间
    • 网络：高带宽低延迟网络，支持大量并发连接

  • ingress 服务：

    • CPU：至少 4 核（推荐 8 核或以上）
    • 内存：至少 4GB RAM（推荐 8GB 或以上）
    • 存储：至少 20GB 可用空间
    • 网络：高带宽网络（用于接收外部推流）

  • PostgreSQL 数据库：

    • CPU：至少 2 核（推荐 4 核或以上）
    • 内存：至少 4GB RAM（推荐 8GB 或以上，根据数据量调整）
    • 存储：至少 50GB 可用空间（建议使用 SSD 存储）
    • 网络：稳定低延迟网络连接

  • MinIO 存储服务：

    • CPU：至少 4 核（推荐 8 核或以上）
    • 内存：至少 8GB RAM（推荐 16GB 或以上，影响并发处理能力）
    • 存储：根据媒体文件大小确定（建议使用 NVMe 或高速 SSD）
    • 网络：高带宽网络（用于上传下载媒体文件）

1.3 端口要求​

  • 10086：easydss 主服务端口（RoomService 和 RTC 端点）
  • 50000-50500：WebRTC UDP 端口范围（用于客户端媒体流量）

1.4 网络配置​

  • 防火墙需开放上述端口范围
  • 云环境部署时，确保安全组规则允许相应端口的流量通行
  • WebRTC 流量基于 UDP 传输，需确保 UDP 端口全网可达
  • 建议使用负载均衡器处理 SSL/TLS 终止和域名解析

注意事项：

  • Redis 配置：EasyDSS 集群依赖 Redis 服务，需确保 Redis 稳定运行，且与所有 EasyDSS 节点网络连通
  • 监控告警：启用 Prometheus 指标收集功能，便于实时监控服务运行状态
  • 安全设置：
    • 生产环境禁止使用默认配置，务必配置强密钥对
    • 为 PostgreSQL 数据库和 MinIO 存储服务设置高强度密码
    • 所有服务间通信均需启用 SSL/TLS 加密
  • 存储规划：
    • 根据预期的媒体文件存储规模，合理规划 MinIO 存储容量
    • 建立定期清理机制，删除过期录制文件以节省存储空间Ï

2. 用户登录​

启动服务后，在浏览器中打开登录页面 http://ip:port（示例：https://127.0.0.1:10086，IP 地址和端口号需根据实际部署环境填写）。

系统默认初始账号和密码为 easydss/easydss。

image-20260205153758085

3. 点播管理​

3.1 视频上传​

支持文件批量上传，可批量设置视频分类、水印、转码方案等参数。文件上传完成后，可修改单个视频文件的名称。

系统兼容 mp4、wmv、mov、avi 等主流视频格式。注意：上传文件必须包含后缀名，否则会上传失败。

image-20260205154050612

3.2 视频管理​

  • 视频附件：可给视频绑定附件资源，绑定后的附件会在门户网站首页展示，支持用户下载。
  • 视频状态：视频上传并转码成功后，状态会显示为 “待审批”，需在视频审批页面完成审批操作。

image-20260205154217131

3.3 分类管理​

  • 优先级展示：前四条创建的分类会展示在门户网站首页导航栏。
  • 层级限制：最多可创建三级分类，顶级分类支持拖拽排序。

image-20260205154421633

3.4 视频审批​

用于审批已上传完成的视频，仅审批通过的视频会在门户网站侧展示。

审批记录会留存每个视频的审批人、审批时间等关键信息，支持追溯。

image-20260205154437922

3.5 学习进度​

支持查看用户的视频播放情况或单视频的用户播放数据，记录内容包含播放倍速、播放进度百分比等信息。

image-20260205154449580

4. 视频直播​

4.1 创建直播​

  • 直播类型：
    1. 公开直播：创建后会直接展示在门户网站 “直播大厅” 板块，所有用户均可参与观看。
    2. 预约直播：需指定可参与的用户范围，仅被指定的用户可在 “直播大厅 - 我的” 板块查看，其他用户无访问权限。
  • 主讲人设置：主讲人即为直播间管理员，仅主讲人可操作开启摄像头、麦克风、投屏等功能。
  • 推流配置：直播创建成功后，系统会自动生成 RTMP 推流信息，按照提示将信息填入 OBS 等推流软件即可完成推流设置。

image-20260205154830145

4.2 直播间​

  • 共享桌面：主窗口用于展示屏幕共享或推流画面，注意：屏幕共享和推流功能不可同时使用，同一时间仅能启用其中一种方式。
  • 文字聊天：管理员可查看直播间人员上线状态，发送的聊天消息全体在线用户均可查看。
  • 直播课件：管理员可上传、管理课件文件；普通用户仅可下载课件，无管理权限。
  • 投屏与推流：投屏画面或推流画面会作为直播间主画面展示。

image-20260205154916314

4.3 录像管理​

支持对直播录像进行查看、预览、管理等操作。

image-20260205154940311

4.4 分享功能​

可新建直播间分享链接，也可复制已创建的分享链接。分享链接在后台删除后，将立即失效，无法访问。

image-20260205155006970

5. 会议管理​

5.1 新增会议​

  • 开始时间：用于在分享链接中展示会议预计开始时间，默认值为最近的整点时刻。
  • 功能设置：可开启 / 关闭 AI 字幕、AI 纪要功能，关闭后会议内将禁用对应功能。
  • 会议密码：设置密码后，除会议房户外，其他所有参会用户均需输入密码方可进入会议。
  • 私密性规则：用户仅能查看自己创建的会议，其他用户需通过分享链接或会议号才能进入会议房间。

image-20260205155042596

5.2 会议操作​

  • AI 字幕：开启后仅当前操作人可查看字幕内容。
  • AI 纪要：开启后仅当前操作人可查看纪要内容，系统每 2 分钟自动总结一次会议内容。
  • 成员管理：所有参会人员均可查看会议成员列表；房主拥有指定用户禁言权限，被禁言用户无法开启麦克风发言。
  • 录像权限：仅会议房主可发起录像操作。
  • 结束会议：管理员可选择 “全员结束会议”（所有用户将被移出房间）或 “仅自己离开会议”（仅操作人退出房间）。

image-20260205155546850

5.3 分享功能​

点击 “分享” 按钮后，分享内容会自动复制到剪贴板，可通过任意通讯软件转发。

支持通过 “分享链接", “会议号” 两种方式进入会议。

小王 邀请您加入【EasyDSS 功能研讨会会议室}]
会议时间：2026/02/05 16:00-18:00 (GMT+08:00)

点击链接直接加入会议：
https://demo.easydss.com:10086/web/share?link=xxx&type=meeting

# 会议号：31475xxxx

5.4 录像管理​

支持对会议录像进行查看、预览、管理等操作。

image-20260205155640482

6. 资源管理​

用于统一管理系统内的附件资源、直播 / 会议分享链接等内容。

image-20260205155651771

7. 用户管理​

7.1 角色管理​

  • 权限绑定：角色可绑定系统菜单权限，未绑定任何菜单的角色为普通用户，无后台系统访问权限。
  • 默认角色：系统内置三个默认角色，不支持修改或删除；为角色分配菜单后，对应用户仅能查看并使用已分配的功能模块。

image-20260205155712223

7.2 黑名单管理​

可将指定用户加入黑名单，加入后用户无法正常登录；删除黑名单记录或黑名单过期后，用户可恢复正常登录权限。

image-20260205155726042

8. 系统设置​

8.1 水印管理​

支持添加文字水印、图片水印两种类型，右侧预览区域可直接拖动水印调整位置，还可自定义水印大小、透明度等样式参数。

上传视频时，可指定已配置的水印模板应用至视频。

image-20260205155818114

8.2 轮播图管理​

用于管理门户网站首页轮播图，可给轮播图设置跳转链接，支持拖拽排序。

系统会展示前 12 张轮播图至门户网站首页。

image-20260205155906480

8.3 转码模板管理​

支持上传自定义转码模板，上传视频时可指定模板完成转码。参考模板示例如下：

{
  "version": 1,
  "id": "profile_multi_bitrate",
  "name": "HLS-fMP4 多码流 (H.265)",
  "desc": "支持 480p/720p/1080p 等不同分辨率，编码为 h265/AAC，采用 fMP4 容器封装，适用于网络在线视频转码",
  "updated_at": "2026-01-08",
  "encoder": {
    "video": "libx265",
    "preset": "veryfast",
    "tag": "hvc1",
    "bitrates": {
      "1080": "4000k",
      "720": "2000k",
      "480": "800k"
    }
  },
  "command": [
    "ffmpeg",
    "-v",
    "error",
    "-hide_banner",
    "-fflags",
    "+genpts",
    "-i",
    "{{.Input}}",
    "-threads",
    "0",
    "{{.Watermark}}",
    "{{.MultiBitrate}}",
    "-f",
    "hls",
    "-hls_time",
    "30",
    "-hls_list_size",
    "0",
    "-hls_playlist_type",
    "vod",
    "-hls_segment_type",
    "fmp4",
    "-hls_segment_filename",
    "{{.OutputDir}}/stream_%v/segment_%03d.m4s",
    "-master_pl_name",
    "index.m3u8",
    "{{.OutputDir}}/stream_%v/index.m3u8"
  ]
}

9. 门户网站​

9.1 资源分类​

创建的前 4 个资源分类会展示在门户网站首页的显著位置。

image-20260205155942943

9.2 直播大厅​

  • 公开直播：所有公开类型的直播会直接展示在直播列表中。
  • 私有直播：仅预约类等私有直播会展示在用户个人中心 “我的直播” 板块。

image-20260205160141787

9.3 搜索功能​

支持全局搜索，可同时检索直播、点播两类内容。

image-20260205160216350

9.4 个人中心​

  • 个人资料：用于展示用户个人信息，支持用户自主修改登录密码。
  • 消息中心：接收并展示系统消息、用户回复消息、作业通知等各类消息提醒。
  • 历史记录：展示用户观看点播视频的历史记录，包含视频观看进度，点击记录可直接续播视频。
  • 我的收藏：展示用户收藏的直播、点播等内容，支持统一管理收藏内容，可随时取消收藏。
  • 加入会议：用户可输入分享的会议号，快速进入对应的会议房间。

image-20260205160625113