行云管家浏览器插件安装配置说明 - 产品文档

1、行云管家浏览器插件程序包含哪些功能

2、Windows下行云管家浏览器插件安装方式

2.1 Chrome浏览器且能够访问海外站点 2.2 Chrome浏览器且无法访问海外站点 2.3 Firefox浏览器插件安装

3、Mac下行云管家浏览器插件安装方式

3.1 Chrome浏览器且能够访问海外站点 3.2 Chrome浏览器且无法访问海外站点 3.3 Firefox浏览器插件安装

4、Linux下行云管家浏览器插件安装方式

4.1 Chrome浏览器且能够访问海外站点 4.2 Chrome浏览器且无法访问海外站点 4.3 Firefox浏览器插件安装

行云管家浏览器插件包含两大功能，“云拷贝”和“本地工具一键唤醒器”。

云拷贝是指：当你在浏览器中打开某台Windows主机（以下简称目标主机）的远程桌面时，你需要在当前浏览器所在客户端与目标主机之间进行剪贴板同步，从而方便在这两者之间进行内容的复制。

本地工具一键唤醒器是指：你需要在浏览器中一键打开Putty、SecureCRT、XShell等本地工具，因此，你需要通过“本地工具配置器”配置这些本地工具的安装路径，并通过“本地工具一键唤醒器”在浏览器中打开这些工具。

在不同的操作系统与浏览器下，行云管家浏览器插件功能兼容列表如下：

操作系统	浏览器	云拷贝	本地工具
Windows	Chrome	支持	支持
Windows	Firefox	支持	支持
Linux	Chrome	支持	支持
Linux	Firefox	支持	支持
MacOS	Chrome	支持	支持
MacOS	Firefox	支持	支持

1）在Windows里，行云管家浏览器插件程序支持的本地工具如下：

Putty、 SecureCRT、 XShell、 mstsc、 UltraVNC、 TigerVNC、 WinSCP、 FileZilla、 ssms、 Navicat

2）在Linux里，所有版本都支持云拷贝功能，而其中的Red Hat7、CetnOS7、Ubuntu1804以及1604版本里，行云管家浏览器插件程序支持的本地工具如下：

xFreeRDP、 GNOMETerminal、 TigerVNC

3）而在MacOS里，行云管家浏览器插件程序支持的本地工具如下：

MacOSTerminal、 iTerm、 Microsft RD、 TigerVNC

行云管家浏览器插件安装程序可从此处下载：yun.cloudbility.com/download.html，在不同的操作系统下，其安装方式分别如下文所述。需要注意的是：如果您以前安装过旧版本的浏览器扩展程序，请先将其移除并卸载，然后在官方链接下载最新版本件进行安装；

浏览器插件中默认自带TigerVNC+程序，您可以直接使用。TigerVNC+是行云管家基于开源TigerVNC开发的一款VNC客户端软件，在VNC标准的协议之上实现了运维策略中的屏幕水印显示。该程序开源地址为https://github.com/james-li/tigervnc

首先请从官方下载最新版本的安装程序，双击执行，安装路径默认为： C:\Program Files (x86)\Cloudbility\XingYunGuanJiaPlugin 。安装程序执行完毕后，您还需要针对不同的浏览器进行扩展程序的配置。

1）请在Chrome浏览器中输入：https://chrome.google.com/webstore/category/extensions

2）按下图指引首先在搜索框里输入行云管家进行搜索，然后在搜索出来的行云管家里点击添加至Chrome；

3）按下图指引点击添加扩展程序；

4）此时行云管家浏览器插件安装完成；

2.2 Chrome浏览器且无法访问海外站点

1）请按下图指引检查当前Chrome版本是否为64位较新版本浏览器，如果版本过低或者为32位浏览器，建议安装新版本64位Chrome浏览器（Chrome浏览器下载链接： https://yun.cloudbility.com/download.html ）

2）Chrome扩展程序文件名称为：Cloudbility_Chrome.crx，该文件默认路径为 C:\Program Files (x86)\Cloudbility\XingYunGuanJiaPlugin\web_extensions

3）按下图指引打开Chrome扩展程序（Chrome Extensions）选项，或者您也可以直接在Chrome地址栏中输入：chrome://extensions/

4）请打开Chrome扩展程序的“开发者模式”，如果没有该选项，建议升级安装64位较新版本Chrome浏览器；

5）请直接将Cloudbility_Chrome.crx文件拖入上一步打开的Chrome Extensions选项页面中；如果该文件无法拖入Chrome Extensions选项页面，请首先检查浏览器是否为较新版本的64位Chrome浏览器，然后参照第7步进行操作；

6）在弹出的提示窗口，点击“添加扩展程序”按钮，此时行云管家插件配置完成。

7）如果在第5步中Cloudbility_Chrome.crx文件无法拖入Chrome Extensions选项页面，那么请点击加载已解压的扩展程序，选择“Cloudbility_Chrome”目录，点击“确定”。

8）这时，在Chrome的扩展程序中，会出现一个带有“未封装的扩展程序”图标的行云管家扩展程序，此时行云管家插件配置完成。

9）如果添加后有显示如图Errors（错误），请记录下图里的ID。

打开"C:\Program Files (x86)\Cloudbility\XingYunGuanJiaPlugin\XingYunGuanJiaPlugin.json"文件，在如图位置增加一句"chrome-extension://这里请填写刚记录的ID/",此时即可保存并关闭文件完成安装。

2.3 Firefox浏览器插件安装

1）打开Firefox浏览器，按下图指引打开附加组件管理器，或者直接在Firefox地址栏中输入：about:addons

2）点击右上角的齿轮图标，选择“从文件安装附加组件”按钮（如果您以前安装过旧版本的浏览器扩展程序，请先将其移除）；

3）在文件选择窗口中，选择扩展程序文件Cloudbility_Firefox.xpi；该文件默认路径为C:\Program Files (x86)\Cloudbility\XingYunGuanJiaPlugin\web_extensions

4）在弹出的提示窗口，点击“添加”按钮，此时行云管家插件配置完成。

3、Mac下行云管家浏览器插件安装方式

1）首先请从官方下载最新版本的安装程序，解压下载的文件cloudNativeTools-mac-2.0.0.1.zip，即可得到CloudbilityPlugin_pkg目录，右键CloudbilityPlugin_2.0.0.1.pkg文件，并点击打开来执行安装。

2）按照向导安装完成后，如果您想使用本地工具唤醒器的功能，请点开“系统偏好设置->安全与隐私”。

3）在“安全与隐私->隐私->辅助功能”中点击“+”添加按钮。

4）选择"应用程序"中的“CloudbilityPlugin”点击打开，此项操作仅仅是允许本地工具打开iterm并自动输入ssh登录密码，并不会对系统安全造成任何影响。

5）在CloudbilityPlugin_pkg目录右键demo.rdp文件，点击“显示简介”。

6）在打开方式那一栏里选择“Microsoft Remote Desktop”，然后点击全部更改。

7）此时即完成本地工具的授权及配置，您随时可以点开“应用程序”（即/Applications/）路径的CloudbilityPlugin文件来更改相关本地工具配置路径。

8）与此同时，您可以按后面操作步骤针来安装不同浏览器的浏览器插件，浏览器插件文件位于上述解压后的CloudbilityPlugin_pkg目录中。

3.1 Chrome浏览器且能够访问海外站点

1）请在Chrome浏览器中输入：https://chrome.google.com/webstore/category/extensions

2）按下图指引首先在搜索框里输入行云管家进行搜索，然后在搜索出来的行云管家里点击添加至Chrome；

3）按下图指引点击添加扩展程序；

4）此时行云管家浏览器插件安装完成；

3.2 Chrome浏览器且无法访问海外站点

1）请按下图指引检查当前Chrome版本是否为64位较新版本浏览器，如果版本过低或者为32位浏览器，建议安装新版本64位Chrome浏览器（Chrome浏览器下载链接：https://yun.cloudbility.com/download.html）

2）按下图指引打开Chrome扩展程序（Chrome Extensions）选项，或者您也可以直接在Chrome地址栏中输入：chrome://extensions/

3）请打开Chrome扩展程序的“开发者模式”，如果没有该选项，建议升级到较新版本的64位Chrome浏览器；

4）点击加载已解压的扩展程序，选择CloudbilityPlugin_pkg目录里的Cloudbility_Chrome文件夹即可完成行云管家插件配置。

5）在第4步中，您还可以通过这种方式：直接将CloudbilityPlugin_pkg目录里Cloudbility_Chrome.crx文件拖入到已打开的Chrome Extensions选项页面中。

6）在弹出的提示窗口，点击“添加扩展程序”按钮，此时行云管家插件配置完成。

7）如果添加后有显示如图Errors（错误），请记录下图里的ID。

打开"/Applications/CloudbilityPlugin/Contents/Resources/com.cloudbility.xingyunguanjiaplugin.chrome.json"文件，在如图位置增加一句"chrome-extension://这里请填写刚记录的ID/",此时即可保存并关闭文件完成安装。

3.3 Firefox浏览器插件安装

1）打开Firefox浏览器，按下图指引打开附加组件管理器，或者直接在Firefox地址栏中输入：about:addons

2）在附加组件管理器页面点击如图“设置”图标，点击从文件安装附加组件。

3）在CloudbilityPlugin_pkg路径里选择Cloudbility_Firefox.xpiFirefox并点击打开。

4）在第2步中，您还可以通过这种方式：直接将Cloudbility_Firefox.xpi文件拖入到Firefox浏览器已经打开的about:addons选项页面中；

5）在弹出的提示窗口，点击“添加”按钮，此时行云管家浏览器插件安装完成。

4、Linux下行云管家浏览器插件安装方式

1）首先请从官方下载最新版本的安装包（CentOS7请下载RedHat的安装包），即可得到"CloudbilityPlugin-plugin"开头的安装包。

2）如果您是Ubuntu系统，请在"Terminal"里执行"cd /root/Downloads"，然后执行"sudo apt install cloudbility-plugin（文件全名）"来进行安装。

Ubuntu1604系统安装时如果遇到以下报错，直接点OK即可，此时安装完成。

3）如果您是CentOS或RadHat系统，请在"Terminal"里执行"cd /root/Downloads"，然后执行"sudo rpm -ivh cloudbility-plugin-（文件全名）"来进行安装。

如果安装时遇到以下报错，请执行"yum install -y fltk.x86_64"以及"yum install -y xsel.x86_64"这两条命令后再执行"sudo rpm -ivh cloudbility-plugin-（文件全名）"来进行安装。

4）安装完成后安装默认路径一般为"/usr/local/XingYunGuanJiaPlugin"。

5）您可以在安装目录里随时可以点开“cloudNativeTool”文件来更改相关本地工具的配置路径。

6）与此同时，您可以按后面操作步骤针来安装不同浏览器的浏览器插件，浏览器插件文件在"/usr/local/XingYunGuanJiaPlugin/web_extensions"目录中。

4.1 Chrome浏览器且能够访问海外站点

1）请在Chrome浏览器中输入：https://chrome.google.com/webstore/category/extensions

2）按下图指引首先在搜索框里输入行云管家进行搜索，然后在搜索出来的行云管家里点击添加至Chrome；

3）按下图指引点击添加扩展程序；

4）此时行云管家浏览器插件安装完成；

4.2 Chrome浏览器且无法访问海外站点

1）请按下图指引检查当前Chrome版本是否为64位较新版本浏览器，如果版本过低或者为32位浏览器，建议安装新版本64位Chrome浏览器（Chrome浏览器下载链接：https://yun.cloudbility.com/download.html）

2）按下图指引打开Chrome扩展程序（Chrome Extensions）选项，或者您也可以直接在Chrome地址栏中输入“chrome://extensions/”

3）请打开Chrome扩展程序的"开发者模式（Developer mode）"，如果没有该选项，建议升级到较新版本的64位Chrome浏览器；

4）点击“加载已解压的扩展程序（Load unpacked）”，选择"/usr/local/XingYunGuanJiaPlugin/web_extensions"目录里的"Cloudbility_Chrome"文件夹即可完成行云管家插件配置。

5）在第4步中，您还可以通过这种方式：直接将"Cloudbility_Chrome.crx"文件拖入到已打开的"Chrome Extensions"选项页面中。

6）在弹出的提示窗口，点击"添加扩展程序（Add extension）"按钮，此时行云管家插件配置完成。

7）如果添加后有显示如图Errors（错误），请记录下图里的ID。

打开"/etc/opt/chrome/native-messaging-hosts/com.cloudbility.xingyunguanjiaplugin.json"文件，在如图位置增加一句"chrome-extension://这里请填写刚记录的ID/",此时即可保存并关闭文件完成安装。

4.3 Firefox浏览器插件安装

1）打开Firefox浏览器，按下图指引打开"附加组件管理器（Add-ons）"，或者直接在Firefox地址栏中输入"about:addons"

2）在附加组件管理器页面点击如图“设置”图标，点击“从文件安装附加组件（Install Add-on From File）”。

3）在"/usr/local/XingYunGuanJiaPlugin/web_extensions"路径里选择"Cloudbility_Firefox.xpi"并点击"打开（Open）"即可完成行云管家插件配置。

4）在第2步中，您还可以通过这种方式：直接将"Cloudbility_Firefox.xpi"文件拖入到Firefox浏览器已经打开的"about:addons"选项页面中；

5）在弹出的提示窗口，点击"添加（Add）"按钮，此时行云管家浏览器插件安装完成。