「Asterisk 24」の版間の差分

提供: VoIP-Info.jp
ナビゲーションに移動 検索に移動
Takahashi (トーク | 投稿記録)
編集の要約なし
Takahashi (トーク | 投稿記録)
編集の要約なし
 
(同じ利用者による、間の8版が非表示)
3行目: 3行目:
[[カテゴリ:pjsip]]
[[カテゴリ:pjsip]]


Asterisk 22.0.0が2026年11月5日(現地時間)リリースされました。<br>
Asterisk 24.0.0が2026年11月5日(現地時間)リリースされました。<br>
:メンテナンス終了は2030年11月5日
:メンテナンス終了は2030年10月15日
:セキュリティフィックス提供終了は2031年11月
:セキュリティフィックス提供終了は2031年10月
==概要==
==概要==
Asterisk 24は最新のAsteriskのメジャーリリースで、Asterisk 22同様にLTS(Long Term Support:通常4年)になります。
Asterisk 24は最新のAsteriskのメジャーリリースで、Asterisk 22同様にLTS(Long Term Support:通常4年)になります。
:https://docs.asterisk.org/About-the-Project/Asterisk-Versions/
:https://docs.asterisk.org/About-the-Project/Asterisk-Versions/
===Asterisk 22からの変更点で重要なもの===
===Asterisk 22からの変更点で重要なもの===
主に安定性・安全性の改善、修正等が主要な変更となっています。
新機能についてはすでにAsterisk 20,22にバックポートされているため目立った機能の追加はありません。<br>
主に安定性・安全性の改善、修正等が主要な変更となっています。<br>
<br>
新しい機能としてはchan_wbesocketがありますが、これはすでにAsterisk 20,22にバックポートされていますので使えます(細かい仕様変更等は調査中)。


==削除されたもの==
==削除されたもの==
===users.conf===
users.confによる設定は削除されました。すべてのチャネルドライバは個別の設定ファイルで構成する必要があります。<br>
===DeadAGI===
Asterisk 15から非推奨だったDeadAGIが完全に削除されました。<br>
===VALID_EXTEN,QUEUE_MEMBER_COUNT===
ファンクションから削除されました。<br>
===Music on Hold (MoH)仕様変更===
古い random オプションと application= の r フラグが削除されました。今後は sort=random を使用します。<br>
===Voicemail 仕様変更===
maxmessage と minmessage が削除され、代わりに maxsecs と minsecs を使用します。<br>
===Logger CLI===
rotatetimestamp が削除され、rotatestrategy に置き換わりました。CLIコマンドの no debug channel も削除されています。<br>


===その他===
===その他===
28行目: 43行目:


==インストール==
==インストール==
===前提となるパッケージ類===  
===前提となるパッケージ類===
GCC、G++(GNU-C++)、OpenSSL、Ncurses、bison、カーネルソース(DAHDIを使う場合)、libxml2、SQLite3、libuuid-devel<br>
dnsutilsは使う人がいるかもなので追加。libsrtp2はブラウザフォン対応用、libunboundはRTX/NVRで直収のため。<br>
Debianで説明します。<br>
apt -y install build-essential libedit-dev uuid-dev libxml2-dev libncurses-dev libsqlite3-dev sqlite3 libssl-dev subversion git net-tools dnsutils libsrtp2-dev libunbound-dev
Asteriskの基本的な部分は上記のパッケージ追加で問題ないと思います。なおJanssonはAsteriskのバンドルでインストールしますので、configure時に指定します。<br>
Asterisk 22と同様の環境でコンパイルできました。<br>
 
===Asteriskソースの入手===
===Asteriskソースの入手===
Asterisk 24のソースは以下からダウンロードできます。なお asterisk-24-current.tar.gz が最新バージョンへのシンボリックリンクとなっていますので、これをダウンロードすれば最新バージョンが入手できます。
http://downloads.asterisk.org/pub/telephony/asterisk/
展開するディレクトリはどこでもかまいませんが、ここでは/usr/src/とします。
# cd /usr/src
# wget http://downloads.asterisk.org/pub/telephony/asterisk/asterisk-24-current.tar.gz
入手したら展開しておきます。展開すると現在のAsteriskのバージョンのディレクトリに展開されます。以降それぞれの作業は、それぞれの展開したサブディレクトリで行います。
# tar zxvf asterisk-24-current.tar.gz
# cd asterisk-24.x.x
===Asteriskのコンパイルとインストール===
===Asteriskのコンパイルとインストール===
基本的にconfigureしてmakeするだけですが、Janssonをバンドルで行うので以下のオプションでconfigureします。。
# ./configure --with-jansson-bundled
<BR>
以前のバージョンからアップグレードを行う場合、変更されたモジュール類が多いので、一旦、以前のモジュールをディレクトリごと名前変更してバックアップしてからインストールしてください。<BR>
mv /usr/lib/asterisk/module /usr/lib/asterisk/module.20.bak
あとはコンパイルとインストールを行うだけです(新規インストールの場合)。
# make
# make install
# make samples
# make config
これで新規インストールは完了します。最後の make config で起動時に自動起動するようになります。<br>
'''アップグレード時の注意''':以前のバージョンからアップグレードする場合、/etc/asterisk の設定ファイル類をバックアップしてから行ってください。make samplesすると /etc/asterisk の内容を上書きしてしまいます。アップグレード時は make installするだけで事足りることが多いです。(make configはシステムのスタートアップファイル類を更新するので大きな変更がない場合には更新の必要はありません。
===日本語音声のインストール===
===日本語音声のインストール===
Asteriskの本体に付随する日本語音声は古いためGoogle TTSで合成した日本語音声(トーキー)を用意してあります(Asterisk 18ベース)。githubに用意してありますのでご利用ください。<br>
Asteriskの本体に付随する日本語音声は古いためGoogle TTSで合成した日本語音声(トーキー)を用意してあります(Asterisk 18ベース)。githubに用意してありますのでご利用ください。<br>
44行目: 88行目:


==ユーザの追加と設定==
==ユーザの追加と設定==
Asteriskをasterisk:asteriskで起動させるために以下のようにグループ/ユーザを追加します。UID,GIDの5060は単なる趣味です。
addgroup --gid 5060 asterisk
adduser --uid 5060 --gid 5060 asterisk --disabled-password
Asteriskの実行ユーザ/グループは /etc/defaults/asterisk を編集します。以下の部分のコメントを外します。
# Uncomment the following and set them to the user/groups that you
# want to run Asterisk as. NOTE: this requires substantial work to
# be sure that Asterisk's environment has permission to write the
# files required  for  its  operation, including logs, its comm
# socket, the asterisk database, etc.
AST_USER="asterisk"    <==ここと
AST_GROUP="asterisk"    <==ここ
ディレクトリ/ファイル類の権限も調整しておきましょう。
chown -R asterisk:asterisk /var/log/asterisk
chown -R asterisk:asterisk /var/lib/asterisk
chown -R asterisk:asterisk /var/spool/asterisk
chown -R asterisk:asterisk /usr/lib/asterisk
chown -R asterisk:asterisk /etc/asterisk
これでsystemctlで起動すればAsteriskが動くはずです。
==サンプル設定ファイルと応用例==
==サンプル設定ファイルと応用例==
Asterisk 20以降用に大幅に書き直しました。<br>
Asterisk 20以降用に大幅に書き直しました。<br>

2026年11月20日 (金) 16:11時点における最新版


Asterisk 24.0.0が2026年11月5日(現地時間)リリースされました。

メンテナンス終了は2030年10月15日
セキュリティフィックス提供終了は2031年10月

概要

Asterisk 24は最新のAsteriskのメジャーリリースで、Asterisk 22同様にLTS(Long Term Support:通常4年)になります。

https://docs.asterisk.org/About-the-Project/Asterisk-Versions/

Asterisk 22からの変更点で重要なもの

新機能についてはすでにAsterisk 20,22にバックポートされているため目立った機能の追加はありません。
主に安定性・安全性の改善、修正等が主要な変更となっています。

新しい機能としてはchan_wbesocketがありますが、これはすでにAsterisk 20,22にバックポートされていますので使えます(細かい仕様変更等は調査中)。

削除されたもの

users.conf

users.confによる設定は削除されました。すべてのチャネルドライバは個別の設定ファイルで構成する必要があります。

DeadAGI

Asterisk 15から非推奨だったDeadAGIが完全に削除されました。

VALID_EXTEN,QUEUE_MEMBER_COUNT

ファンクションから削除されました。

Music on Hold (MoH)仕様変更

古い random オプションと application= の r フラグが削除されました。今後は sort=random を使用します。

Voicemail 仕様変更

maxmessage と minmessage が削除され、代わりに maxsecs と minsecs を使用します。

Logger CLI

rotatetimestamp が削除され、rotatestrategy に置き換わりました。CLIコマンドの no debug channel も削除されています。

その他

細かい変更点等は公式を参照のこと。
https://docs.asterisk.org/Asterisk_24_Documentation/WhatsNew/

注意

  • SIPチャネル要注意
SIPチャネルはAsterisk 22以降でPjSipが標準となりました。chan_sipはソースも配布されず完全に廃止されました。

→ Asterisk pjsip

  • Macro廃止
Asterisk 22以降ではMacroが完全廃止されました。Gosub/Returnへの書き換えが必要です。
extenでMacroを多用している例は多いので24へ移行する場合には対応してください。

インストール

前提となるパッケージ類

GCC、G++(GNU-C++)、OpenSSL、Ncurses、bison、カーネルソース(DAHDIを使う場合)、libxml2、SQLite3、libuuid-devel
dnsutilsは使う人がいるかもなので追加。libsrtp2はブラウザフォン対応用、libunboundはRTX/NVRで直収のため。
Debianで説明します。

apt -y install build-essential libedit-dev uuid-dev libxml2-dev libncurses-dev libsqlite3-dev sqlite3 libssl-dev subversion git net-tools dnsutils libsrtp2-dev libunbound-dev

Asteriskの基本的な部分は上記のパッケージ追加で問題ないと思います。なおJanssonはAsteriskのバンドルでインストールしますので、configure時に指定します。
Asterisk 22と同様の環境でコンパイルできました。

Asteriskソースの入手

Asterisk 24のソースは以下からダウンロードできます。なお asterisk-24-current.tar.gz が最新バージョンへのシンボリックリンクとなっていますので、これをダウンロードすれば最新バージョンが入手できます。

http://downloads.asterisk.org/pub/telephony/asterisk/

展開するディレクトリはどこでもかまいませんが、ここでは/usr/src/とします。

# cd /usr/src
# wget http://downloads.asterisk.org/pub/telephony/asterisk/asterisk-24-current.tar.gz

入手したら展開しておきます。展開すると現在のAsteriskのバージョンのディレクトリに展開されます。以降それぞれの作業は、それぞれの展開したサブディレクトリで行います。

# tar zxvf asterisk-24-current.tar.gz
# cd asterisk-24.x.x

Asteriskのコンパイルとインストール

基本的にconfigureしてmakeするだけですが、Janssonをバンドルで行うので以下のオプションでconfigureします。。

# ./configure --with-jansson-bundled


以前のバージョンからアップグレードを行う場合、変更されたモジュール類が多いので、一旦、以前のモジュールをディレクトリごと名前変更してバックアップしてからインストールしてください。

mv /usr/lib/asterisk/module /usr/lib/asterisk/module.20.bak

あとはコンパイルとインストールを行うだけです(新規インストールの場合)。

# make
# make install
# make samples
# make config

これで新規インストールは完了します。最後の make config で起動時に自動起動するようになります。
アップグレード時の注意:以前のバージョンからアップグレードする場合、/etc/asterisk の設定ファイル類をバックアップしてから行ってください。make samplesすると /etc/asterisk の内容を上書きしてしまいます。アップグレード時は make installするだけで事足りることが多いです。(make configはシステムのスタートアップファイル類を更新するので大きな変更がない場合には更新の必要はありません。

日本語音声のインストール

Asteriskの本体に付随する日本語音声は古いためGoogle TTSで合成した日本語音声(トーキー)を用意してあります(Asterisk 18ベース)。githubに用意してありますのでご利用ください。
※core-sounds.txtを確認したところ、18と20,22,24で音声の差異は無いようです。

git clone https://github.com/takao-t/asterisk-sound-ja.git

tarでまとめたものを展開します。

cd asterisk-sound-ja
cp core-sound-ja.tgz /var/lib/asterisk/sounds/.
cd /var/lib/asterisk/sounds/
tar zxvf core-sound-ja.tgz

これで sounds/ja の下に日本語音声ファイル類が入ります。LANGUAGE系の設定をjaにすると日本語音声が使えます。
日本語文法に必要なパッチ類を以前提供していましたが、現在ではAsterisk本体にマージされているため文法はLANGUAGEの設定のみで対応できます。

ユーザの追加と設定

Asteriskをasterisk:asteriskで起動させるために以下のようにグループ/ユーザを追加します。UID,GIDの5060は単なる趣味です。

addgroup --gid 5060 asterisk
adduser --uid 5060 --gid 5060 asterisk --disabled-password

Asteriskの実行ユーザ/グループは /etc/defaults/asterisk を編集します。以下の部分のコメントを外します。

# Uncomment the following and set them to the user/groups that you
# want to run Asterisk as. NOTE: this requires substantial work to
# be sure that Asterisk's environment has permission to write the
# files required  for  its  operation, including logs, its comm
# socket, the asterisk database, etc.
AST_USER="asterisk"     <==ここと
AST_GROUP="asterisk"    <==ここ

ディレクトリ/ファイル類の権限も調整しておきましょう。

chown -R asterisk:asterisk /var/log/asterisk
chown -R asterisk:asterisk /var/lib/asterisk
chown -R asterisk:asterisk /var/spool/asterisk
chown -R asterisk:asterisk /usr/lib/asterisk
chown -R asterisk:asterisk /etc/asterisk

これでsystemctlで起動すればAsteriskが動くはずです。

サンプル設定ファイルと応用例

Asterisk 20以降用に大幅に書き直しました。

https://github.com/takao-t/asterisk-conf/tree/main/asterisk_20
使い方 Asterisk_20_サンプル設定ファイル
解説 Asterisk_20_サンプル設定ファイル_解説
NVR500の使用例 Asterisk+NVR500