Prosodyのソースを表示

[[Category:インターネットアプリケーション]]
[[de:Prosody]]
[[en:Prosody]]
[http://prosody.im/ Prosody] (発音: [http://www.merriam-webster.com/cgi-bin/audio.pl?prosod05.wav=prosody%27 1], [http://www.merriam-webster.com/cgi-bin/audio.pl?prosod04.wav=prosody%27 2]) は [http://www.lua.org/ Lua] プログラミング言語で書かれた [http://xmpp.org/ XMPP] サーバーです。Prosody は軽量で簡単に拡張できるように設計されています。制限の緩い [http://prosody.im/source/mit MIT ライセンス] でライセンスされています。Prosody は Arch Linux の Community リポジトリからインストールすることができ、[[Arch User Repository]] には複数の任意の依存パッケージがあります。

このガイドを読むときは、AUR のパッケージのビルド・インストール方法と XMPP の基礎知識を知っておくと役に立ちます。

==インストール==

公式リポジトリから {{Pkg|prosody}} を[[インストール]]してください。

===任意の依存パッケージ===
Prosody を実行するのに必ずしも必要ではないが、便利な機能を提供する依存パッケージです。これらの依存パッケージの中には AUR からビルド・インストールする必要があるものも含まれています。AUR のパッケージのインストール・ビルドの方法を知らない場合は [[AUR#パッケージのインストール]] を見て下さい。

; TLS/SSL サポート (推奨)
: 盗聴されないように Prosody でストリームを暗号化できるようになります。<br>''必要パッケージ:'' {{Pkg|lua51-sec}} (Community)

; MySQL バックエンド
: mariadb などの MySQL バックエンドを Prosody で使えるようになり拡張性やパフォーマンスが上がります。<br>''必要パッケージ:'' {{Pkg|lua-sql-mysql}} (Community)

; 接続スケーリングの向上 (推奨)
: [http://www.monkey.org/~provos/libevent/ libevent] を使うことで大量の同時接続を処理できるようになります。<br>''必要パッケージ:'' {{AUR|lua51-event}} (AUR)

; ストリームの圧縮
: クライアントからサーバーへのストリームを圧縮して対応するクライアントで帯域を節約することができます。<br>''必要パッケージ:'' {{Pkg|lua51-zlib}} (Community)

; Cyrus SASL サポート
: [http://asg.web.cmu.edu/sasl/sasl-library.html Cyrus SASL] ライブラリを使って Prosody で認証ができるようになります。<br>''必要パッケージ:'' {{AUR|lua-cyrussasl}}{{Broken package link|{{aur-mirror|lua-cyrussasl}}}} (AUR)

==設定==

{{Note|The {{Ic|posix}} module and {{Ic|pidfile}} setting contained in the default configuration file are required for Prosody's proper operation on Arch Linux. Please do not disable or alter them.}}

The main configuration file is located at {{ic|/etc/prosody/prosody.cfg.lua}}, information on how to configure Prosody can be found in Prosody's [http://prosody.im/doc/configure documentation]. The syntax of the configuration file can be checked after any changes are made by running: 

{{Ic|$ luac5.1 -p /etc/prosody/prosody.cfg.lua}}

No output means the syntax is correct.

===ログ===
Arch Linux の Prosody は syslog にログを出力するようにあらかじめ設定されています。したがって、デフォルトで、Prosody のログメッセージは [[Systemd#Journal|systemd journal]] で確認できます。

==制御==

You can start Prosody through the included Systemd script:

 # systemctl start prosody

To automatically start Prosody at boot execute:

 # systemctl enable prosody

Prosody uses the default XMPP ports, 5222 and 5269, for client-to-server and server-to-server communications respectively. Configure your firewall as necessary.

You can manipulate Prosody users by using the {{Ic|prosodyctl}} program. To add a user:

 # prosodyctl adduser <JID>

{{Tip|You will likely want to make at least one user an administrator by adding their Jabber ID to the {{Ic|admins}} list in the configuration file.}}

Issue {{Ic|man prosodyctl}} to see the man page for {{Ic|prosodyctl}}.

===セキュリティ===
====ユーザー登録====
Prosody supports XMPP's in-band registration [http://xmpp.org/extensions/xep-0077.html standard], which allows users to register with an XMPP client from within their client and change their passwords. While this is convenient for users it does not allow administrators to moderate the registration of new users. As such, the {{Ic|register}} module is enabled in the default configuration but {{Ic|allow_registration}} is set to {{Ic|false}}. This allows existing users to change their passwords from within their client but does not allow new users to register themselves.

{{Tip|If you do decide to support new in-band registrations, you will likely find the {{Ic|watchregistrations}} and {{Ic|welcome}} modules useful.}}

====ストリームの暗号化====
Prosody can utilize TLS certificates to encrypt client-to-server communications (if the proper [[#Optional Dependencies|dependencies]] are installed). See the relevant sections of {{ic|prosody.cfg.lua}} to configure Prosody to utilize these certificates.

To require encryption for client-to-server communications add the following to your configuration file:
{{hc|/etc/prosody/prosody.cfg.lua|2=
Host "*"

    c2s_require_encryption = true
}}

Similarly, for server-to-server communications you may do:
{{hc|/etc/prosody/prosody.cfg.lua|2=
Host "*"

    s2s_require_encryption = true
}}

While requiring client-to-server encryption is generally a good idea, please keep in mind that some popular XMPP services such as Google Talk/Gmail do not support server-to-server encryption.

===ユーザーの表示===
A simple way to see a list of the registered users is
 # ls -l /var/lib/prosody/*/accounts/*

alternatively, you can download the module [http://prosody.im/files/mod_listusers.lua mod_listusers.lua], and use it as
 # prosodyctl mod_listusers

==削除==

After normally uninstalling Prosody with pacman, the {{ic|/etc/prosody}} and {{ic|/var/lib/prosody}} directories may be left on your filesystem, and you may want to remove them if you do not plan on reinstalling Prosody.

==Tips and tricks==
===コンポーネント===
Prosody supports XMPP components, which provide extra services to clients. Components are either provided internally by special Prosody modules or externally using the protocol specified in [http://xmpp.org/extensions/xep-0114.html XEP-0114].

{{Note|Components must use a different hostname from the {{Ic|VirtualHost}} names defined in {{Ic|prosody.cfg.lua}}. Attempting to host a component on the same hostname as a defined {{Ic|VirtualHost}} '''will''' result in errors.}}

By default, Prosody will listen for external components. If you do not plan to use any external components with Prosody you can disable this behavior by adding the following your configuration:

{{hc|/etc/prosody/prosody.cfg.lua|2=
component_ports = {}
}}

====Multi-User Chat====
A common component used with XMPP servers is Multi-User Chat (MUC), which allows conferences between multiple users. MUC is provided as an internal component with Prosody. To enable MUC add the following to your configuration file:

{{hc|/etc/prosody/prosody.cfg.lua|
Component "conference.example.com" "muc"
}}

This will enable the MUC component on host {{Ic|conference.example.com}}.

===Prosody モジュール===
[http://code.google.com/p/prosody-modules/ Prosody Modules] is a collection of extra modules not distributed with Prosody. These modules are in various states of development from highly experimental to relatively stable. You should consult a given module's wiki page for more information. An example of an extra module is {{Ic|[http://code.google.com/p/prosody-modules/wiki/mod_pastebin pastebin]}}, which when loaded will intercept long messages (for example, log file output) and replace them with a link to a pastebin hosted using Prosody's internal HTTP server (provided by the core module, {{Ic|httpserver}}).

To use an extra module download its raw file(s) from the source browser (when viewing a file, search for the link "View raw file"). Alternatively and likely easier, use Mercurial to clone the entire repository:

{{Ic|$ hg clone <nowiki>https://prosody-modules.googlecode.com/hg/ prosody-modules</nowiki>}}

Now you can copy the module (and any additional files it needs) to Prosody's module directory at {{ic|/usr/lib/prosody/modules}}. To enable the module add it to your {{Ic|modules_enabled}} list in your {{ic|prosody.cfg.lua}} for the host or component you wish to use it for. For example, to use the {{Ic|pastebin}} module on a MUC component:

{{hc|/etc/prosody/prosody.cfg.lua|2=
Component "conference.example.com" "muc"
    modules_enabled = { "pastebin" }
}}

{{Note|An enforced Prosody convention is that modules are named {{Ic|mod_''foo''.lua}} but simply enabled by adding {{Ic|''foo''}} to the {{Ic|modules_enabled}} list.}}

===コンソール===
{{Warning|The console does not require any authentication so any user on a multi-user system can connect and issue commands on the console. Therefore it is '''not''' recommended to enable the {{Ic|console}} module on a multi-user system.}}

The {{Ic|console}} module provides a telnet console from which administrative operations and queries can be performed. You can connect to the console by issuing:

{{Ic|$ telnet localhost 5582}}

You of course need the {{Ic|telnet}} program provided by the {{Ic|inetutils}} package. Use the {{Ic|help}} command in the console to get usage help.

The console even allows you to execute Lua commands directly on the server by preceding a command with {{Ic|>}}. For example to see if a client connection is compressed:

{{Ic|> full_sessions["romeo@montague.lit/Resource"].compressed}}

Will return {{Ic|true}} if the connection is compressed or {{Ic|nil}} if it is not.

==トラブルシューティング==
One of Prosody's primary design principles is to be simple to use and configure. However, issues can still arise (and likely will as is the case with any complex software). If you encounter a problem there are a variety of steps you can take to narrow down the cause:

* '''Check for known issues'''<br>Look at the [http://prosody.im/doc/release release notes] for your Prosody version to see if your issue is listed as a known issue. Also check the [http://code.google.com/p/lxmppd/issues/list issue tracker] to see if your issue has already been reported.
* '''Check configuration syntax'''<br>Run {{Ic|luac5.1 -p /etc/prosody/prosody.cfg.lua}} to check for any syntax errors in your configuration file. If there is no output your syntax is fine.
* '''Check the log'''<br>Errors are only logged if there is a critical problem so always address those issues. If you think you have a very low level issue (like protocol compatibility between clients and servers with Prosody) then you can enable the very verbose debug level logging.
* '''Check permissions'''<br>The Prosody package should add a new {{Ic|prosody}} user and group to your system and set appropriate permissions, but it is always good to double check. Ensure that {{ic|/etc/prosody}} and {{ic|/var/lib/prosody}} are owned by the {{Ic|prosody}} user and that the user has appropriate permissions to read and write to those paths and all contained files.
* '''Check listening ports'''<br>When troubleshooting connection issues make sure that Prosody is actually listening for connections. You may do so by running {{Ic|ss -tul}} and making sure that {{Ic|xmpp-client}} (port 5222) and {{Ic|xmpp-server}} (port 5269) are listed.
* '''Restart'''<br>Like most things, it does not hurt to restart Prosody ({{Ic|systemctl restart prosody}}) to see if it resolves an issue.

If you are unable to resolve your issue yourself there are a variety of resources you can use to seek help. In order of immediacy with which you will likely receive help:

# XMPP Conference: {{Ic|prosody@conference.prosody.im}}
# Mailing List: [http://groups.google.co.uk/group/prosody-users Web Interface], [mailto:prosody-users@googlegroups.com Email]
# [https://bbs.archlinux.org/viewforum.php?id=4 Arch Forums] (for package issues)

==開発==

Two development packages are maintained for Prosody in the AUR, {{AUR|prosody-devel}}{{Broken package link|{{aur-mirror|prosody-devel}}}} and {{AUR|prosody-hg}}. {{Ic|prosody-devel}} tracks the latest source release of a development version (alpha, beta, release candidate) and will actually be behind the stable version if a final version of the development version is released. {{Ic|prosody-hg}} tracks the [http://www.selenic.com/mercurial/wiki/ Mercurial] repository tip for Prosody and will always contain the latest code as it is checked in. Both packages are built similarly to the stable package.

==コミュニティ==
* メーリングリスト: [http://groups.google.co.uk/group/prosody-dev prosody-dev], [http://groups.google.co.uk/group/prosody-users prosody-users]
* カンファレンス: {{Ic|prosody@conference.prosody.im}}
* ブログ: [http://blog.prosody.im/ Prosodical Thoughts]

== 参照 ==

* [http://prosody.im/doc 公式ドキュメント]
* [http://blog.prosody.im/ Prosodical Thoughts] (Blog)
* [http://code.google.com/p/lxmppd/issues/list Issue Tracker]
* [http://prosody.im/source/browse/ Prosody Modules] (Extra Modules)