jitsi/jigasi

Jitsi Meet Jigasi 容器镜像

镜像概述和主要用途

Jigasi 容器镜像是 Jitsi Meet 视频会议系统的核心组件，作为 SIP（会话发起协议）网关，实现 Jitsi Meet 会议与传统电话网络（PSTN）或 SIP 终端的互联互通。该镜像封装了 Jigasi 服务的运行环境，便于快速集成到基于 Docker 的 Jitsi Meet 部署架构中，支持电话终端加入或呼出会议。

更多信息可参考 https://github.com/jitsi/docker-jitsi-meet 及 https://jitsi.github.io/handbook/docs/devops-guide/devops-guide-docker%E3%80%82

核心功能和特性

• SIP 协议支持：兼容标准 SIP 协议，可与 SIP 服务器、PBX 系统对接，实现电话网络与会议系统的协议转换。
• 会议互通能力：支持 SIP/PSTN 终端拨入 Jitsi Meet 会议，或从会议呼出至电话终端，实现音频流的桥接与同步。
• 容器化部署：基于 Docker 封装，简化环境依赖管理，支持快速集成到现有 Jitsi Meet Docker 架构中。

使用场景和适用范围

适用场景

• 企业或组织需为无网络接入的用户提供电话拨入会议的能力；
• 跨组织会议中需邀请传统电话用户参与；
• 集成企业 PBX 系统，实现内部电话与视频会议的统一调度。

托管替代方案

若无需自行部署基础设施，可选择 8x8 提供的 JaaS（Jitsi as a Service）。JaaS 是基于 Jitsi 技术的企业级托管服务，提供全球化部署、安全保障和品牌定制能力，适合专注于业务开发的用户。详情可访问 JaaS 官方网站。

使用方法和配置说明

前提条件

• 已部署 Docker 及 Docker Compose；
• 已完成 Jitsi Meet 基础组件部署（如 jitsi-web、prosody、jicofo，参考 https://github.com/jitsi/docker-jitsi-meet#quick-start%EF%BC%89%E3%80%82

部署示例

Docker Compose 集成

Jigasi 需作为 Jitsi Meet 整体架构的一部分部署，以下为 docker-compose.yml 中 Jigasi 服务的典型配置片段：

yaml
version: '3'

services:
  jigasi:
    image: docker.xuanyuan.run/jitsi/jigasi
    restart: unless-stopped
    networks:
      - jitsi  # 需与 Jitsi 其他组件共享同一网络
    environment:
      - TZ=Asia/Shanghai
      # SIP 服务器配置
      - JIGASI_SIP_USERNAME=your_sip_account
      - JIGASI_SIP_PASSWORD=your_sip_password
      - JIGASI_SIP_SERVER=sip.example.com
      - JIGASI_SIP_PORT=5060
      - JIGASI_SIP_TRANSPORT=udp  # 可选：udp/tcp/tls
      # Jitsi 内部认证配置
      - XMPP_AUTH_DOMAIN=auth.meet.example.com  # 与 prosody 认证域一致
      - XMPP_SERVER=prosody  # prosody 服务名（需与 Docker 网络内服务名匹配）
      - JICOFO_AUTH_USER=focus  # Jicofo 认证用户名（默认值）
      - JICOFO_AUTH_PASSWORD=your_jicofo_secret  # 与 Jicofo 配置的密码一致
    volumes:
      - ./jigasi/logs:/config/logs  # 挂载日志目录（可选）

核心配置参数

注意事项

• 依赖协调：Jigasi 需与 Jitsi Meet 核心组件（prosody、jicofo）在同一网络，且认证信息（如域名、密码）需严格匹配。
• SIP 配置验证：需确保 SIP 账号、服务器地址、端口等参数与 SIP 服务提供商配置一致，建议先通过工具（如 sip-cli）验证 SIP 连接性。
• 安全加固：生产环境中应启用 TLS 加密（JIGASI_SIP_TRANSPORT=tls），并限制容器网络访问权限，避免未授权访问。

详细配置可参考 https://jitsi.github.io/handbook/docs/devops-guide/devops-guide-docker 中的 Jigasi 专项说明。