　　OpenSIPS是目前世界上主流的兩個SIP軟交換引擎(其中另外一個是kamailio)或者SIP信令服務(wù)器（個人認為是比較正確的稱謂）。關(guān)于Opensips的基礎(chǔ)和一些參數(shù)配置和安裝方式筆者在很久以前的歷史文檔中有非常多的介紹。最近，很多用戶使用OpenSIPS軟交換平臺做freeSBC或者其他的功能業(yè)務(wù)的實現(xiàn)，這些客戶遇到很多的疑問和安裝中也遇到很多問題，所以，為了讓客戶能夠快速安裝opensips，筆者通過一個最完整和穩(wěn)定的方式完整實現(xiàn)一次安裝過程，幫助客戶能夠快速準確地安裝好opensips，數(shù)據(jù)庫，CLI和界面管理設(shè)置。

　　另外提醒讀者，OpenSIPS是一個SIP信令服務(wù)器，它的功能非常強大，也非常靈活，cfg配置的核心文件可以通過rfc3261結(jié)合第三方應(yīng)用做不同場景中的流程處理。因此，用戶學(xué)習(xí)OpenSIPS時就會面對很多的問題。比較常見的“大概”可以支持的業(yè)務(wù)場景如下，但不僅限于于此。

　　如果讀者不明白這些相關(guān)的基本知識點的話，可以通過微信號查找2018年的歷史文檔，查找 “Kamailio/OpenSIPS學(xué)習(xí)筆記”可以獲得學(xué)習(xí)資料。
　　Kamailio/OpenSIPS學(xué)習(xí)筆記-SIP相關(guān)基礎(chǔ)

　　一些客戶遇到的主要的問題是操作系統(tǒng)選擇錯誤，另外安裝的opensips的版本和界面控制系統(tǒng)CP的安裝錯誤。因此，筆者選擇目前官方最穩(wěn)定的安裝方式進行安裝，幫助客戶或者其他想學(xué)習(xí)opensips的用戶能夠快速上手，并且無需再查找其他資源，保證你安裝環(huán)境能夠正常工作。筆者首先明確安裝配置環(huán)境，然后通過一步步快速安裝方式安裝opensips，安裝數(shù)據(jù)庫，最后安裝opensips的界面CP，最后訪問界面。

　　提醒讀者：根據(jù)官方人士的推薦，為了保證為用戶提供完整穩(wěn)定的安裝流程，筆者僅測試當前的opensips 數(shù)據(jù)源，僅測試Debian 10.6（buster）版本。如果讀者安裝錯誤，可能是其他支持包版本或者連接的問題，請自行更新修復(fù)。

　　1、安裝配置環(huán)境準備

　　在安裝opensips或者其他的開源軟件時，一些用戶經(jīng)常犯的錯誤時，不咨詢官方資源，不看官方說明，根據(jù)自己的喜好或者其他業(yè)務(wù)要求原因，想當然安裝一個操作系統(tǒng)。因此，最后導(dǎo)致很多支持包錯誤，安裝錯誤等問題。這里，筆者不是說其他的操作系統(tǒng)不支持或者不能安裝，為了減少時間浪費，最好按照官方推薦來配置，除非有業(yè)務(wù)需求必須安裝到一個指定的操作系統(tǒng)，否則，筆者建議大家按照官方的配置建議來安裝。這里，筆者安裝的測試環(huán)境包括：

　　Debian 10.6（buster）版本，當然用戶也可以安裝其他的操作系統(tǒng)或者其他的版本，但是“可能”發(fā)生支持包錯誤（至少目前筆者測試安裝ubutun-18/20發(fā)生了錯誤）。根據(jù)官方推薦，安裝Debian 10.6（buster）版本。

　　OpenSIP-3.1 穩(wěn)定版

　　OpenSIPS Control Panel class 8

　　如果讀者非常熟悉操作系統(tǒng)和其支持包包括源代碼安裝的話，也可以通過源代碼安裝方式實現(xiàn)。對于一般基礎(chǔ)用戶，最好查看官方的數(shù)據(jù)配置源：

　　2、安裝OpenSIPS

　　用戶安裝好推薦的操作系統(tǒng)Debian-10以后，以root賬號登錄系統(tǒng)。執(zhí)行以下幾個步驟的操作。首先安裝支持包，創(chuàng)建OpenSIPS的數(shù)據(jù)源：

　　apt install gnupg2

　　apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 049AD65B

　　echo "deb https://apt.opensips.org buster 3.1-releases" >/etc/apt/sources.list.d/opensips.list

　　echo "deb https://apt.opensips.org buster cli-releases" >/etc/apt/sources.list.d/opensips-cli.list

　　如果執(zhí)行權(quán)限錯誤的話，可能是登錄用戶沒有讀寫權(quán)限，不能寫入sources.list.d/opensips.list文件，請檢查用戶執(zhí)行權(quán)限再次執(zhí)行。

　　配置好數(shù)據(jù)以后，再次執(zhí)行系統(tǒng)更新：

　　apt-get update

　　系統(tǒng)執(zhí)行更新以后，會看到opensips的數(shù)據(jù)加載到了記錄中。

　　確保成功保存文件配置

　　然后，執(zhí)行安裝命令，安裝openisps和CLI 工具。注意，opensips-3.1以后對工具做了很多的優(yōu)化和升級，支持了更多的功能。CLI工具安裝也是獨立完成。

　　apt install opensips

　　apt install opensips-cli

　　安裝CLI工具，如果CLI根據(jù)安裝失敗，其他后續(xù)步驟免談。沒有cli工具無法訪問opensips引擎和CP界面。因此，我們一定要確保CLI工具也成功安裝。

　　安裝好opensips和opensips CLI以后，我們還需要安裝opensips的其他支持模塊，執(zhí)行命令：

　　apt install opensips-*

　　如果以上步驟全部正常安裝成功的話，說明opensips和CLI已經(jīng)安裝成功。

　　3、配置系統(tǒng)啟動服務(wù)

　　安裝好opensips和CLI以后，我們需要開啟opensips的系統(tǒng)服務(wù)，執(zhí)行以下命令：

　　systemctl enable opensips // 開啟服務(wù)

　　systemctl start opensips // 啟動服務(wù) stop 關(guān)閉

　　systemctl status opensips // 查看opensips狀態(tài)

　　到這一步為止，我們已經(jīng)成功安裝了opensips， CLI和開啟了系統(tǒng)服務(wù)。接下來，我們繼續(xù)安裝數(shù)據(jù)庫。

　　4、OpenSIPS數(shù)據(jù)庫安裝配置

　　OpenSIPS使用MYSQL來存儲一些必要的配置信息和模塊信息，例如需要存儲subscribers和密碼，撥號規(guī)則，路由配置等信息。這里，我們開始安裝mysql和相關(guān)的支持包。首先，安裝mysql的db，執(zhí)行命令：
　　apt install mariadb-server

　　說明，這里安裝的數(shù)據(jù)庫是本地安裝（和opensips同一服務(wù)器），無需訪問互聯(lián)網(wǎng)資源，無密碼設(shè)置。

　　然后，通過CLI命令，創(chuàng)建opensips數(shù)據(jù)庫：

　　opensips-cli -x database create opensips

　　注意輸入的mysql url地址，這里輸入的是mysql://localhost。如果有獨立安裝的數(shù)據(jù)庫服務(wù)器，輸入其他第三方地址。具體說明，查看mysql手冊。

　　數(shù)據(jù)庫和相關(guān)的表創(chuàng)建成功以后，查看數(shù)據(jù)庫表狀態(tài)，執(zhí)行命令：

　　mysql opensips -e "show tables"

　　5、安裝OpenSIPS Control Panel界面

　　用戶在確認以上所有步驟安裝成功以后，如果需要配置CP界面的話，我們可以通過安裝步驟實現(xiàn)界面配置安裝。如果僅通過CLI操作實現(xiàn)opensips配置的話，無需安裝界面系統(tǒng)。通過界面配置實現(xiàn)OpenSIPS的配置相對比較簡單，筆者建議用戶通過安裝界面來一步步實現(xiàn)cfg的文件配置流程，如果一開始就通過cfg配置的話，一些新手可能非常迷惑。所以，我們花費一點時間來配置控制界面。首先，我們需要安裝一些必要的支持包，我們需要執(zhí)行以下命令：

　　apt-get install -y apache2;

　　apt-get install -y php php-curl php-gd php-pear php-cli php-mysql php-apcu;

　　apt-get install libapache2-mod-php unzip;

　　以上支持包安裝完成以后，再執(zhí)行下載CP安裝命令：

　　cd /var/www/html;

　　wget https://github.com/OpenSIPS/opensips-cp/archive/master.zip;

　　unzip master.zip;

　　mv opensips-cp-master opensips-cp

　　chown -R www-data:www-data /var/www/html/opensips-cp/

　　mysql -Dopensips < /var/www/html/opensips-cp/config/db_schema.mysql

　　cp /var/www/html/opensips-cp/config/tools/system/smonitor/opensips_stats_cron /etc/cron.d/

　　mysql -e "CREATE USER 'opensips'@'localhost' IDENTIFIED BY 'opensipsrw';"

　　mysql -e "GRANT ALL PRIVILEGES ON opensips.* TO 'opensips'@'localhost';"

　　mysql -e "FLUSH PRIVILEGES"

　　systemctl restart cron

　　拷貝文件到cp 目錄截圖：

　　最后配置apache 文件訪問界面系統(tǒng)，訪問默認apache配置文件目錄（/etc/apache2/sites-available/000-default ），編輯配置文件000-default，替換成以下文件配置：

　　#ServerName www.example.com

　　ServerAdmin webmaster@localhost

　　DocumentRoot /var/www/html

　　ErrorLog ${APACHE_LOG_DIR}/error.log

　　CustomLog ${APACHE_LOG_DIR}/access.log combined

　　Options Indexes FollowSymLinks MultiViews

　　AllowOverride None

　　Require all granted

　　</Directory>

　　Options Indexes FollowSymLinks MultiViews

　　AllowOverride None

　　Require all denied

　　</Directory>

　　Alias /cp /var/www/html/opensips-cp/web

　　Require all denied

　　</DirectoryMatch>

　　</VirtualHost>

　　重新啟動服務(wù)器，su -，然后reboot。

　　到此為止，OpenSIPS的控制界面已經(jīng)安裝成功。

　　6、通過瀏覽器訪問OpenSIPS Control Panel 界面

　　通過以上命令安裝以后，用戶就可以通過瀏覽器，輸入OpenSIPS的IP地址/cp來訪問OpenSIPS Control Panel控制界面，例如，筆者的是192.168.0.102/cp。登錄用戶名稱，admin，密碼是opensips（前面已設(shè)置）

　　7、總結(jié)

　　OpenSIPS和控制界面，數(shù)據(jù)庫安裝是相對比較復(fù)雜的過程，很多用戶出現(xiàn)的錯誤大部分都是因為版本的錯誤或者操作系統(tǒng)選擇不匹配。筆者為用戶提供了一個完整的opensips，數(shù)據(jù)庫和界面配置的配置方式，并且推薦了相對比較穩(wěn)定的版本。通過以上一步步的配置，用戶就可以實現(xiàn)OpenSIPS，數(shù)據(jù)庫和界面的配置。當然，這僅是萬里長征的第一步，為了實現(xiàn)OpenSIPS所提供的強大功能，用戶需要首先創(chuàng)建分機，配置路由, 均衡負載，HA或者推薦第三方的集成，例如和Asterisk或者FreeSWITCH媒體服務(wù)器的集成等。

　　參考資料：

　　www.opensips.org

　　www.opensips.org.cn

　　www.freesbc.cn

　　www.asterisk.org.cn