Matrix Docker Ansible eploy
Вы не можете выбрать более 25 тем Темы должны начинаться с буквы или цифры, могут содержать дефисы(-) и должны содержать не более 35 символов.
 
 
 

558 строки
19 KiB

  1. # SOME DESCRIPTIVE TITLE.
  2. # Copyright (C) 2018-2024, Slavi Pantaleev, Aine Etke, MDAD community
  3. # members
  4. # This file is distributed under the same license as the
  5. # matrix-docker-ansible-deploy package.
  6. # FIRST AUTHOR <EMAIL@ADDRESS>, 2024.
  7. #
  8. #, fuzzy
  9. msgid ""
  10. msgstr ""
  11. "Project-Id-Version: matrix-docker-ansible-deploy \n"
  12. "Report-Msgid-Bugs-To: \n"
  13. "POT-Creation-Date: 2024-12-16 12:05+0900\n"
  14. "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
  15. "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
  16. "Language: bg\n"
  17. "Language-Team: bg <LL@li.org>\n"
  18. "Plural-Forms: nplurals=2; plural=(n != 1);\n"
  19. "MIME-Version: 1.0\n"
  20. "Content-Type: text/plain; charset=utf-8\n"
  21. "Content-Transfer-Encoding: 8bit\n"
  22. "Generated-By: Babel 2.16.0\n"
  23. #: ../../../docs/configuring-playbook-jitsi.md:1
  24. msgid "Setting up the Jitsi video-conferencing platform (optional)"
  25. msgstr ""
  26. #: ../../../docs/configuring-playbook-jitsi.md:3
  27. msgid ""
  28. "The playbook can install the [Jitsi](https://jitsi.org/) video-"
  29. "conferencing platform and integrate it with Element clients ([Element Web"
  30. "](configuring-playbook-client-element-web.md)/Desktop, Android and iOS)."
  31. msgstr ""
  32. #: ../../../docs/configuring-playbook-jitsi.md:5
  33. msgid ""
  34. "Jitsi installation is **not enabled by default**, because it's not a core"
  35. " component of Matrix services."
  36. msgstr ""
  37. #: ../../../docs/configuring-playbook-jitsi.md:7
  38. msgid ""
  39. "The setup done by the playbook is very similar to [docker-jitsi-"
  40. "meet](https://github.com/jitsi/docker-jitsi-meet). You can refer to the "
  41. "documentation there for many of the options here."
  42. msgstr ""
  43. #: ../../../docs/configuring-playbook-jitsi.md:9
  44. msgid "Prerequisites"
  45. msgstr ""
  46. #: ../../../docs/configuring-playbook-jitsi.md:11
  47. msgid "You may need to open the following ports to your server:"
  48. msgstr ""
  49. #: ../../../docs/configuring-playbook-jitsi.md:13
  50. msgid "`4443/tcp` - RTP media fallback over TCP"
  51. msgstr ""
  52. #: ../../../docs/configuring-playbook-jitsi.md:14
  53. msgid ""
  54. "`10000/udp` - RTP media over UDP. Depending on your firewall/NAT setup, "
  55. "incoming RTP packets on port `10000` may have the external IP of your "
  56. "firewall as destination address, due to the usage of STUN in JVB (see "
  57. "[`jitsi_jvb_stun_servers`](https://github.com/mother-of-all-self-hosting"
  58. "/ansible-role-jitsi/blob/main/defaults/main.yml))."
  59. msgstr ""
  60. #: ../../../docs/configuring-playbook-jitsi.md:16
  61. msgid "Adjusting the playbook configuration"
  62. msgstr ""
  63. #: ../../../docs/configuring-playbook-jitsi.md:18
  64. msgid ""
  65. "To enable Jitsi, add the following configuration to your "
  66. "`inventory/host_vars/matrix.example.com/vars.yml` file:"
  67. msgstr ""
  68. #: ../../../docs/configuring-playbook-jitsi.md:24
  69. msgid "Adjusting the Jitsi URL"
  70. msgstr ""
  71. #: ../../../docs/configuring-playbook-jitsi.md:26
  72. msgid ""
  73. "By default, this playbook installs Jitsi on the `jitsi.` subdomain "
  74. "(`jitsi.example.com`) and requires you to [adjust your DNS records"
  75. "](#adjusting-dns-records)."
  76. msgstr ""
  77. #: ../../../docs/configuring-playbook-jitsi.md:28
  78. msgid ""
  79. "By tweaking the `jitsi_hostname` variable, you can easily make the "
  80. "service available at a **different hostname** than the default one."
  81. msgstr ""
  82. #: ../../../docs/configuring-playbook-jitsi.md:30
  83. msgid ""
  84. "Example additional configuration for your "
  85. "`inventory/host_vars/matrix.example.com/vars.yml` file:"
  86. msgstr ""
  87. #: ../../../docs/configuring-playbook-jitsi.md:37
  88. msgid "Adjusting DNS records"
  89. msgstr ""
  90. #: ../../../docs/configuring-playbook-jitsi.md:39
  91. msgid ""
  92. "Once you've decided on the domain and path, **you may need to adjust your"
  93. " DNS** records to point the Jitsi domain to the Matrix server."
  94. msgstr ""
  95. #: ../../../docs/configuring-playbook-jitsi.md:41
  96. msgid ""
  97. "By default, you will need to create a CNAME record for `jitsi`. See "
  98. "[Configuring DNS](configuring-dns.md) for details about DNS changes."
  99. msgstr ""
  100. #: ../../../docs/configuring-playbook-jitsi.md:43
  101. msgid "(Optional) Configure Jitsi authentication and guests mode"
  102. msgstr ""
  103. #: ../../../docs/configuring-playbook-jitsi.md:45
  104. msgid ""
  105. "By default the Jitsi Meet instance does not require any kind of login and"
  106. " is open to use for anyone without registration."
  107. msgstr ""
  108. #: ../../../docs/configuring-playbook-jitsi.md:47
  109. msgid ""
  110. "If you're fine with such an open Jitsi instance, please skip to "
  111. "[Installing](#installing)."
  112. msgstr ""
  113. #: ../../../docs/configuring-playbook-jitsi.md:49
  114. msgid ""
  115. "If you would like to control who is allowed to open meetings on your new "
  116. "Jitsi instance, then please follow the following steps to enable Jitsi's "
  117. "authentication and optionally guests mode."
  118. msgstr ""
  119. #: ../../../docs/configuring-playbook-jitsi.md:51
  120. msgid ""
  121. "Currently, there are three supported authentication modes: 'internal' "
  122. "(default), 'matrix' and 'ldap'."
  123. msgstr ""
  124. #: ../../../docs/configuring-playbook-jitsi.md:53
  125. msgid ""
  126. "**Note**: Authentication is not tested via the playbook's self-checks. We"
  127. " therefore recommend that you manually verify if authentication is "
  128. "required by jitsi. For this, try to manually create a conference on "
  129. "jitsi.example.com in your browser."
  130. msgstr ""
  131. #: ../../../docs/configuring-playbook-jitsi.md:55
  132. msgid "Authenticate using Jitsi accounts (Auth-Type 'internal')"
  133. msgstr ""
  134. #: ../../../docs/configuring-playbook-jitsi.md:57
  135. msgid ""
  136. "The default authentication mechanism is 'internal' auth, which requires "
  137. "jitsi-accounts to be setup and is the recommended setup, as it also works"
  138. " in federated rooms. With authentication enabled, all meeting rooms have "
  139. "to be opened by a registered user, after which guests are free to join. "
  140. "If a registered host is not yet present, guests are put on hold in "
  141. "individual waiting rooms."
  142. msgstr ""
  143. #: ../../../docs/configuring-playbook-jitsi.md:59
  144. msgid ""
  145. "Add these lines to your `inventory/host_vars/matrix.example.com/vars.yml`"
  146. " configuration:"
  147. msgstr ""
  148. #: ../../../docs/configuring-playbook-jitsi.md:71
  149. msgid ""
  150. "**Caution**: Accounts added here and subsequently removed will not be "
  151. "automatically removed from the Prosody server until user account cleaning"
  152. " is integrated into the playbook."
  153. msgstr ""
  154. #: ../../../docs/configuring-playbook-jitsi.md:73
  155. msgid ""
  156. "**If you get an error** like this: \"Error: Account creation/modification"
  157. " not supported.\", it's likely that you had previously installed Jitsi "
  158. "without auth/guest support. In such a case, you should look into "
  159. "[Rebuilding your Jitsi installation](#rebuilding-your-jitsi-"
  160. "installation)."
  161. msgstr ""
  162. #: ../../../docs/configuring-playbook-jitsi.md:75
  163. msgid "Authenticate using Matrix OpenID (Auth-Type 'matrix')"
  164. msgstr ""
  165. #: ../../../docs/configuring-playbook-jitsi.md:77
  166. msgid ""
  167. "**Attention: Probably breaks Jitsi in federated rooms and does not allow "
  168. "sharing conference links with guests.**"
  169. msgstr ""
  170. #: ../../../docs/configuring-playbook-jitsi.md:79
  171. msgid ""
  172. "Using this authentication type require a [Matrix User Verification "
  173. "Service](https://github.com/matrix-org/matrix-user-verification-service)."
  174. " By default, this playbook creates and configures a user-verification-"
  175. "service to run locally, see [configuring-user-verification-service"
  176. "](configuring-playbook-user-verification-service.md)."
  177. msgstr ""
  178. #: ../../../docs/configuring-playbook-jitsi.md:81
  179. msgid "To enable set this configuration at host level:"
  180. msgstr ""
  181. #: ../../../docs/configuring-playbook-jitsi.md:89
  182. msgid ""
  183. "For more information see also [https://github.com/matrix-org/prosody-mod-"
  184. "auth-matrix-user-verification](https://github.com/matrix-org/prosody-mod-"
  185. "auth-matrix-user-verification)."
  186. msgstr ""
  187. #: ../../../docs/configuring-playbook-jitsi.md:91
  188. msgid "Authenticate using LDAP (Auth-Type 'ldap')"
  189. msgstr ""
  190. #: ../../../docs/configuring-playbook-jitsi.md:93
  191. msgid "An example LDAP configuration could be:"
  192. msgstr ""
  193. #: ../../../docs/configuring-playbook-jitsi.md:113
  194. msgid ""
  195. "For more information refer to the [docker-jitsi-"
  196. "meet](https://github.com/jitsi/docker-jitsi-meet#authentication-using-"
  197. "ldap) and the [saslauthd `LDAP_SASLAUTHD`](https://github.com/winlibs"
  198. "/cyrus-sasl/blob/master/saslauthd/LDAP_SASLAUTHD) documentation."
  199. msgstr ""
  200. #: ../../../docs/configuring-playbook-jitsi.md:115
  201. msgid "(Optional) Making your Jitsi server work on a LAN"
  202. msgstr ""
  203. #: ../../../docs/configuring-playbook-jitsi.md:117
  204. msgid ""
  205. "By default the Jitsi Meet instance does not work with a client in LAN "
  206. "(Local Area Network), even if others are connected from WAN. There are no"
  207. " video and audio. In the case of WAN to WAN everything is ok."
  208. msgstr ""
  209. #: ../../../docs/configuring-playbook-jitsi.md:119
  210. msgid ""
  211. "The reason is the Jitsi VideoBridge git to LAN client the IP address of "
  212. "the docker image instead of the host. The "
  213. "[documentation](https://jitsi.github.io/handbook/docs/devops-guide"
  214. "/devops-guide-docker/#running-behind-nat-or-on-a-lan-environment) of "
  215. "Jitsi in docker suggest to add `JVB_ADVERTISE_IPS` in enviornment "
  216. "variable to make it work."
  217. msgstr ""
  218. #: ../../../docs/configuring-playbook-jitsi.md:121
  219. msgid "Here is how to do it in the playbook."
  220. msgstr ""
  221. #: ../../../docs/configuring-playbook-jitsi.md:123
  222. msgid ""
  223. "Add these two lines to your "
  224. "`inventory/host_vars/matrix.example.com/vars.yml` configuration:"
  225. msgstr ""
  226. #: ../../../docs/configuring-playbook-jitsi.md:130
  227. msgid "(Optional) Fine tune Jitsi"
  228. msgstr ""
  229. #: ../../../docs/configuring-playbook-jitsi.md:132
  230. msgid ""
  231. "Sample **additional** `inventory/host_vars/matrix.example.com/vars.yml` "
  232. "configuration to save up resources (explained below):"
  233. msgstr ""
  234. #: ../../../docs/configuring-playbook-jitsi.md:147
  235. msgid ""
  236. "You may want to **suspend unused video layers** until they are requested "
  237. "again, to save up resources on both server and clients. Read more on this"
  238. " feature [here](https://jitsi.org/blog/new-off-stage-layer-suppression-"
  239. "feature/)"
  240. msgstr ""
  241. #: ../../../docs/configuring-playbook-jitsi.md:149
  242. msgid ""
  243. "You may wish to **disable audio levels** to avoid excessive refresh of "
  244. "the client-side page and decrease the CPU consumption involved."
  245. msgstr ""
  246. #: ../../../docs/configuring-playbook-jitsi.md:151
  247. msgid ""
  248. "You may want to **limit the number of video feeds forwarded to each "
  249. "client**, to save up resources on both server and clients. As clients’ "
  250. "bandwidth and CPU may not bear the load, use this setting to avoid lag "
  251. "and crashes. This feature is found by default in other webconference "
  252. "applications such as Office 365 Teams (limit is set to 4). Read how it "
  253. "works [here](https://github.com/jitsi/jitsi-"
  254. "videobridge/blob/master/doc/last-n.md) and performance evaluation on this"
  255. " [study](https://jitsi.org/wp-"
  256. "content/uploads/2016/12/nossdav2015lastn.pdf)."
  257. msgstr ""
  258. #: ../../../docs/configuring-playbook-jitsi.md:153
  259. msgid ""
  260. "You may want to **limit the maximum video resolution**, to save up "
  261. "resources on both server and clients."
  262. msgstr ""
  263. #: ../../../docs/configuring-playbook-jitsi.md:155
  264. msgid "(Optional) Specify a Max number of participants on a Jitsi conference"
  265. msgstr ""
  266. #: ../../../docs/configuring-playbook-jitsi.md:157
  267. msgid ""
  268. "The playbook allows a user to set a max number of participants allowed to"
  269. " join a Jitsi conference. By default there is no limit."
  270. msgstr ""
  271. #: ../../../docs/configuring-playbook-jitsi.md:159
  272. msgid ""
  273. "In order to set the max number of participants use the following "
  274. "**additional** configuration:"
  275. msgstr ""
  276. #: ../../../docs/configuring-playbook-jitsi.md:165
  277. msgid "(Optional) Additional JVBs"
  278. msgstr ""
  279. #: ../../../docs/configuring-playbook-jitsi.md:167
  280. msgid ""
  281. "By default, a single JVB ([Jitsi VideoBridge](https://github.com/jitsi"
  282. "/jitsi-videobridge)) is deployed on the same host as the Matrix server. "
  283. "To allow more video-conferences to happen at the same time, you may need "
  284. "to provision additional JVB services on other hosts."
  285. msgstr ""
  286. #: ../../../docs/configuring-playbook-jitsi.md:169
  287. msgid ""
  288. "There is an ansible playbook that can be run with the following tag: "
  289. "`ansible-playbook -i inventory/hosts --limit jitsi_jvb_servers "
  290. "jitsi_jvb.yml --tags=common,setup-additional-jitsi-jvb,start`"
  291. msgstr ""
  292. #: ../../../docs/configuring-playbook-jitsi.md:171
  293. msgid ""
  294. "For this role to work you will need an additional section in the ansible "
  295. "hosts file with the details of the JVB hosts, for example:"
  296. msgstr ""
  297. #: ../../../docs/configuring-playbook-jitsi.md:178
  298. msgid ""
  299. "Each JVB will require a server ID to be set so that it can be uniquely "
  300. "identified and this allows Jitsi to keep track of which conferences are "
  301. "on which JVB. The server ID is set with the variable "
  302. "`jitsi_jvb_server_id` which ends up as the JVB_WS_SERVER_ID environment "
  303. "variables in the JVB docker container. This variable can be set via the "
  304. "host file, a parameter to the ansible command or in the `vars.yaml` for "
  305. "the host which will have the additional JVB. For example:"
  306. msgstr ""
  307. #: ../../../docs/configuring-playbook-jitsi.md:190
  308. msgid ""
  309. "Note that the server ID `jvb-1` is reserved for the JVB instance running "
  310. "on the Matrix host and therefore should not be used as the ID of an "
  311. "additional jvb host."
  312. msgstr ""
  313. #: ../../../docs/configuring-playbook-jitsi.md:192
  314. msgid ""
  315. "The additional JVB will also need to expose the colibri web socket port "
  316. "and this can be done with the following variable:"
  317. msgstr ""
  318. #: ../../../docs/configuring-playbook-jitsi.md:198
  319. msgid ""
  320. "The JVB will also need to know where the prosody xmpp server is located, "
  321. "similar to the server ID this can be set in the vars for the JVB by using"
  322. " the variable `jitsi_xmpp_server`. The Jitsi prosody container is "
  323. "deployed on the Matrix server by default so the value can be set to the "
  324. "Matrix domain. For example:"
  325. msgstr ""
  326. #: ../../../docs/configuring-playbook-jitsi.md:204
  327. msgid ""
  328. "However, it can also be set the ip address of the Matrix server. This can"
  329. " be useful if you wish to use a private ip. For example:"
  330. msgstr ""
  331. #: ../../../docs/configuring-playbook-jitsi.md:210
  332. msgid ""
  333. "For the JVB to be able to contact the XMPP server, the latter must expose"
  334. " the XMPP port (5222). By default, the Matrix server does not expose the "
  335. "port; only the XMPP container exposes it internally inside the host, "
  336. "which means that the first JVB (which runs on the Matrix server) can "
  337. "reach it but the additional JVB cannot. The port is exposed by setting "
  338. "`jitsi_prosody_container_jvb_host_bind_port` like this:"
  339. msgstr ""
  340. #: ../../../docs/configuring-playbook-jitsi.md:216
  341. msgid "(The default is empty; if it's set then docker forwards the port.)"
  342. msgstr ""
  343. #: ../../../docs/configuring-playbook-jitsi.md:218
  344. msgid ""
  345. "Applied together this will allow you to provision extra JVB instances "
  346. "which will register themselves with the prosody service and be available "
  347. "for jicofo to route conferences too."
  348. msgstr ""
  349. #: ../../../docs/configuring-playbook-jitsi.md:220
  350. msgid ""
  351. "To make Traefik reverse-proxy to these additional JVBs (living on other "
  352. "hosts), **you would need to add the following Traefik configuration "
  353. "extension**:"
  354. msgstr ""
  355. #: ../../../docs/configuring-playbook-jitsi.md:256
  356. msgid "(Optional) Enable Gravatar"
  357. msgstr ""
  358. #: ../../../docs/configuring-playbook-jitsi.md:258
  359. msgid ""
  360. "In the default Jisti Meet configuration, gravatar.com is enabled as an "
  361. "avatar service. This results in third party request leaking data to "
  362. "gravatar. Since Element clients already send the url of configured Matrix"
  363. " avatars to Jitsi, we disabled gravatar."
  364. msgstr ""
  365. #: ../../../docs/configuring-playbook-jitsi.md:260
  366. msgid "To enable Gravatar set:"
  367. msgstr ""
  368. #: ../../../docs/configuring-playbook-jitsi.md:266
  369. msgid ""
  370. "**Beware**: This leaks information to a third party, namely the Gravatar-"
  371. "Service (unless configured otherwise: gravatar.com). Besides metadata, "
  372. "this includes the Matrix user_id and possibly the room identifier (via "
  373. "`referrer` header)."
  374. msgstr ""
  375. #: ../../../docs/configuring-playbook-jitsi.md:268
  376. msgid "Installing"
  377. msgstr ""
  378. #: ../../../docs/configuring-playbook-jitsi.md:270
  379. msgid ""
  380. "After configuring the playbook and potentially [adjusting your DNS "
  381. "records](#adjusting-dns-records), run the playbook with [playbook tags"
  382. "](playbook-tags.md) as below:"
  383. msgstr ""
  384. #: ../../../docs/configuring-playbook-jitsi.md:277
  385. msgid ""
  386. "The shortcut commands with the [`just` program](just.md) are also "
  387. "available: `just install-all` or `just setup-all`"
  388. msgstr ""
  389. #: ../../../docs/configuring-playbook-jitsi.md:279
  390. msgid ""
  391. "`just install-all` is useful for maintaining your setup quickly ([2x-5x "
  392. "faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-"
  393. "runtime) than `just setup-all`) when its components remain unchanged. If "
  394. "you adjust your `vars.yml` to remove other components, you'd need to run "
  395. "`just setup-all`, or these components will still remain installed. Note "
  396. "these shortcuts run the `ensure-matrix-users-created` tag too."
  397. msgstr ""
  398. #: ../../../docs/configuring-playbook-jitsi.md:281
  399. msgid "Usage"
  400. msgstr ""
  401. #: ../../../docs/configuring-playbook-jitsi.md:283
  402. msgid "You can use the self-hosted Jitsi server in multiple ways:"
  403. msgstr ""
  404. #: ../../../docs/configuring-playbook-jitsi.md:285
  405. msgid ""
  406. "**by adding a widget to a room via Element Web** (the one configured by "
  407. "the playbook at `https://element.example.com`). Just start a voice or a "
  408. "video call in a room containing more than 2 members and that would create"
  409. " a Jitsi widget which utilizes your self-hosted Jitsi server."
  410. msgstr ""
  411. #: ../../../docs/configuring-playbook-jitsi.md:287
  412. msgid ""
  413. "**by adding a widget to a room via the Dimension integration manager**. "
  414. "You'll have to point the widget to your own Jitsi server manually. See "
  415. "our [Dimension integration manager](./configuring-playbook-dimension.md) "
  416. "documentation page for more details. Naturally, Dimension would need to "
  417. "be installed first (the playbook doesn't install it by default)."
  418. msgstr ""
  419. #: ../../../docs/configuring-playbook-jitsi.md:289
  420. msgid ""
  421. "**directly (without any Matrix integration)**. Just go to "
  422. "`https://jitsi.example.com`"
  423. msgstr ""
  424. #: ../../../docs/configuring-playbook-jitsi.md:291
  425. msgid ""
  426. "**Note**: Element apps on mobile devices currently [don't support joining"
  427. " meetings on a self-hosted Jitsi server](https://github.com/element-hq"
  428. "/riot-web/blob/601816862f7d84ac47547891bd53effa73d32957/docs/jitsi.md"
  429. "#mobile-app-support)."
  430. msgstr ""
  431. #: ../../../docs/configuring-playbook-jitsi.md:293
  432. msgid "Troubleshooting"
  433. msgstr ""
  434. #: ../../../docs/configuring-playbook-jitsi.md:295
  435. msgid "Rebuilding your Jitsi installation"
  436. msgstr ""
  437. #: ../../../docs/configuring-playbook-jitsi.md:297
  438. msgid ""
  439. "**If you ever run into any trouble** or **if you change configuration "
  440. "(`jitsi_*` variables) too much**, we urge you to rebuild your Jitsi "
  441. "setup."
  442. msgstr ""
  443. #: ../../../docs/configuring-playbook-jitsi.md:299
  444. msgid ""
  445. "We normally don't require such manual intervention for other services, "
  446. "but Jitsi services generate a lot of configuration files on their own."
  447. msgstr ""
  448. #: ../../../docs/configuring-playbook-jitsi.md:301
  449. msgid ""
  450. "These files are not all managed by Ansible (at least not yet), so you may"
  451. " sometimes need to delete them all and start fresh."
  452. msgstr ""
  453. #: ../../../docs/configuring-playbook-jitsi.md:303
  454. msgid "To rebuild your Jitsi configuration:"
  455. msgstr ""
  456. #: ../../../docs/configuring-playbook-jitsi.md:305
  457. msgid ""
  458. "ask Ansible to stop all Jitsi services: `just run-tags stop-group "
  459. "--extra-vars=group=jitsi`"
  460. msgstr ""
  461. #: ../../../docs/configuring-playbook-jitsi.md:306
  462. msgid ""
  463. "SSH into the server and do this and remove all Jitsi configuration & data"
  464. " (`rm -rf /matrix/jitsi`)"
  465. msgstr ""
  466. #: ../../../docs/configuring-playbook-jitsi.md:307
  467. msgid ""
  468. "ask Ansible to set up Jitsi anew and restart services (`just install-"
  469. "service jitsi`)"
  470. msgstr ""