Asteriskのソースを表示

[[Category:電話]]
[[Category:Voice over IP]]
[[en:Asterisk]]
[http://www.asterisk.org Asterisk] は完全な PBX (電話交換機) ソフトウェアです。Linux, BSD, Windows, macOS などで動作し、PBX が通常備えている機能は全て含まれています。Asterisk は4つのプロトコルによる VoIP ができ、比較的安価なハードウェアでほぼ全ての規格の電話装置と一緒に使うことが可能です。

Asterisk はボイスメールサービス、電話帳、電話会議、自動音声応答、コールキューイングを実現します。また、三者通話、発信者番号通知サービス、ADSI、IAX、SIP、H.323 (クライアントとゲートウェイの両方)、MGCP (コールマネージャのみ)、SCCP/Skinny をサポートしています。

この記事では家庭ネットワークにおけるシンプルな設定を説明し、SIP [[アプリケーション一覧/インターネット#VoIP / ソフトフォン|ソフトフォン]]を使って LAN 上の他の SIP ソフトフォンと会話できるようにします。

==インストール==

{{AUR|asterisk}} パッケージをインストールしてください。Cisco の IP 電話を使用する場合はパッチが適用されている {{AUR|asterisk-cisco}} パッケージを使うことが推奨されます ([https://issues.asterisk.org/jira/browse/ASTERISK-13145 https://issues.asterisk.org/jira/browse/ASTERISK-13145] を参照)。

インストールしたら {{ic|asterisk.service}} でサーバーを[[起動]]してください。

SIP [[アプリケーション一覧/インターネット#VoIP / ソフトフォン|ソフトフォン]]と最低2つのマシンが必要です。SIP フォンとしては [http://www.linphone.org/ linphone] ({{AUR|linphone-desktop-all}}) や [http://www.counterpath.com/x-lite/ X-Lite] ({{AUR|xlite-bin}}{{Broken package link|パッケージが存在しません}}) が推奨されます。

ilbc コーデックのサポートを有効にするには PKGBUILD の {{ic|build}} セクションの冒頭に以下を追加してください:
{{bc|<nowiki>
cd ${srcdir}/${pkgname}-${pkgver}/contrib/scripts
echo | ./get_ilbc_source.sh
</nowiki>}}

==設定==
===SIP===
asterisk サーバーを動かしたら、後は2つのファイルを編集すれば設定できます: {{ic|sip.conf}} と {{ic|extensions.conf}}。asterisk の設定ディレクトリ ({{ic|/etc/asterisk}}) に移動して、{{ic|sip.conf}} を編集して以下を記述してください:
{{bc|1=
[me1]
type=friend
username=me1
secret=PASSWORD
host=dynamic
context=house

[me2]
type=friend
username=me2
secret=PASSWORD
host=dynamic
context=house
}}

これで {{Ic|house}} コンテキストに二人の SIP ユーザー {{Ic|me1}} と {{Ic|me2}} が作成されます。パスワードは {{Ic|PASSWORD}} です。

次にコンテキストを定義します。{{ic|extensions.conf}} を以下のように編集:
{{bc|1=
[house]
exten => 100,1,Dial(SIP/me1)

exten => 101,1,Dial(SIP/me2)
}}

これでコンテキスト {{Ic|house}} が作成され SIP ユーザー {{Ic|me1}} にエクステンション 100 が、SIP ユーザー {{Ic|me2}} にエクステンション 101 が割り当てられます。後は実際に動作するか確認するだけです。
===保留音===
保留音はとても楽しい機能です。簡単に設定することができます。{{ic|/etc/asterisk/musiconhold.conf}} を編集して以下を追加してください:
{{bc|1=
[default]
mode=files
directory=mohmp3
}}

後はお気に入りの MP3 を {{ic|/var/lib/asterisk/mohmp3}} にコピーしてください。

===ボイスメール===
Asterisk にはボイスメール機能が存在します。設定する方法は多数ありますが、この記事ではシンプルな設定方法だけを紹介します。

{{ic|voicemail.conf}} を作成・編集:
{{bc|<nowiki>
[general]
format=gsm|wav49|wav
serveremail=asterisk
attach=no
mailcmd=/usr/sbin/sendmail -t
maxmessage=180
maxgreet=60

[default]
100 => 1234,Me,me@mydomain.com
</nowiki>}}

[general] の設定の内容は [http://voip-info.jp/index.php/Asterisk_%E3%82%B5%E3%83%B3%E3%83%97%E3%83%AB%E8%A8%AD%E5%AE%9A%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB_voicemail.conf こちら] を見て下さい。[[Postfix]] が正しくセットアップされていれば PBX からメールの通知がユーザーに送信され、{{Ic|1=attach=yes}} と定義されている場合、メールに音声ファイルが添付されます。

次にメールボックスの設定です。フォーマットは:
 mailbox => password,user,email
上記の場合、'Me' というユーザー名でメールアドレスが me@mydomain.com、パスワードが 1234 のメールボックス 100 が設定されます。

それから、ボイスメールボックスにメッセージを残す方法と、記録されたメッセージにアクセスする手段を用意する必要があります。

{{ic|extensions.conf}} に戻り、既存のエントリを次のように変更します:
 exten => 100,1,Dial(SIP/me1,20)
 exten => 100,2,Voicemail(100@default)
最初の 'exten' は 'Dial()' で20秒間電話を呼び出します。応答がない場合、default コンテキストの 100 番のボイスメールボックスに転送します。

さらに以下のように設定することで実際にボイスメールにアクセスすることができます:
 exten => 600,1,VoiceMailMain,s100@default

600 番を呼び出すと、'VoiceMailMain' アプリケーションは default コンテキストの 100 番に行きます。{{Ic|s}} で自動ログインが許可されます。

{{Note|The 'VoiceMail' applications have a significant amount of options, so it is suggested reading over some additional documentation. This is just for a basic, home use setup.  Also note that it is generally a good idea to use extensions higher then your users extensions for accessing 'VoiceMail'. This way someone dialing 208 does not hit someone's voice-mail at 205.}}

===PSTN に接続===
ここまで設定できたら、次は外線と繋ぎましょう。[https://www.onsip.com/ OnSIP] などのプロバイダが必要です。asterisk に接続する手順がプロバイダによって用意されているかもしれないため、このセクションは共通のことだけ記述します。

====一般的なセットアップ====
=====sip.conf=====
{{bc|1=
[general]
register => username:password@sip.specific.com

[whatever]                   
fromdomain=specific.com     
host=sip.specific.com
insecure=very    ; check with provider
username=usernameduh
secret=passwordduh
type=peer
}}

=====extensions.conf=====
{{bc|1=
[outboundwithCID]  ; this can be whatever
exten => _1NXXNXXXXXX,1,SetCIDNum(15555551234)
exten => _1NXXNXXXXXX,2,Dial(SIP/${EXTEN}@whatever)
exten => _1NXXNXXXXXX,3,Congestion()
exten => _1NXXNXXXXXX,103,Busy()

[default]  ; This should be set in your sip.conf for incoming calls

;These should to be changed to your actual number
; ie     15555555555
exten => 1NXXNXXXXXX,1,Answer()
exten => 1NXXNXXXXXX,2,Playback(ttt-weasels)
exten => 1NXXNXXXXXX,3,HangUp()
}}

*outbound コンテキストでは、ダイアルした番号を全てサービスプロバイダに送信します。2 の 'whatever' は {{ic|sip.conf}} の設定と一致させる必要があります。
*Of course, the inbound dial-plan can be modified to do what you want. For instance, you can have {{Ic|Dial(SIP/me1)}} so when someone calls your number they are routed to your SIP phone on your computer. Then add in voice-mail and so on.

=====iax.conf=====
The first step is to log into FWD and enable their side of IAX. It is under extra features, and keep in mind that the authors claim it takes a little while to activate. 

そして {{ic|iax.conf}} の 'general' セクションを以下のように編集:
{{bc|1=
register => FWDNUMBER:PASSWORD@iax2.fwdnet.net 
disallow = all
allow = ulaw
}}

そして末尾に以下を追加:
{{bc|1=
[iaxfwd]
type=user
context=fromiaxfwd
auth=rsa
inkeys=freeworlddialup
}}

This allows calls from FWD.

=====extensions.conf=====
'[globals]' の一番上に以下を記述:
{{bc|1=
FWDNUMBER=MYFWDNUMBER ; your calling number
FWDCIDNAME="MyName"; your caller id
FWDPASSWORD=MYFWDPASSWORD ; your password
FWDRINGS=sip/office ; the phone to ring
FWDVMBOX=1000 ; the VM box for this user
}}

Next, add this to a context for outgoing:
{{bc|1=
exten => _393.,1,SetCallerId,${FWDCIDNAME}
exten => _393.,2,Dial(IAX2/${FWDNUMBER}:${FWDPASSWORD}@iax2.fwdnet.net/${EXTEN:3},60,r)
exten => _393.,3,Congestion
}}

You can change the '393' to whatever you want. This is what you will dial before dialing a 'fwd' number. For instance, to dial '744561' you would dial '393744561'.

And lastly, the incoming calls:
{{bc|1=
[fromiaxfwd]
exten => ${FWDNUMBER},1,Dial(${FWDRINGS},20,r)
exten => ${FWDNUMBER},2,Voicemail,u${FWDVMBOX}
exten => ${FWDNUMBER},102,Voicemail,b${FWDVMBOX}
}}

{{Note|If you have problems try removing the variables from {{ic|extensions.conf}}. These instructions are from FWD's site and I have not been tested by this article's author.}}

Extensions to try calling are 55555 (a volunteer maned test line) and 514 (conference).
===音声===
音声は {{ic|/var/lib/asterisk/xx}} フォルダに保存します。{{ic|xx}} は言語コードです。例えば英語なら "en" になります。新しい音声を追加したいときはこのフォルダにコピーしてください。以下のフォルダ構造を守って下さい:
{{bc|
/var/lib/asterisk/sounds/xx
/var/lib/asterisk/sounds/xx/digits
/var/lib/asterisk/sounds/xx/letters
/var/lib/asterisk/sounds/xx/phonetic
}}

{{ic|sip.conf}} の language パラメータを編集してください:
{{bc|1=
[general]
...
language=en
...
}}
音声が入手できる場所:
* http://downloads.asterisk.org/pub/telephony/sounds/ 
* https://packages.debian.org/wheezy/all/asterisk-prompt-xx
** [https://packages.debian.org/wheezy/all/asterisk-prompt-fr fr]
** [https://packages.debian.org/wheezy/all/asterisk-prompt-de de]
** ...
* [http://www.voip-info.org/wiki/view/Asterisk+sound+files+international voip-info.org]
===MeetMe===
MeetMe は電話会議をできるようにするアプリケーションです。設定は簡単です。

{{ic|meetme.conf}} を編集:
 conf => 1000
{{ic|extensions.conf}} を編集:
 exten => 999,1,MeetMe(1000|M)
999 にダイアルすることで会議 1000 に入ることができます。{{Ic|<nowiki>|M</nowiki>}} を設定することで誰もいないときは保留音が鳴ります。誰かが会議に参加すると保留音は自動的に消えます。

{{Note|MeetMe を使うには zaptel パッケージが必要です。asterisk を起動する前にインストールして {{Ic|modprobe ztdummy}} を実行してください。それによって TDM が利用できるようになります。}}

==Asterisk コンソールとソフトフォン==
Asterisk を立ち上げてください:
 # asterisk -vvvvvvc

詳細な出力がされる Asterisk CLI が立ち上がります。

Asterisk が既に起動している場合、以下のコマンドを実行:
 # asterisk -r

SIP クライアントを起動して {{ic|sip.conf}} の情報にあわせて設定してください。Asterisk CLI に戻って以下のように表示されることを確認:
 Registered SIP 'me1' at 192.168.0.142 port 5061 expires 60

これで {{Ic|me1}} から {{Ic|101}} にダイアルして {{Ic|me2}} と会話できるはずです。

==トラブルシューティング==
404 Not Found エラーが表示される場合は {{ic|extensions.conf}} とダイアルした電話番号を確認してください。