Jitsi-meetのソースを表示

[[Category:電話]]
[[Category:Voice over IP]]
[[en:Jitsi-meet]]
[https://jitsi.org Jitsi] はセキュアなビデオ会議ソリューションを簡単に構築・デプロイすることができるオープンソースプロジェクトのセットです。Jitsi の中心は Jitsi Videobridge と Jitsi Meet で、インターネット上で会議を行うことができます。コミュニティの他のプロジェクトを使うことでオーディオ会議やダイアルイン、録音、サイマルキャストなどの機能を有効化できます。

== インストール ==

''Jitsi-meet'' はいくつかのコンポーネントで設定されています。

* {{ic|jitsi-meet}}: Web インターフェイス用のファイル。Web サーバーによって提供されるファイル経由でアクセスされます。
* {{ic|jitsi-meet-prosody}}: jitsi の韻律プラグイン
* {{ic|jitsi-meet-turnserver}}: スタン/ターンサーバーを実行する設定の例
* {{ic|jitsi-videobridge}}: すべての参加者にビデオストリームを提供するビデオブリッジングサービス
* {{ic|jicofo}}: Jitsi カンファレンスの焦点は誰が話すかを決定すること
* [[Prosody]]: セットアップのベースとなる無料の XMPP サーバー

ユーザー間のインターフェースのグラフィカルな概要は、[https://jitsi.github.io/handbook/docs/devops-guide/devops-guide-manual こちら] に示されています。

git バージョン、nightly バージョン、または安定バージョンのいずれかを使用できます。

これらを同時にインストールすることは可能ですが、別のポートと韻律の複数のインスタンスを使用する必要があります (プラグインを仮想ホストごとにスコープすることはできません)

通常バージョンか bin バージョンを選択する必要があります。bin 1 は通常のバージョンと競合します (つまり、nightly と nightly-bin は同時にインストールできませんが、stable と nightly は可能です)

1 つだけを使用するようにしてください:

* [[Jitsi-meet#設定パス|stable]]
* [[Jitsi-meet#設定パス|nightly]]
* [[Jitsi-meet#設定パス|git]]

一部のパッケージでは、設定例が {{ic|/usr/share/doc}} にインストールされます。必ず {{ic|/etc/pacman.conf}} でこの行をコメント化してください:

{{bc|<nowiki>#NoExtract = usr/share/gtk-doc/html/* usr/share/doc/*</nowiki>}}

スタンドアロンサーバーを実行するには、これらのオプションパッケージが必要です:

* {{Pkg|nginx}}
* {{Pkg|coturn}}
* {{Pkg|prosody}}
* {{Pkg|lua52}}
* {{Pkg|lua52-sec}}
* {{Pkg|lua52-zlib}}
* {{AUR|lua52-event}}

== 設定 ==

{{Note|この設定により、誰もが接続できるオープンなサーバーが得られます。理論的根拠については、[https://jitsi.org/blog/security/ Jitsi 哲学] を参照してください。認証については [[Jitsi-meet#ヒントとテクニック|ヒントとテクニック]] を参照してください。}}

サーバー名が {{ic|example.com}} の場合、jitsi の一般的な選択は {{ic|meet.example.com}} になりますが、自由に選択できます。ただし、セキュリティの観点から、独自のサブドメインで Web アプリをホストすることが強く推奨されます。  選択したサブドメインのエントリでサーバーの DNS レコードを更新する必要があります (上記の例では {{ic|meet}}) 残りの部分では、これが完了していることを前提としています。

また、{{ic|meet.example.com}} ドメインの SSL/TLS 証明書も必要です。無料の証明書を取得する方法については、[[certbot]] を参照してください。

以下では、次のプレースホルダーが使用されます:

* {{ic|JITSIFQDN}}: {{ic|jitsi-meet}} ドメイン、例: {{ic|meet.example.com}}
* {{ic|SECRET_JVB_USER}}: ビデオブリッジのパスワード
* {{ic|SECRET_FOCUS_USER}}: 認証者のパスワード

パスワードは、{{ic|mktemp -u XXXXXXXX}} または {{ic|pwgen}} などの安全な方法で取得する必要があります。'''必ず別の安全なパスワードを使用してください。'''

=== 設定パス ===

{| class="wikitable" 
|-
! パッケージ
! 設定パス
|-
| colspan="2" {{C|'''Stable'''}}
|-
| {{AUR|jitsi-meet}}<br/>{{AUR|jitsi-meet-bin}}
| {{ic|/etc/webapps/jitsi-meet}}
|-
| {{AUR|jitsi-meet-prosody}}<br/>{{AUR|jitsi-meet-prosody-bin}}
| {{ic|/usr/lib/jitsi-meet-prosody}}
|-
| {{AUR|jitsi-meet-turnserver}}<br/>{{AUR|jitsi-meet-turnserver-bin}}
| {{ic|/usr/share/doc/jitsi-meet-turnserver}}
|-
| {{AUR|jicofo}}<br/>{{AUR|jicofo-bin}}
| {{ic|/etc/jicofo}}
|-
| {{AUR|jitsi-videobridge}}<br/>{{AUR|jitsi-videobridge-bin}}
| {{ic|/etc/jitsi-videobridge}}
|-
| colspan="2" {{C|'''Nightly'''}}
|-
| {{AUR|jitsi-meet-nightly}}<br/>{{AUR|jitsi-meet-nightly-bin}}
| {{ic|/etc/webapps/jitsi-meet-nightly}}
|-
| {{AUR|jitsi-meet-prosody-nightly}}<br/>{{AUR|jitsi-meet-prosody-nightly-bin}}
| {{ic|/usr/lib/jitsi-meet-prosody-nightly}}
|-
| {{AUR|jitsi-meet-turnserver-nightly}}<br/>{{AUR|jitsi-meet-turnserver-nightly-bin}}
| {{ic|/usr/share/doc/jitsi-meet-turnserver-nightly}}
|-
| {{AUR|jicofo-nightly}}<br/>{{AUR|jicofo-nightly-bin}}
| {{ic|/etc/jicofo-nightly}}
|-
| {{AUR|jitsi-videobridge-nightly}}<br/>{{AUR|jitsi-videobridge-nightly-bin}}
| {{ic|/etc/jitsi-videobridge-nightly}}
|-
| colspan="2" {{C|'''Git'''}}
|-
| {{AUR|jitsi-meet-git}}
| {{ic|/etc/webapps/jitsi-meet-git}}
|-
| {{AUR|jitsi-meet-prosody-git}}
| {{ic|/usr/lib/jitsi-meet-prosody-git}}
|-
| {{AUR|jitsi-meet-turnserver-git}}
| {{ic|/usr/share/doc/jitsi-meet-turnserver-git}}
|-
| {{AUR|jicofo-git}}
| {{ic|/etc/jicofo-git}}
|-
| {{AUR|jitsi-videobridge-git}}
| {{ic|/etc/jitsi-videobridge-git}}
|}

=== ループバック ===

jitsi-meet コンポーネントがローカル IP を使用して相互に到達できるようにします。ドメインがサーバーの実際の IP を返さない Cloudflare のようなプロキシの背後にある場合でも機能します。

{{ic|/etc/hosts}} 内:

{{bc|1=
127.0.0.1 '''JITSIFQDN''' auth.'''JITSIFQDN'''
::1 '''JITSIFQDN''' auth.'''JITSIFQDN'''
}}

=== prosody の設定 ===

{{Pkg|prosody}} は前提条件であり、Jitsi サービス用の構成をそれに追加する必要があります。prosody サーバーをまだセットアップしていない場合は、今すぐ {{Pkg|prosody}} と {{Pkg|lua52-sec}} をインストールしてください。prosody 設定の残りの部分では、prosody がローカルにインストールされていることを前提としています。

パッケージ {{AUR|jitsi-meet-prosody}} は、簡単にカスタマイズできる設定を提供します。

{{bc|<nowiki>
# cd /etc/prosody
# mkdir conf.d
# cp /usr/share/doc/jitsi-meet-prosody/prosody.cfg.lua-jvb.example conf.d/jitsi.cfg.lua
</nowiki>}}

次に、これを末尾に追加します:

{{hc|/etc/prosody/prosody.cfg.lua|2=
Include "conf.d/*.cfg.lua"
}}

設定をカスタマイズします:

{{hc|/etc/prosody/conf.d/jitsi.cfg.lua|2=
-- replace all occurences of '''jitmeet.example.com''' by '''JITSIFQDN'''
-- replace all occurences of '''focusUser''' by '''focus'''
-- then add or update those section

VirtualHost "'''JITSIFQDN'''"
    ssl = {
        key = "/etc/prosody/certs/'''JITSIFQDN'''.key";
        certificate = "/etc/prosody/certs/'''JITSIFQDN'''.crt";
    }

VirtualHost "auth.'''JITSIFQDN'''"
    ssl = {
        key = "/etc/prosody/certs/auth.'''JITSIFQDN'''.key";
        certificate = "/etc/prosody/certs/auth.'''JITSIFQDN'''.crt";
    }
    authentication = "internal_hashed"
}}

{{hc|/etc/prosody/conf.d/jitsi.cfg.lua|2=
-- Proxy to jicofo's user JID, so that it does not have to register as a component.
Component "focus.'''JITSIFQDN'''" "client_proxy"
    target_address = "focus@auth.'''JITSIFQDN'''"
}}

ここで、'''JITSIFQDN''' および '''JITSIFQDN''' の証明書を生成する必要があります。

certbot を使用する場合は、次のコマンドを使用して証明書をインポートできます:

 # prosodyctl --root cert import /etc/letsencrypt/live

自己生成した証明書を使用したい場合は、以下を使用できます:

{{bc|1=
[prosody]$ prosodyctl cert generate '''JITSIFQDN'''
[prosody]$ prosodyctl cert generate auth.'''JITSIFQDN'''
# mv /var/lib/prosody/*.{crt,cnf,key} /etc/prosody/certs/
# trust anchor /etc/prosody/certs/'''JITSIFQDN'''.crt
# trust anchor /etc/prosody/certs/auth.'''JITSIFQDN'''.crt
# update-ca-trust
}}

ユーザー jvb と focus を登録します:
 
{{bc|1=
# prosodyctl register jvb auth.'''JITSIFQDN''' '''SECRET_JVB_USER'''
# prosodyctl register focus auth.'''JITSIFQDN''' '''SECRET_FOCUS_USER'''
# prosodyctl mod_roster_command subscribe focus.'''JITSIFQDN''' focus@auth.'''JITSIFQDN'''
}}

次に、{{ic|prosody.service}} を [[再起動]] (または、インストールしたばかりの場合は [[起動/有効化]]) します。

=== jitsi-videobridge の設定 ===

jitsi-videobridge の設定。'''nightly''' および '''git''' バージョンの場合は、'''-nightly''' または '''-git''' を '''/etc/jitsi-videobridge''' に追加します。

MUC_NICKNAME の場合は、'''uuidgen''' コマンドを使用します。

{{hc|/etc/jitsi-videobridge/sip-communicator.properties|2=
org.jitsi.videobridge.xmpp.user.shard.DOMAIN=auth.'''JITSIFQDN'''
org.jitsi.videobridge.xmpp.user.shard.PASSWORD='''SECRET_JVB_USER'''
org.jitsi.videobridge.xmpp.user.shard.MUC_JIDS=JvbBrewery@internal.auth.'''JITSIFQDN'''
org.jitsi.videobridge.xmpp.user.shard.MUC_NICKNAME='''UUIDGEN_RESULT'''
}}

{{ic|jitsi-videobridge.service}} を [[起動/有効化]] してください。

=== jicofo の設定 ===

jicofo の設定。nightly および git バージョンの場合は、/etc/jitsi-videobridge に -nightly または -git を追加します。

{{hc|/etc/jicofo/jicofo.conf|2=
jicofo {
  xmpp: {
    client: {
      client-proxy: "focus.'''JITSIFQDN'''"
      xmpp-domain: "'''JITSIFQDN'''"
      domain: "auth.'''JITSIFQDN'''"
      username: "focus"
      password: "'''SECRET_FOCUS_USER'''"
      conference-muc-jid = conference.'''JITSIFQDN'''
    }
    trusted-domains: [ "recorder.'''JITSIFQDN'''" ]
  }
  bridge: {
    brewery-jid: "JvbBrewery@internal.auth.'''JITSIFQDN'''"
  }
}
}}

{{ic|jicofo}} サービスを[[起動|起動・有効化]]してください。

=== jitsi-meet の設定 ===

jitsi-meet Web アプリの設定。'''nightly''' および '''git''' バージョンの場合は、'''-nightly''' または '''-git''' を '''/etc/jitsi-videobridge''' に追加します。

{{hc|/etc/webapps/jitsi-meet/config.js|2=
var config = {
  hosts: {
    domain: ''''JITSIFQDN'''',
    // ...
    muc: 'conference.'''JITSIFQDN''''
  },
  bosh: '//'''JITSIFQDN'''/http-bind',
  // ...
}
}}

=== nginx の設定 ===

[[nginx#TLS]] の説明に従って、TLS を使用して [[nginx]] を設定します。

提供された例をコピーしてみましょう。

{{bc|1=
# cd /etc/nginx
# mkdir sites
# cp /usr/share/doc/jitsi-meet/jitsi-meet.example sites/jitsi.conf
}}

次に、それをメイン設定に含めます:
{{hc|/etc/nginx/nginx.conf|2=
http {
    // ...
    // this should be placed near to the close bracket of the http block
    include sites/*.conf;
}
}}

次に、jitsi 設定を自分の設定に変更します:
{{hc|/etc/nginx/sites/jitsi.conf|2=
server {
  # ...
  server_name '''JITSIFQDN''';

  # ...
  # use prosody path directly
  ssl_certificate /etc/prosody/certs/'''JITSIFQDN'''.crt;
  ssl_certificate_key /etc/prosody/certs/'''JITSIFQDN'''.key;
  # or use letencrypt path
  ssl_certificate /etc/letsencrypt/live/'''JITSIFQDN'''/fullchain.pem;
  ssl_certificate_key /etc/letsencrypt/live/'''JITSIFQDN'''/privkey.pem;

  # set the config path
  # replace alias /etc/jitsi/meet/jitmeet.example.com-config.js by
  location = /config.js {
    alias /etc/webapps/jitsi-meet/config.js;
  }
  # ...
  location ~ ^/([^/?&:'"]+)/config.js$
  {
    set $subdomain "$1.";
    set $subdir "$1/";
    alias /etc/webapps/jitsi-meet/config.js;
  }
}
}}

それから {{ic|nginx.service}} を [[再起動]] してください。

== ヒントとテクニック ==

=== NAT 経由で実行 ===

以下のポートをサーバーに転送する必要があります:

HTTPS:

*TCP/443

Jitsi Videobridge:

*TCP/4443
*UDP/10000

=== SIP への Jitsi ゲートウェイ (Jigasi) ===

Jitsi-meet ミーティングを従来の SIP とインターフェースするには、{{AUR|jigasi}} または {{AUR|jigasi-git}} をインストールし、prosody 設定を編集します:

{{hc|/etc/prosody/prosody.cfg.lua|2=
Component "callcontrol.'''JITSIFQDN'''"
    component_secret = "'''SECRET_JIGASI_USER'''"
}}

SIP アクセス認証情報を入力します ({{ic|SIPUSER}} {{ic|SIPSERVER}} および {{ic|SIPPASSWORD}})

{{hc|/opt/jigasi/jigasi-home/sip-communicator.properties|2=
net.java.sip.communicator.impl.protocol.sip.acc1403273890647.ACCOUNT_UID=SIP\:"SIPUSER@SIPSERVER"
net.java.sip.communicator.impl.protocol.sip.acc1403273890647.PASSWORD=SIPPASSWORD
net.java.sip.communicator.impl.protocol.sip.acc1403273890647.SERVER_ADDRESS=SIPSERVER
net.java.sip.communicator.impl.protocol.sip.acc1403273890647.USER_ID=SIPUSER
}}

SIP が接続しているデフォルトのルーム名を変更するには、上記の設定の {{ic|org.jitsi.jigasi.DEFAULT_JVB_ROOM_NAME}} を変更します。

次に、jigasi 設定を編集します

{{hc|/etc/jitsi/jigasi/config|2=
JIGASI_HOST=callcontrol.'''JITSIFQDN'''
JIGASI_HOSTNAME=jitsi-videobridge.'''JITSIFQDN'''
JIGASI_SECRET='''SECRET_JIGASI_USER'''
JIGASI_OPTS=""
LOGFILE=/var/log/jitsi/jigasi.log
}}

{{hc|/opt/jitsi-meet/config.js|2=
hosts.call_control = 'callcontrol.meet.jit.si'
}}

次に、{{ic|jigasi.service}} を [[起動/有効化]] します。

=== Access restrictions for room creation ===

To restrict video conference room '''creation''' to authenticated users, you can do the following steps. Note that participants to the meeting are still not authenticated!

Add authentication to the jitsi domain in prosody and add a new virtual host for guests:

{{hc|/etc/prosody/conf.d/jitsi.cfg.lua|2=
-- change authentification of your domain
VirtualHost "'''JITSIFQDN'''"
    authentification = "internal_plain"

-- add guest virtual host to allow anonymous user to join your room
VirtualHost "guest.'''JITSIFQDN'''"
    authentication = "jitsi-anonymous"
    c2s_require_encryption = false
    modules_enabled = {
        -- copy the content of the modules_enabled
        -- of the VirtualHost "'''JITSIFQDN'''"
        -- remove only the module "muc_lobby_rooms" of the list
        -- example:
        "bosh";
        "pubsub";
        "ping"; -- Enable mod_ping
        "speakerstats";
        "external_services";
        "conference_duration";
    }
}}

Edit the configuration file for {{ic|jitsi-meet}}:

{{hc|/etc/webapps/jitsi-meet/config.js|2=
var config = {
  host: {
    // anonymous users need to use a dedicated muc without authentication
    anonymousdomain: 'guest.'''JITSIFQDN'''',
  },
}
}}

Add authentication for {{ic|jicofo}}:

{{hc|/etc/jicofo/jicofo.conf|2=
jicofo {
  authentication {
    enabled = true
    type = XMPP
    login-url = '''JITSIFQDN'''
    enable-auto-login = true
  }
}
}}

Then create the desired users via

{{bc|1=
# prosodyctl register <username> '''JITSIFQDN''' <password>
}}

Only if you are using {{ic|jigasi}} (if you do not know, you do not) edit the SIP interface to not allow anonymous authentication:

{{hc|/etc/jitsi/jigasi/sip-communicator.properties|2=
org.jitsi.jigasi.xmpp.acc.ANONYMOUS_AUTH=false
}}

These steps are taken from [https://github.com/jitsi/jicofo#secure-domain this guide].

=== Access restrictions with JWT token ===

To restrict video conference room '''creation''' to users authenticate with a JWT token (external service for authentication), you can do the following steps. Note that participants to the meeting are still not authenticated!

Install those dependencies:

* {{AUR|lua52-base64}}
* {{Pkg|lua52-basexx}}
* {{AUR|lua52-cjson}}
* {{AUR|lua52-jwtjitsi}}
* {{Pkg|lua52-luaossl}}

Add authentication to the jitsi domain in prosody and add a new virtual host for guests:

{{hc|/etc/prosody/conf.d/jitsi.cfg.lua|2=
-- change authentification of your domain
VirtualHost "'''JITSIFQDN'''"
    authentification = "token"
    app_id = "APP_ID"
    app_secret = "APP_SECRET"
    allow_empty_token = false
    modules_enabled = {
        -- keep existing modules and add
        "presence_identity";
    }
    c2s_require_encryption = false

-- add guest virtual host to allow anonymous user to join your room
VirtualHost "guest.'''JITSIFQDN'''"
    authentication = "jitsi-anonymous"
    c2s_require_encryption = false
    modules_enabled = {
        -- copy the content of the modules_enabled
        -- of the VirtualHost "'''JITSIFQDN'''"
        -- remove only the module "muc_lobby_rooms" of the list
        -- example:
        "bosh";
        "pubsub";
        "ping"; -- Enable mod_ping
        "speakerstats";
        "external_services";
        "conference_duration";
        "presence_identity";
    }

Component "conference.'''JITSIFQDN'''" "muc"
    modules_enabled = {
        -- add this to the modules_enabled
        "token_verification";
    }
}}

Edit the configuration file for {{ic|jitsi-meet}}:

{{hc|/etc/webapps/jitsi-meet/config.js|2=
var config = {
  host: {
    // anonymous users need to use a dedicated muc without authentication
    anonymousdomain: 'guest.'''JITSIFQDN'''',
  },
}
}}

Add authentication for {{ic|jicofo}}:

{{hc|/etc/jicofo/jicofo.conf|2=
jicofo {
  authentication {
    enabled = true
    type = JWT
    login-url = '''JITSIFQDN'''
    enable-auto-login = true
  }
}
}}

Then [[restart]] {{ic|prosody.service}} (or [[start/enable]] it if it was just installed).
And [[restart]] {{ic|jicofo.service}} (or [[start/enable]] it if it was just installed).

Now you can use a JWT token to authenticate an user.

You can read the spec here: [https://github.com/jitsi/lib-jitsi-meet/blob/master/doc/tokens.md Jitsi Meet Tokens]

Here an quick example in nodejs:

{{bc|<nowiki>
const jwt = require('jsonwebtoken')
const crypto = require('crypto');
const words = require('random-words')
const yourDomain = "JITSIFQDN"
const appId = "APP_ID"
const appSecret = "APP_SECRET"
const userName = "YOUR_USERNAME"
const userEmail = "YOUR_EMAIL"

function getBody(domain, appId, name, email, room) {
    const md5Email = crypto.createHash('md5').update(email).digest("hex");
    const id = crypto.createHash('sha1').update(`${name}:${email}`).digest("hex")

    return {
        context: {
            user: {
                avatar: `https:/gravatar.com/avatar/${md5Email}`,
                name,
                email,
                id,
            },
            group: 'users'
        },
        "aud": "jitsi",
        "iss": appId,
        "sub": domain,
        room,
    }
}

const room = process.argv[2] || words({exactly: 3, join: '-'})

const data = getBody(
    yourDomain,
    appId,
    userName,
    userEmail,
    room,
)

const options = {
    algorithm: 'HS256',
    expiresIn: '2h',
}

const jwtToken = jwt.sign(data, appSecret, options)

console.log(`https://${yourDomain}/${room}?jwt=${jwtToken}`)
</nowiki>}}

=== Log evaluation ===

For a publicly available IP address the above configuration leads to a public video conference server. To monitor server use one can use [[journalctl]] to get an at least vague idea of the usage:

 # journalctl --unit=jicofo.service --grep="created new conference" --output cat

shows all events of new chat room creation and

 # journalctl --unit=jicofo.service --grep="Stopped" --output cat

shows all events of chat room destruction.

Grepping for 'member' also gives you (anonymous!) information on the participants.

=== 独自の STUN サーバーを実行する ===

デフォルトでは、Jitsi Meet は jitsi.org の STUN サーバーを使用します。{{Pkg|coturn}} を使用し、jitsi-meet の設定で設定することで、独自の STUN サーバーを簡単に実行できます。

== 参照 ==

*[https://haste.rys.pw/uzisosiram.bash Notes by C0rn3j]
*[https://gitlab.com/C0rn3j/configs/-/tree/master/ansible/serverPlaybooks/roles/meet/files Configurations used in the article]