版本：4.0.6.2
一、概述
C-Lodop雲打印是一款精巧快捷的雲打印服務產品，以Lodop功能語句為基礎，JS語句實現遠程打印
移動設備+Wifi+普通打印機+集中打印
C-Lodop對客戶端瀏覽器要求很低，支持任何現代瀏覽器，
客戶端還支持“平板電腦”和“智能手機(無需安裝APP)”以及Linux、OS(Mac)上的瀏覽器。
C-Lodop可扮演三種角色(參考官網三角色圖)
第一種是在Windows客戶端PC本機安裝，從而替代Lodop控件功能，這也是常見用法；
第二種是單獨部署的打印服務器，適合局域網內的后台集中打印；第三種角色是廣域網AO服務器（參見后章節C-Lodop擴展版部分）。
在第一種角色中，一般采用“雲打印C-Lodop + 控件Lodop”組合搭配使用。
1）C-Lodop與Lodop組合搭配示意圖：
2）C-Lodop獨立服務器部署示意圖：
二、安裝
C-Lodop標准版的(32位)安裝文件：
文件名是CLodop_Setup_for_Win32NT.exe 可同時在32位和64位Windows操作系統上安裝，適應面較廣。
安裝后的運行文件：
1、文件路徑：Program Files (x86)\MountTaiSoftware\CLodop32
2、主服務文件：CLodopPrint32.exe
3、免登錄服務文件：CLodopService32.exe
4、樣例Demo目錄
Program Files (x86)\MountTaiSoftware\CLodop32\Rootdir\CLodopDemos
樣例中有一個LodopFuncs.js文件很小很關鍵，建議盡量看懂它。
安裝后的窗口
正常安裝成功后，會彈出如下提示窗口：
這也是管理設置窗口，事后可以從Windows開始菜單里重新進入該界面。
在設置界面中，通過“設置->端口設置”菜單進入下面的對話窗口進行端口設置，
http通訊協議的默認雙端口是8000和18000（擴展版支持的https協議端口是8443，見后章節）。
修改端口的操作只有在C-Lodop作為獨立服務器軟件(角色2和角色3)時才使用，且僅能修改第1端口。
安裝后的歡迎頁面
點擊以上（圖1-2-1）圈定的按鈕鏈接，進入如下歡迎頁面：
如（圖1-2-4）紅框中連接進入，可驗證全部傳統例子在c-lodop中的應用情況。
三、頁面調用
加載雲打印JS文件的簡單方法
調用C-Lodop很簡單，在頁面head中 添加 如下路徑的js文件，就可以向其發打印請求了，
如下幾個例子都可以在歡迎頁面或Lodopfuncs.js這個樣例文件里找到：
<script src=”http://Host地址:8000/CLodopfuncs.js”></script>
這里的藍色部分是固定內容，Host地址是指安裝C-Lodop的主機地址，可以是其IP地址或其域名，
如果是本地(角色1)打印，該值用localhost、127.0.0.1或主機名代替，端口默認是8000、18000雙端口(頁面可以引用之一或同時引用），
引用雙端口的優勢是當其中一個端口失效時，另一端口可繼續工作，例如：
<script src=”http://192.168.1.1:8000/CLodopfuncs.js”></script> <script src=”http://192.168.1.1:18000/CLodopfuncs.js”></script>
動態加載雲打印JS文件
為了方便控制或兼容老程序，以上靜態方法可以用如下動態語句替代，效果一樣：
var oscript = document.createElement("script"); oscript.src ="http://localhost:8000/CLodopfuncs.js?priority=1"; var head = document.head || document.getElementsByTagName("head")[0] || document.documentElement; head.insertBefore( oscript,head.firstChild );
LodopFuncs.js中動態加載如圖(3-1)：
雲打印JS文件的優先級
<script src=”http://localhost:8000/CLodopfuncs.js? priority=1”></script>
以上引用方法的參數priority設置的是優先級，優先級值是從0開始的阿拉伯數字，數字越大，優先級越高，默認是0。
當一個頁面按后續章節同時引用多個雲主機時，優先級設置很關鍵，否則會按下載順序來處理。
加載多個雲打印JS文件
如果一個頁面通過以上語句同時引用了兩個雲主機，
通常后一個引用會覆蓋前一個引用，其先后順序是以下載js速度快慢為准，
此時如果頁面希望其中一個引用有更高的優先級，可以用url參數priority來控制，該參數值越大優先級越高，默認值為0，
例如：
<script src=”http://192.168.1.6:8000/CLodopfuncs.js”></script> <script src=”http://Localhost:8000/CLodopfuncs.js? priority=1”></script>
這也是C-Lodop默認安裝例子演示時，既可以讓手機瀏覽器訪問，也可以讓電腦訪問的神奇原因。
如果希望頁面的兩個引用同時存在(不相互覆蓋)，則需要用url的參數name來區分,例如：
<script src='http://192.168.1.1:8000/CLodopfuncs.js?name=LODOPA'></script> <script src='http://192.168.1.2:8000/CLodopfuncs.js?name=LODOPB'></script>
此時調用打印時，不再用LODOP這個默認的JS變量名，而是用LODOPA或LODOPB，二者分別向不同的雲主機發打印指令，
LODOPA指向192.168.1.1，而LODOPB指向192.168.1.2，以此類推。
獲取LODOP對象
按照以上引用成功后，就可以在頁面程序里通過getCLodop函數獲取主對象，賦值給一個普通JS變量，以此開始調用其功能。
為了兼容已經開發好的傳統打印程序，仍然統一用LODOP這個變量名：
var LODOP = getCLodop();
有了該對象之后，就可以調用雲打印功能語句了，如
LODOP.PRINT();
LODOP.PREVIEW();
LODOP.PRINT_DESIGN();
更多語句參考后面的功能函數介紹。
(注：在綜合版例子Lodopfuncs.js中,getLodop函數包含了getCLodop的調用，注意區分)
四、功能函數、屬性和事件
C-Lodop的功能函數涵蓋了Lodop的所有語句，它們的詳細功能說明參考《WEB打印控件Lodop技術手冊》。
除此之外，新增了部分與頁面整合相關的函數、屬性和觸發事件，個別語句的參數值也有所擴展。
C-Lodop服務網址
C-Lodop服務很多功能是以web方式訪問處理的，
這些入口都可以從歡迎頁面 的超文本鏈接里找到，
這里再羅列一下（以localhost為例）：
1、http://localhost:8000/
主歡迎頁面
2、http://localhost:8000/c_sysmessage
查看系統信息，這個頁面可以看到當前C-Lodop版本，內含Lodop版本、出錯信息等
3、http://localhost:8000/c_mlogin
設置管理員(admin)密碼
管理員admin是固定名，初始密碼為空，有些訪問地址需先登錄管理員
4、http://localhost:8000/c_aoprint
AO打印歡迎頁面
5、http://localhost:8000/c_aobridge
AO端橋打印歡迎頁面
6、http://localhost:8000/c_aoprintget
AO打印相關查詢演示頁面
7、http://localhost:8000/c_pdfprint
PDF文件打印相關演示頁面
8、http://localhost:8000/c_mpermit
設置訪問者(guest客戶)密碼
9、http://localhost:8000/c_whitelist
設置來源網址白名單，
該設置可以限制訪問調用本C-Lodop服務的來源網頁(WEB應用頁),進一步防止惡意打印騷擾。
白名單使用原則url地址包含白名單，不能用*等通配符，可設置多個白名單，
如果確定單個網址使用時，建議包含完整的rul地址前面部分。
10、https://localhost:8443/
https協議的歡迎頁面
11、http://localhost:8000/c_mlicense
商用注冊
12、http://localhost:8000/c_options
設置顯示選項(需注冊)
13、http://localhost:8000/c_update
下載安裝文件(需服務端部署升級)
擴展版概述
C-Lodop擴展版在涵蓋標准版功能的基礎上，擴展了兩個方面的功能，
一是支持AO打印(英文Active-Online Print)，二是支持https通訊協議。
AO打印也稱“主動在線”打印，是指處於活動狀態的AO打印機主動把自己的信息提交到專門的服務器(AO服務器)上，隨時在線待命，
而打印發起者通過該服務器中轉功能實現遠程打印的工作模式。
該工作模式目前廣泛應用於手機等移動設備(瀏覽器)的廣域網打印業務。
AO打印機有兩種：一是專門生產的專用AO打印機，二是“AO端橋(軟件)+普通打印機”配合實現AO打印效果。
在以上工作模式中，C-Lodop擴展版既擔任AO服務器軟件，也擔任AO端橋軟件，推薦兩端采用同一版本，
參見下圖(來自三角色圖)：
關於C-Lodop擴展版支持https協議，包含兩方面含義：
第一：安裝程序自帶localhost(特殊域名)SSL證書，來自localhost調用自動適用https協議，無需任何設置（適用角色1）；
第二：支持自主域名的SSL證書，一般在C-Lodop擴展版擔任獨立的AO服務器角色(角色2,3)時使用；
64位版的SSL通訊協議版本更高(含TLSv1.1和TLSv1.2)，適合對安全級別要求更高的網站。
特別注意用64位版部署在客戶端時（不推薦這種部署），其訪問本地的URL地址是:localhost.c-lodop.com(有專門的永久域名指向本地)
而不是傳統的特殊字符localhost。
二、擴展版安裝
擴展版包含兩個安裝程序，其中32位程序既適合32位操作系統，也適合64位操作系統，適應面比較廣，特別適合客戶端安裝環境比較繁雜的情況。
而64位程序僅適合64位系統，但可以管理超大內存，比較適合獨立部署的大型雲端服務器系統，譬如AO雲服務器。
在如圖（2-2-1）安裝界面選項中，勾選“雲服務器工作模式”僅適合獨立服務器安裝，一般客戶端安裝時不推薦勾選(按默認就行)，
這個工作模式並不影響服務功能，僅僅是對獨立工作（無人工干擾）的雲端服務器進行特殊處理，
例如忽略一些彈窗對話、屏蔽遠程桌面操作時“重定向”管理員電腦上的打印機等等，也就是讓服務器運行在靜默狀態。
擴展版32位安裝文件：
文件名是CLodop_Setup_for_Win32NT_https_4.xxxExtend.exe可同時在32位和64位Windows操作系統上安裝，
適應面較廣，既適合做AO服務器，也適合做AO端橋。
擴展版64位安裝文件：
文件名是CLodop_Setup_for_Win64NT_4.xxxExtend.exe 只能在64位Windows操作系統上安裝，
性能較高，比較適合對性能要求較高的AO服務器。
擴展版安裝后的窗口
下面是擴展版正常安裝后，比較典型的截圖（2-2-2）：
相比較標准版，增加了“擴展功能”菜單，擴展功能的三個子菜單如下：
a：AO打印服務器，這個菜單可以監控作為AO服務器軟件時的運行狀態和深度設置.
b：AO客戶端橋設置，這個菜單可以進行作為AO端橋軟件時的鏈接設置，一般安裝在客戶端作為AO端橋使用時進行該設置；
c：SSL(https)設置，這個菜單可以進行自主域名SSL證書的部署設置；
三、頁面調用
擴展版的http協議頁面調用與標准版完全兼容，支持雙端口，格式如下：
<script src="http://Host地址:8000/CLodopfuncs.js"></script> <script src="http://Host地址:18000/CLodopfuncs.js"></script>
而C-Lodop擴展版的https協議引用方法與標准版不一樣，其默認端口是8443（對應的Host地址也只能是域名，因SSL證書僅頒發給域名地址）。
初次安裝時，如果該默認端口被占用，端口值會自動加1，直到成功，
所以https協議也可以使用雙端口(8443和8444)引用主JS文件（忽略頁面報錯信息），
格式如下：
<script src="https://Host域名:8443/CLodopfuncs.js"></script> <script src="https://Host域名:8444/CLodopfuncs.js"></script>
四、函數擴展
C-Lodop擴展版的語句函數完全兼容標准版甚至Lodop控件的所有語句，但有幾個語句進行了參數和功能擴展
五、界面設置
C-Lodop擴展版無論充當獨立服務器還是客戶端橋，界面設置步驟都極少，幾乎是零設置，
但在實際使用過程中，特別是遇到問題時，還是有些深度設置需要了解的，主要有如下幾個方面:
AO服務器的選項設置
進入路徑：C-Lodop(AO服務器)安裝后的主界面
--> 設置 -> 擴展功能 -> AO打印服務 -> 服務選項 -> 服務選項設置
進入后會看到如下設置界面：
其中可設置AO打印機在線心跳間隔時間、任務超時定義、任務保留時長、是否提示端橋升級，以及升級新版的下載地址等。
AO服務器的SSL設置
進入路徑：C-Lodop(AO服務器)安裝后的主界面->設置->擴展功能->SSL(https)設置
進入后會看到如下設置界面：
設置自有域名的SSL證書來源路徑和Key證書密碼等如下信息：
2.1 OpenSSL鑰匙文件:購買域名證書時，CA證書頒發者（或代理商）返回的幾個文件中擴展名是“key”的那個關鍵文件；
2.2 OpenSSL證書文件:另一個關鍵私有文件，擴展名一般是“pem”或“crt”，通常比key文件大一些；
2.3 OpenSSL根證書文件:頒發者公開對外的CA文件，擴展名也是pem或crt，購買SSL證書時沒有它，需要另外下載，如果該機構足夠權威，這一步可以不用設置；
2.4 OpenSSL鑰匙文件密碼:是購買SSL證書時約定的具體密碼值，也就是證書文件的使用密碼；
注：密碼是防止別人得到這些文件后冒用的，有些頒發者返回的是無密碼證書，此時需自己想辦法附加上密碼，通常用OpenSSL.exe軟件。
3：AO客戶端橋設置
進入路徑：
C-Lodop(端橋)安裝后的主界面 -> 設置 -> 擴展功能 -> AO客戶端橋
進入后會看到如下設置界面：
其中可設置端橋功能啟用、指向的AO服務器IP，本AO端橋的編號和標識名等。
注意：AO服務的默認端橋鏈接端口是9200，管理和打印端口是8000，這倆端口可修改，注意防火牆開啟這倆端口的訪問權。
4：運行日志
設置方法：在端口設置界面的右鍵菜單里勾選 Run Logs，如圖（1-4-1）；
存放路徑：
MountTaiSoftware/CLodop32/Logs，保留最新7天日志，每天不超過200k（約2千條）
日志內容：
日志有對話REQUEST類和打印PRINTED類兩類成功日志，
前者保存了REQUEST請求目的、對方IP、對話協議、對話端口和對話時間;
后者保存了打印任務名、打印機名稱、打印任務頁數、打印份數、打印時間；每天各一個日志文件。
日志文件名:
REQUEST類：REQUEST_日期，
PRINTED類：PRINTED_日期，
例如:REQUEST_2019-09-11 , PRINTED_2019-09-11。