Matrix Docker Ansible eploy
選択できるのは25トピックまでです。 トピックは、先頭が英数字で、英数字とダッシュ('-')を使用した35文字以内のものにしてください。
 
 
 

444 行
15 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-20 09:53+0200\n"
  14. "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
  15. "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
  16. "Language: jp\n"
  17. "Language-Team: jp <LL@li.org>\n"
  18. "MIME-Version: 1.0\n"
  19. "Content-Type: text/plain; charset=utf-8\n"
  20. "Content-Transfer-Encoding: 8bit\n"
  21. "Generated-By: Babel 2.16.0\n"
  22. #: ../../../docs/configuring-playbook-bot-mjolnir.md:1
  23. msgid "Setting up Mjolnir (optional)"
  24. msgstr ""
  25. #: ../../../docs/configuring-playbook-bot-mjolnir.md:3
  26. msgid ""
  27. "The playbook can install and configure the [Mjolnir](https://github.com"
  28. "/matrix-org/mjolnir) moderation bot for you."
  29. msgstr ""
  30. #: ../../../docs/configuring-playbook-bot-mjolnir.md:5
  31. msgid ""
  32. "See the project's [documentation](https://github.com/matrix-"
  33. "org/mjolnir/blob/main/README.md) to learn what it does and why it might "
  34. "be useful to you."
  35. msgstr ""
  36. #: ../../../docs/configuring-playbook-bot-mjolnir.md:7
  37. msgid "Prerequisites"
  38. msgstr ""
  39. #: ../../../docs/configuring-playbook-bot-mjolnir.md:9
  40. msgid "Register the bot account"
  41. msgstr ""
  42. #: ../../../docs/configuring-playbook-bot-mjolnir.md:11
  43. msgid ""
  44. "The playbook does not automatically create users for you. You **need to "
  45. "register the bot user manually** before setting up the bot."
  46. msgstr ""
  47. #: ../../../docs/configuring-playbook-bot-mjolnir.md:13
  48. msgid ""
  49. "Choose a strong password for the bot. You can generate a good password "
  50. "with a command like this: `pwgen -s 64 1`."
  51. msgstr ""
  52. #: ../../../docs/configuring-playbook-bot-mjolnir.md:15
  53. msgid "You can use the playbook to [register a new user](registering-users.md):"
  54. msgstr ""
  55. #: ../../../docs/configuring-playbook-bot-mjolnir.md:21
  56. msgid ""
  57. "If you would like Mjolnir to be able to deactivate users, move aliases, "
  58. "shutdown rooms, etc then it must be a server admin so you need to change "
  59. "`admin=no` to `admin=yes` in the command above."
  60. msgstr ""
  61. #: ../../../docs/configuring-playbook-bot-mjolnir.md:23
  62. msgid "Get an access token"
  63. msgstr ""
  64. #: ../../../docs/configuring-playbook-bot-mjolnir.md:25
  65. msgid ""
  66. "The bot requires an access token to be able to connect to your "
  67. "homeserver. Refer to the documentation on [how to obtain an access token"
  68. "](obtaining-access-tokens.md)."
  69. msgstr ""
  70. #: ../../../docs/configuring-playbook-bot-mjolnir.md:27
  71. msgid "Make sure the account is free from rate limiting"
  72. msgstr ""
  73. #: ../../../docs/configuring-playbook-bot-mjolnir.md:29
  74. msgid ""
  75. "If your homeserver's implementation is Synapse, you will need to prevent "
  76. "it from rate limiting the bot's account. **This is a required step. If "
  77. "you do not configure it, Mjolnir will crash.**"
  78. msgstr ""
  79. #: ../../../docs/configuring-playbook-bot-mjolnir.md:31
  80. msgid ""
  81. "This can be done using Synapse's [Admin APIs](https://element-"
  82. "hq.github.io/synapse/latest/admin_api/user_admin_api.html#override-"
  83. "ratelimiting-for-users). They can be accessed both externally and "
  84. "internally."
  85. msgstr ""
  86. #: ../../../docs/configuring-playbook-bot-mjolnir.md:33
  87. msgid ""
  88. "To expose the APIs publicly, add the following configuration to your "
  89. "`inventory/host_vars/matrix.example.com/vars.yml` file."
  90. msgstr ""
  91. #: ../../../docs/configuring-playbook-bot-mjolnir.md:39
  92. msgid ""
  93. "The APIs can also be accessed via [Synapse "
  94. "Admin](https://github.com/etkecc/synapse-admin), a web UI tool you can "
  95. "use to administrate users, rooms, media, etc. on your Matrix server. The "
  96. "playbook can install and configure Synapse Admin for you. For details "
  97. "about it, see [this page](configuring-playbook-synapse-admin.md)."
  98. msgstr ""
  99. #: ../../../docs/configuring-playbook-bot-mjolnir.md:41
  100. msgid ""
  101. "**Note**: access to the APIs is restricted with a valid access token, so "
  102. "exposing them publicly should not be a real security concern. Still, "
  103. "doing so is not recommended for additional security. See [official "
  104. "Synapse reverse-proxying recommendations](https://element-"
  105. "hq.github.io/synapse/latest/reverse_proxy.html#synapse-administration-"
  106. "endpoints)."
  107. msgstr ""
  108. #: ../../../docs/configuring-playbook-bot-mjolnir.md:43
  109. msgid ""
  110. "To discharge rate limiting, run the following command on systems that "
  111. "ship curl (note that it does not work on outdated Windows 10). Even if "
  112. "the APIs are not exposed to the internet, you should still be able to run"
  113. " the command on the homeserver locally. Before running it, make sure to "
  114. "replace `@bot.mjolnir:example.com` with the MXID of your Mjolnir:"
  115. msgstr ""
  116. #: ../../../docs/configuring-playbook-bot-mjolnir.md:49
  117. msgid ""
  118. "You can obtain an access token for a homeserver admin account in the same"
  119. " way as you can do so for Mjolnir itself. If you have made Mjolnir an "
  120. "admin, you can just use the Mjolnir token."
  121. msgstr ""
  122. #: ../../../docs/configuring-playbook-bot-mjolnir.md:51
  123. msgid "Create a management room"
  124. msgstr ""
  125. #: ../../../docs/configuring-playbook-bot-mjolnir.md:53
  126. msgid ""
  127. "Using your own account, create a new invite only room that you will use "
  128. "to manage the bot. This is the room where you will see the status of the "
  129. "bot and where you will send commands to the bot, such as the command to "
  130. "ban a user from another room. Anyone in this room can control the bot so "
  131. "it is important that you only invite trusted users to this room."
  132. msgstr ""
  133. #: ../../../docs/configuring-playbook-bot-mjolnir.md:55
  134. msgid ""
  135. "If you make the management room encrypted (E2EE), then you MUST enable "
  136. "and use Pantalaimon (see [below](#configuration-with-e2ee-support))."
  137. msgstr ""
  138. #: ../../../docs/configuring-playbook-bot-mjolnir.md:57
  139. msgid ""
  140. "Once you have created the room you need to copy the room ID so you can "
  141. "tell the bot to use that room. In Element Web you can do this by going to"
  142. " the room's settings, clicking Advanced, and then copying the internal "
  143. "room ID. The room ID will look something like `!qporfwt:example.com`."
  144. msgstr ""
  145. #: ../../../docs/configuring-playbook-bot-mjolnir.md:59
  146. msgid ""
  147. "Finally invite the `@bot.mjolnir:example.com` account you created earlier"
  148. " into the room."
  149. msgstr ""
  150. #: ../../../docs/configuring-playbook-bot-mjolnir.md:61
  151. msgid "Adjusting the playbook configuration"
  152. msgstr ""
  153. #: ../../../docs/configuring-playbook-bot-mjolnir.md:63
  154. msgid ""
  155. "Add the following configuration to your "
  156. "`inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to "
  157. "replace `MANAGEMENT_ROOM_ID_HERE`."
  158. msgstr ""
  159. #: ../../../docs/configuring-playbook-bot-mjolnir.md:72
  160. msgid "End-to-End Encryption support"
  161. msgstr ""
  162. #: ../../../docs/configuring-playbook-bot-mjolnir.md:74
  163. msgid ""
  164. "Decide whether you want Mjolnir to be capable of operating in end-to-end "
  165. "encrypted (E2EE) rooms. This includes the management room and the "
  166. "moderated rooms."
  167. msgstr ""
  168. #: ../../../docs/configuring-playbook-bot-mjolnir.md:76
  169. msgid ""
  170. "To support E2EE, Mjolnir needs to [use Pantalaimon](configuring-playbook-"
  171. "pantalaimon.md)."
  172. msgstr ""
  173. #: ../../../docs/configuring-playbook-bot-mjolnir.md:78
  174. msgid "Configuration with E2EE support"
  175. msgstr ""
  176. #: ../../../docs/configuring-playbook-bot-mjolnir.md:80
  177. msgid ""
  178. "When using Pantalaimon, Mjolnir will log in to its bot account itself "
  179. "through Pantalaimon, so configure its username and password."
  180. msgstr ""
  181. #: ../../../docs/configuring-playbook-bot-mjolnir.md:82
  182. msgid ""
  183. "Add the following configuration to your "
  184. "`inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your "
  185. "needs):"
  186. msgstr ""
  187. #: ../../../docs/configuring-playbook-bot-mjolnir.md:96
  188. msgid ""
  189. "The playbook's `group_vars` will configure other required settings. If "
  190. "using this role separately without the playbook, you also need to "
  191. "configure the two URLs that Mjolnir uses to reach the homeserver, one "
  192. "through Pantalaimon and one \"raw\". This example is taken from the "
  193. "playbook's `group_vars`:"
  194. msgstr ""
  195. #: ../../../docs/configuring-playbook-bot-mjolnir.md:108
  196. msgid "Configuration without E2EE support"
  197. msgstr ""
  198. #: ../../../docs/configuring-playbook-bot-mjolnir.md:110
  199. msgid ""
  200. "When NOT using Pantalaimon, Mjolnir does not log in by itself and you "
  201. "must give it an access token for its bot account."
  202. msgstr ""
  203. #: ../../../docs/configuring-playbook-bot-mjolnir.md:112
  204. msgid ""
  205. "Add the following configuration to your "
  206. "`inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to "
  207. "replace `ACCESS_TOKEN_HERE` with the one created [above](#get-an-access-"
  208. "token)."
  209. msgstr ""
  210. #: ../../../docs/configuring-playbook-bot-mjolnir.md:118
  211. msgid "Adding Mjolnir synapse antispam module (optional)"
  212. msgstr ""
  213. #: ../../../docs/configuring-playbook-bot-mjolnir.md:120
  214. msgid ""
  215. "To enable Mjolnir synapse antispam module, add the following "
  216. "configuration to your `inventory/host_vars/matrix.example.com/vars.yml` "
  217. "file (adapt to your needs):"
  218. msgstr ""
  219. #: ../../../docs/configuring-playbook-bot-mjolnir.md:130
  220. msgid "Extending the configuration"
  221. msgstr ""
  222. #: ../../../docs/configuring-playbook-bot-mjolnir.md:132
  223. msgid ""
  224. "You can configure additional options by adding the "
  225. "`matrix_bot_mjolnir_configuration_extension_yaml` variable to your "
  226. "`inventory/host_vars/matrix.example.com/vars.yml` file."
  227. msgstr ""
  228. #: ../../../docs/configuring-playbook-bot-mjolnir.md:134
  229. msgid ""
  230. "For example, to change Mjolnir's `recordIgnoredInvites` option to `true`,"
  231. " add the following configuration to your "
  232. "`inventory/host_vars/matrix.example.com/vars.yml` file:"
  233. msgstr ""
  234. #: ../../../docs/configuring-playbook-bot-mjolnir.md:148
  235. msgid "Installing"
  236. msgstr ""
  237. #: ../../../docs/configuring-playbook-bot-mjolnir.md:150
  238. msgid ""
  239. "After configuring the playbook, run it with [playbook tags](playbook-"
  240. "tags.md) as below:"
  241. msgstr ""
  242. #: ../../../docs/configuring-playbook-bot-mjolnir.md:157
  243. msgid "**Notes**:"
  244. msgstr ""
  245. #: ../../../docs/configuring-playbook-bot-mjolnir.md:159
  246. msgid ""
  247. "The `ensure-matrix-users-created` playbook tag makes the playbook "
  248. "automatically create the bot's user account."
  249. msgstr ""
  250. #: ../../../docs/configuring-playbook-bot-mjolnir.md:161
  251. msgid ""
  252. "The shortcut commands with the [`just` program](just.md) are also "
  253. "available: `just install-all` or `just setup-all`"
  254. msgstr ""
  255. #: ../../../docs/configuring-playbook-bot-mjolnir.md:163
  256. msgid ""
  257. "`just install-all` is useful for maintaining your setup quickly ([2x-5x "
  258. "faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-"
  259. "runtime) than `just setup-all`) when its components remain unchanged. If "
  260. "you adjust your `vars.yml` to remove other components, you'd need to run "
  261. "`just setup-all`, or these components will still remain installed."
  262. msgstr ""
  263. #: ../../../docs/configuring-playbook-bot-mjolnir.md:165
  264. msgid ""
  265. "If you change the Pantalaimon's password "
  266. "(`matrix_bot_mjolnir_pantalaimon_password` in your `vars.yml` file) "
  267. "subsequently, its credentials on the homeserver won't be updated "
  268. "automatically. If you'd like to change the password, use a tool like "
  269. "[synapse-admin](configuring-playbook-synapse-admin.md) to change it, and "
  270. "then update `matrix_bot_mjolnir_pantalaimon_password` to let Pantalaimon "
  271. "know its new password."
  272. msgstr ""
  273. #: ../../../docs/configuring-playbook-bot-mjolnir.md:167
  274. msgid "Usage"
  275. msgstr ""
  276. #: ../../../docs/configuring-playbook-bot-mjolnir.md:169
  277. msgid ""
  278. "You can refer to the upstream [documentation](https://github.com/matrix-"
  279. "org/mjolnir) for additional ways to use and configure Mjolnir. Check out "
  280. "their [quickstart guide](https://github.com/matrix-org/mjolnir"
  281. "#quickstart-guide) for some basic commands you can give to the bot."
  282. msgstr ""
  283. #~ msgid ""
  284. #~ "See the project's [documentation](https://github.com"
  285. #~ "/matrix-org/mjolnir) to learn what it "
  286. #~ "does and why it might be useful"
  287. #~ " to you."
  288. #~ msgstr ""
  289. #~ msgid ""
  290. #~ "The playbook does not automatically "
  291. #~ "create users for you. The bot "
  292. #~ "requires an access token to be "
  293. #~ "able to connect to your homeserver."
  294. #~ msgstr ""
  295. #~ msgid ""
  296. #~ "You **need to register the bot "
  297. #~ "user manually** before setting up the"
  298. #~ " bot."
  299. #~ msgstr ""
  300. #~ msgid ""
  301. #~ "Refer to the documentation on [how "
  302. #~ "to obtain an access token](obtaining-"
  303. #~ "access-tokens.md)."
  304. #~ msgstr ""
  305. #~ msgid ""
  306. #~ "You will need to prevent Synapse "
  307. #~ "from rate limiting the bot's account."
  308. #~ " This is not an optional step. "
  309. #~ "If you do not do this step "
  310. #~ "Mjolnir will crash. This can be "
  311. #~ "done using Synapse's [admin API](https"
  312. #~ "://matrix-"
  313. #~ "org.github.io/synapse/latest/admin_api/user_admin_api.html"
  314. #~ "#override-ratelimiting-for-users). Please "
  315. #~ "ask for help if you are "
  316. #~ "uncomfortable with these steps or run"
  317. #~ " into issues."
  318. #~ msgstr ""
  319. #~ msgid ""
  320. #~ "If your Synapse Admin API is "
  321. #~ "exposed to the internet for some "
  322. #~ "reason like running the Synapse Admin"
  323. #~ " Role [Link](configuring-playbook-synapse-"
  324. #~ "admin.md) or running "
  325. #~ "`matrix_synapse_container_labels_public_client_synapse_admin_api_enabled:"
  326. #~ " true` in your playbook config. If"
  327. #~ " your API is not externally exposed"
  328. #~ " you should still be able to on"
  329. #~ " the local host for your synapse "
  330. #~ "run these commands."
  331. #~ msgstr ""
  332. #~ msgid ""
  333. #~ "The following command works on semi "
  334. #~ "up to date Windows 10 installs and"
  335. #~ " All Windows 11 installations and "
  336. #~ "other systems that ship curl. `curl "
  337. #~ "--header \"Authorization: Bearer <access_token>\""
  338. #~ " -X POST "
  339. #~ "https://matrix.example.com/_synapse/admin/v1/users/@bot.mjolnir:example.com/override_ratelimit`"
  340. #~ " Replace `@bot.mjolnir:example.com` with the "
  341. #~ "MXID of your Mjolnir and example.com "
  342. #~ "with your homeserver domain. You can "
  343. #~ "easily obtain an access token for "
  344. #~ "a homeserver admin account the same "
  345. #~ "way you can obtain an access token"
  346. #~ " for Mjolnir itself. If you made "
  347. #~ "Mjolnir Admin you can just use the"
  348. #~ " Mjolnir token."
  349. #~ msgstr ""
  350. #~ msgid ""
  351. #~ "If you make the management room "
  352. #~ "encrypted (E2EE), then you MUST enable"
  353. #~ " and use Pantalaimon (see below)."
  354. #~ msgstr ""
  355. #~ msgid ""
  356. #~ "Decide whether you want Mjolnir to "
  357. #~ "be capable of operating in end-"
  358. #~ "to-end encrypted (E2EE) rooms. This "
  359. #~ "includes the management room and the "
  360. #~ "moderated rooms. To support E2EE, "
  361. #~ "Mjolnir needs to [use Pantalaimon"
  362. #~ "](configuring-playbook-pantalaimon.md)."
  363. #~ msgstr ""
  364. #~ msgid "a. Configuration with E2EE support"
  365. #~ msgstr ""
  366. #~ msgid "b. Configuration without E2EE support"
  367. #~ msgstr ""
  368. #~ msgid ""
  369. #~ "You must replace "
  370. #~ "`ACCESS_TOKEN_FROM_STEP_2_GOES_HERE` and "
  371. #~ "`ROOM_ID_FROM_STEP_4_GOES_HERE` with your own "
  372. #~ "values."
  373. #~ msgstr ""
  374. #~ msgid ""
  375. #~ "For example to change Mjolnir's "
  376. #~ "`recordIgnoredInvites` option to `true` you"
  377. #~ " would add the following to your "
  378. #~ "`vars.yml` file."
  379. #~ msgstr ""