matrix-docker-ansible-deploy/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-jitsi.po

557 lines
19 KiB
Plaintext
Raw Normal View History

# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2018-2024, Slavi Pantaleev, Aine Etke, MDAD community
# members
# This file is distributed under the same license as the
# matrix-docker-ansible-deploy package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2024.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: matrix-docker-ansible-deploy \n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2024-12-16 12:05+0900\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language: jp\n"
"Language-Team: jp <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.16.0\n"
#: ../../../docs/configuring-playbook-jitsi.md:1
msgid "Setting up the Jitsi video-conferencing platform (optional)"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:3
msgid ""
"The playbook can install the [Jitsi](https://jitsi.org/) video-"
"conferencing platform and integrate it with Element clients ([Element Web"
"](configuring-playbook-client-element-web.md)/Desktop, Android and iOS)."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:5
msgid ""
"Jitsi installation is **not enabled by default**, because it's not a core"
" component of Matrix services."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:7
msgid ""
"The setup done by the playbook is very similar to [docker-jitsi-"
"meet](https://github.com/jitsi/docker-jitsi-meet). You can refer to the "
"documentation there for many of the options here."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:9
msgid "Prerequisites"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:11
msgid "You may need to open the following ports to your server:"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:13
msgid "`4443/tcp` - RTP media fallback over TCP"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:14
msgid ""
"`10000/udp` - RTP media over UDP. Depending on your firewall/NAT setup, "
"incoming RTP packets on port `10000` may have the external IP of your "
"firewall as destination address, due to the usage of STUN in JVB (see "
"[`jitsi_jvb_stun_servers`](https://github.com/mother-of-all-self-hosting"
"/ansible-role-jitsi/blob/main/defaults/main.yml))."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:16
msgid "Adjusting the playbook configuration"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:18
msgid ""
"To enable Jitsi, add the following configuration to your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:24
msgid "Adjusting the Jitsi URL"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:26
msgid ""
"By default, this playbook installs Jitsi on the `jitsi.` subdomain "
"(`jitsi.example.com`) and requires you to [adjust your DNS records"
"](#adjusting-dns-records)."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:28
msgid ""
"By tweaking the `jitsi_hostname` variable, you can easily make the "
"service available at a **different hostname** than the default one."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:30
msgid ""
"Example additional configuration for your "
"`inventory/host_vars/matrix.example.com/vars.yml` file:"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:37
msgid "Adjusting DNS records"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:39
msgid ""
"Once you've decided on the domain and path, **you may need to adjust your"
" DNS** records to point the Jitsi domain to the Matrix server."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:41
msgid ""
"By default, you will need to create a CNAME record for `jitsi`. See "
"[Configuring DNS](configuring-dns.md) for details about DNS changes."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:43
msgid "(Optional) Configure Jitsi authentication and guests mode"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:45
msgid ""
"By default the Jitsi Meet instance does not require any kind of login and"
" is open to use for anyone without registration."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:47
msgid ""
"If you're fine with such an open Jitsi instance, please skip to "
"[Installing](#installing)."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:49
msgid ""
"If you would like to control who is allowed to open meetings on your new "
"Jitsi instance, then please follow the following steps to enable Jitsi's "
"authentication and optionally guests mode."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:51
msgid ""
"Currently, there are three supported authentication modes: 'internal' "
"(default), 'matrix' and 'ldap'."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:53
msgid ""
"**Note**: Authentication is not tested via the playbook's self-checks. We"
" therefore recommend that you manually verify if authentication is "
"required by jitsi. For this, try to manually create a conference on "
"jitsi.example.com in your browser."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:55
msgid "Authenticate using Jitsi accounts (Auth-Type 'internal')"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:57
msgid ""
"The default authentication mechanism is 'internal' auth, which requires "
"jitsi-accounts to be setup and is the recommended setup, as it also works"
" in federated rooms. With authentication enabled, all meeting rooms have "
"to be opened by a registered user, after which guests are free to join. "
"If a registered host is not yet present, guests are put on hold in "
"individual waiting rooms."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:59
msgid ""
"Add these lines to your `inventory/host_vars/matrix.example.com/vars.yml`"
" configuration:"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:71
msgid ""
"**Caution**: Accounts added here and subsequently removed will not be "
"automatically removed from the Prosody server until user account cleaning"
" is integrated into the playbook."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:73
msgid ""
"**If you get an error** like this: \"Error: Account creation/modification"
" not supported.\", it's likely that you had previously installed Jitsi "
"without auth/guest support. In such a case, you should look into "
"[Rebuilding your Jitsi installation](#rebuilding-your-jitsi-"
"installation)."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:75
msgid "Authenticate using Matrix OpenID (Auth-Type 'matrix')"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:77
msgid ""
"**Attention: Probably breaks Jitsi in federated rooms and does not allow "
"sharing conference links with guests.**"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:79
msgid ""
"Using this authentication type require a [Matrix User Verification "
"Service](https://github.com/matrix-org/matrix-user-verification-service)."
" By default, this playbook creates and configures a user-verification-"
"service to run locally, see [configuring-user-verification-service"
"](configuring-playbook-user-verification-service.md)."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:81
msgid "To enable set this configuration at host level:"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:89
msgid ""
"For more information see also [https://github.com/matrix-org/prosody-mod-"
"auth-matrix-user-verification](https://github.com/matrix-org/prosody-mod-"
"auth-matrix-user-verification)."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:91
msgid "Authenticate using LDAP (Auth-Type 'ldap')"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:93
msgid "An example LDAP configuration could be:"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:113
msgid ""
"For more information refer to the [docker-jitsi-"
"meet](https://github.com/jitsi/docker-jitsi-meet#authentication-using-"
"ldap) and the [saslauthd `LDAP_SASLAUTHD`](https://github.com/winlibs"
"/cyrus-sasl/blob/master/saslauthd/LDAP_SASLAUTHD) documentation."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:115
msgid "(Optional) Making your Jitsi server work on a LAN"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:117
msgid ""
"By default the Jitsi Meet instance does not work with a client in LAN "
"(Local Area Network), even if others are connected from WAN. There are no"
" video and audio. In the case of WAN to WAN everything is ok."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:119
msgid ""
"The reason is the Jitsi VideoBridge git to LAN client the IP address of "
"the docker image instead of the host. The "
"[documentation](https://jitsi.github.io/handbook/docs/devops-guide"
"/devops-guide-docker/#running-behind-nat-or-on-a-lan-environment) of "
"Jitsi in docker suggest to add `JVB_ADVERTISE_IPS` in enviornment "
"variable to make it work."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:121
msgid "Here is how to do it in the playbook."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:123
msgid ""
"Add these two lines to your "
"`inventory/host_vars/matrix.example.com/vars.yml` configuration:"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:130
msgid "(Optional) Fine tune Jitsi"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:132
msgid ""
"Sample **additional** `inventory/host_vars/matrix.example.com/vars.yml` "
"configuration to save up resources (explained below):"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:147
msgid ""
"You may want to **suspend unused video layers** until they are requested "
"again, to save up resources on both server and clients. Read more on this"
" feature [here](https://jitsi.org/blog/new-off-stage-layer-suppression-"
"feature/)"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:149
msgid ""
"You may wish to **disable audio levels** to avoid excessive refresh of "
"the client-side page and decrease the CPU consumption involved."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:151
msgid ""
"You may want to **limit the number of video feeds forwarded to each "
"client**, to save up resources on both server and clients. As clients "
"bandwidth and CPU may not bear the load, use this setting to avoid lag "
"and crashes. This feature is found by default in other webconference "
"applications such as Office 365 Teams (limit is set to 4). Read how it "
"works [here](https://github.com/jitsi/jitsi-"
"videobridge/blob/master/doc/last-n.md) and performance evaluation on this"
" [study](https://jitsi.org/wp-"
"content/uploads/2016/12/nossdav2015lastn.pdf)."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:153
msgid ""
"You may want to **limit the maximum video resolution**, to save up "
"resources on both server and clients."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:155
msgid "(Optional) Specify a Max number of participants on a Jitsi conference"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:157
msgid ""
"The playbook allows a user to set a max number of participants allowed to"
" join a Jitsi conference. By default there is no limit."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:159
msgid ""
"In order to set the max number of participants use the following "
"**additional** configuration:"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:165
msgid "(Optional) Additional JVBs"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:167
msgid ""
"By default, a single JVB ([Jitsi VideoBridge](https://github.com/jitsi"
"/jitsi-videobridge)) is deployed on the same host as the Matrix server. "
"To allow more video-conferences to happen at the same time, you may need "
"to provision additional JVB services on other hosts."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:169
msgid ""
"There is an ansible playbook that can be run with the following tag: "
"`ansible-playbook -i inventory/hosts --limit jitsi_jvb_servers "
"jitsi_jvb.yml --tags=common,setup-additional-jitsi-jvb,start`"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:171
msgid ""
"For this role to work you will need an additional section in the ansible "
"hosts file with the details of the JVB hosts, for example:"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:178
msgid ""
"Each JVB will require a server ID to be set so that it can be uniquely "
"identified and this allows Jitsi to keep track of which conferences are "
"on which JVB. The server ID is set with the variable "
"`jitsi_jvb_server_id` which ends up as the JVB_WS_SERVER_ID environment "
"variables in the JVB docker container. This variable can be set via the "
"host file, a parameter to the ansible command or in the `vars.yaml` for "
"the host which will have the additional JVB. For example:"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:190
msgid ""
"Note that the server ID `jvb-1` is reserved for the JVB instance running "
"on the Matrix host and therefore should not be used as the ID of an "
"additional jvb host."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:192
msgid ""
"The additional JVB will also need to expose the colibri web socket port "
"and this can be done with the following variable:"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:198
msgid ""
"The JVB will also need to know where the prosody xmpp server is located, "
"similar to the server ID this can be set in the vars for the JVB by using"
" the variable `jitsi_xmpp_server`. The Jitsi prosody container is "
"deployed on the Matrix server by default so the value can be set to the "
"Matrix domain. For example:"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:204
msgid ""
"However, it can also be set the ip address of the Matrix server. This can"
" be useful if you wish to use a private ip. For example:"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:210
msgid ""
"For the JVB to be able to contact the XMPP server, the latter must expose"
" the XMPP port (5222). By default, the Matrix server does not expose the "
"port; only the XMPP container exposes it internally inside the host, "
"which means that the first JVB (which runs on the Matrix server) can "
"reach it but the additional JVB cannot. The port is exposed by setting "
"`jitsi_prosody_container_jvb_host_bind_port` like this:"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:216
msgid "(The default is empty; if it's set then docker forwards the port.)"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:218
msgid ""
"Applied together this will allow you to provision extra JVB instances "
"which will register themselves with the prosody service and be available "
"for jicofo to route conferences too."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:220
msgid ""
"To make Traefik reverse-proxy to these additional JVBs (living on other "
"hosts), **you would need to add the following Traefik configuration "
"extension**:"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:256
msgid "(Optional) Enable Gravatar"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:258
msgid ""
"In the default Jisti Meet configuration, gravatar.com is enabled as an "
"avatar service. This results in third party request leaking data to "
"gravatar. Since Element clients already send the url of configured Matrix"
" avatars to Jitsi, we disabled gravatar."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:260
msgid "To enable Gravatar set:"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:266
msgid ""
"**Beware**: This leaks information to a third party, namely the Gravatar-"
"Service (unless configured otherwise: gravatar.com). Besides metadata, "
"this includes the Matrix user_id and possibly the room identifier (via "
"`referrer` header)."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:268
msgid "Installing"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:270
msgid ""
"After configuring the playbook and potentially [adjusting your DNS "
"records](#adjusting-dns-records), run the playbook with [playbook tags"
"](playbook-tags.md) as below:"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:277
msgid ""
"The shortcut commands with the [`just` program](just.md) are also "
"available: `just install-all` or `just setup-all`"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:279
msgid ""
"`just install-all` is useful for maintaining your setup quickly ([2x-5x "
"faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-"
"runtime) than `just setup-all`) when its components remain unchanged. If "
"you adjust your `vars.yml` to remove other components, you'd need to run "
"`just setup-all`, or these components will still remain installed. Note "
"these shortcuts run the `ensure-matrix-users-created` tag too."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:281
msgid "Usage"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:283
msgid "You can use the self-hosted Jitsi server in multiple ways:"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:285
msgid ""
"**by adding a widget to a room via Element Web** (the one configured by "
"the playbook at `https://element.example.com`). Just start a voice or a "
"video call in a room containing more than 2 members and that would create"
" a Jitsi widget which utilizes your self-hosted Jitsi server."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:287
msgid ""
"**by adding a widget to a room via the Dimension integration manager**. "
"You'll have to point the widget to your own Jitsi server manually. See "
"our [Dimension integration manager](./configuring-playbook-dimension.md) "
"documentation page for more details. Naturally, Dimension would need to "
"be installed first (the playbook doesn't install it by default)."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:289
msgid ""
"**directly (without any Matrix integration)**. Just go to "
"`https://jitsi.example.com`"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:291
msgid ""
"**Note**: Element apps on mobile devices currently [don't support joining"
" meetings on a self-hosted Jitsi server](https://github.com/element-hq"
"/riot-web/blob/601816862f7d84ac47547891bd53effa73d32957/docs/jitsi.md"
"#mobile-app-support)."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:293
msgid "Troubleshooting"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:295
msgid "Rebuilding your Jitsi installation"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:297
msgid ""
"**If you ever run into any trouble** or **if you change configuration "
"(`jitsi_*` variables) too much**, we urge you to rebuild your Jitsi "
"setup."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:299
msgid ""
"We normally don't require such manual intervention for other services, "
"but Jitsi services generate a lot of configuration files on their own."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:301
msgid ""
"These files are not all managed by Ansible (at least not yet), so you may"
" sometimes need to delete them all and start fresh."
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:303
msgid "To rebuild your Jitsi configuration:"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:305
msgid ""
"ask Ansible to stop all Jitsi services: `just run-tags stop-group "
"--extra-vars=group=jitsi`"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:306
msgid ""
"SSH into the server and do this and remove all Jitsi configuration & data"
" (`rm -rf /matrix/jitsi`)"
msgstr ""
#: ../../../docs/configuring-playbook-jitsi.md:307
msgid ""
"ask Ansible to set up Jitsi anew and restart services (`just install-"
"service jitsi`)"
msgstr ""