除了網頁應用程式之外，Guacamole 也是一個專案名稱，這個專案的內容就是發展一套 API 提供給 Guacamole 網頁應用程式使用，而這個 API 亦可用於其他類似的應用程式或服務。

一、安裝依賴項

去官網安裝頁面檢視所需依賴項進行安裝，我安裝的當前最新版本0.9.8

apt-get install libcairo2-dev libjpeg62-dev libpng12-dev

其中如果libtelnet-dev依賴項源中沒有，解決如下：

vim  /etc/apt/sources.list

在檔案最後新增：deb http://us.archive.ubuntu.com/ubuntu trusty main universe 儲存退出

apt-get update

即可重新執行apt-get install libtelnet-dev 進行安裝

二、安裝服務端

1.到官網http://guac-dev.org/releases下載服務端壓縮包：guacamole-server-0.9.8.tar.gz

2.到下載目錄解壓檔案：tar -xzf guacamole-server-0.9.8.tar.gz

3.進入解壓目錄

（1）./configure --with-init-dir=/etc/init.d  顯示需要的庫的安裝情況和遠端協議的支援情況

（2）make

（3）make install

（4）ldconfig

（5）執行核心服務guacd：service guacd start   ，如果執行成功則服務端安裝成功

注：如果缺少依賴，進行安裝後需要執行ldconfig

三、安裝客戶端

下載官網的客戶端壓縮包，官網提供兩種包：

1. 壓縮包 guacamole-client-0.9.8.tar.gz ，下載該包需要解壓：tar -xzf guacamole-client-0.9.8.tar.gz ，進入解壓資料夾執行：mvn package 構建和打包，在當前資料夾下的guacamole/target/下生成 .war 檔案。

2.或直接下載打好的war包

四、部署客戶端

1.安裝tomcat7，下載官方建議的版本的tomcat，我安裝的guacamole版本對應的tomcat7

apt-get install tomcat7

2.把war包拷貝到tomcat的webapps目錄下,需要去掉war包的版本號：

cp guacamole.war /var/lib/tomcat7/webapps/

3.放置user-mapping.xml檔案：cp guacamole-client/guacamole/doc/example/user-mapping.xml  /etc/guacamole/

然後編輯：更多修改規則可檢視官網，以下只列出各協議基礎必要的幾項修改

<user-mapping>
    <authorize username="user1" password="123123"> #登入使用者名稱和密碼

         <protocol>vnc</protocol>#遠端連線協議，可以是vnc、rdp和ssh

         <param name="hostname">172.16.58.21</param>#遠端登入伺服器地址

         <param name="port">5901</param>#遠端桌面服務埠

         <param name="password">123456</param>#vnc遠端桌面登入密碼

     </authorize>     
    <authorize username="user2" password="123123">

         <connection name="ssh">#有該標籤登入後會存在遠端桌面的list，不存在則直接登入
            <protocol>ssh</protocol>
            <param name="hostname">172.16.58.21</param>

            <param name="port">22</param>
            <param name="username">root</param>

            <param name="password">123456</param>

         </connection> 
        <connection name="rdp">
            <protocol>rdp</protocol>
            <param name="hostname">172.16.58.21</param>  

            <param name="port">3389</param> 
            </connection> 
        </authorize>

</user-mapping>

4.建立guacamole.properties檔案：vim /etc/guacamole/guacamole.properties

輸入如下：

guacd-hostname:localhost

guacd-post:4822

auth-provider:net.sourceforge.guacamole.net.basic.BasicFileAuthenticationProvider

basic-user-mapping:/etc/guacamole/user-mapping.xml

5. cd /usr/share/tomcat7/

    mkdir .guacamole

    ln -s /etc/guacamole/guacamole.properties  /usr/share/tomcat7/.guacamole/

五、啟動服務

1.啟動guacd：service guacd start

2.啟動tomcat7：service tomcat7 start

   ( 可以把啟動tomcat7設成全域性命令：ln -s /etc/init.d/tomcat7  /usr/bin/ )

六、使用

開啟瀏覽器，在位址列輸入http://localhost:8080/guacamole 進入guacamole客戶端登入頁面，輸入user-mapping.xml設定的賬戶密碼進入，可看到列出的user-mapping.xml檔案中設定的遠端連線列表。

七、問題

guacamole會把使用日誌輸出到系統日誌中，cat /var/log/syslog 即可檢視

檢視系統日誌會發現問題提示：

Failed to load guacsnd plugin. Audio will not work.

Failed to load guacdr plugin. Drive redirection and printing will not work.

解決辦法如下：

ln -s /usr/local/lib/freerdp/guacsnd.so /usr/lib/freerdp/

ln -s /usr/local/lib/freerdp/guacdr.so /usr/lib/freerdp/

把這兩個外掛軟連線到rdp外掛載入的資料夾下。