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

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

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

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

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

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

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

　　OpenSIP-3.1 穩定版

　　OpenSIPS Control Panel  class 8

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

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

　　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

　　如果執行權限錯誤的話(huà)，可能是登錄用戶(hù)沒(méi)有讀寫(xiě)權限，不能寫(xiě)入sources.list.d/opensips.list文件，請檢查用戶(hù)執行權限再次執行。

　　配置好數據以后，再次執行系統更新：

　　apt-get update

　　系統執行更新以后，會(huì )看到opensips的數據加載到了記錄中。

　　確保成功保存文件配置

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

　　apt install opensips

　　apt install opensips-cli

　　安裝CLI工具，如果CLI根據安裝失敗，其他后續步驟免談。沒(méi)有cli工具無(wú)法訪(fǎng)問(wèn)opensips引擎和CP界面。因此，我們一定要確保CLI工具也成功安裝。

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

　　apt install opensips-*

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

　　安裝好opensips和CLI以后，我們需要開(kāi)啟opensips的系統服務(wù)，執行以下命令：

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

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

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

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

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

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

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

　　opensips-cli -x database create opensips

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

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

　　mysql opensips -e "show tables"

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

　　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;

　　以上支持包安裝完成以后，再執行下載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 文件訪(fǎng)問(wèn)界面系統，訪(fǎng)問(wèn)默認apache配置文件目錄（/etc/apache2/sites-available/000-default ），編輯配置文件000-default，替換成以下文件配置：

　　<VirtualHost *:80>

　　#ServerName www.example.com

　　ServerAdmin webmaster@localhost

　　DocumentRoot /var/www/html

　　ErrorLog ${APACHE_LOG_DIR}/error.log

　　CustomLog ${APACHE_LOG_DIR}/access.log combined

　　<Directory /var/www/html/opensips-cp/web>

　　Options Indexes FollowSymLinks MultiViews

　　AllowOverride None

　　Require all granted

　　</Directory>

　　<Directory /var/www/html/opensips-cp>

　　Options Indexes FollowSymLinks MultiViews

　　AllowOverride None

　　Require all denied

　　</Directory>

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

　　<DirectoryMatch "/var/www/html/opensips-cp/web/tools/.*/.*/(template|custom_actions|lib)/">

　　Require all denied

　　</DirectoryMatch>

　　</VirtualHost>

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

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

　　通過(guò)以上命令安裝以后，用戶(hù)就可以通過(guò)瀏覽器，輸入OpenSIPS的IP地址/cp來(lái)訪(fǎng)問(wèn)OpenSIPS Control Panel控制界面，例如，筆者的是192.168.0.102/cp。登錄用戶(hù)名稱(chēng)，admin，密碼是opensips（ 前面已設置）

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

　　www.opensips.org

　　www.opensips.org.cn

　　www.freesbc.cn

　　www.asterisk.org.cn