遠端儲存（FTP、SFTP、SMB）

遠端儲存將檔案從相機複製到您自己網路上的伺服器。它可以傳送三種檔案：

輸出	傳送內容
影象	檢測部件的 JPEG 影象：原始捕獲、繪製了工具疊加層的副本，或兩者都有
後設資料	每次捕獲的檢測結果以 JSON 檔案形式儲存，以及 CSV 或 JSONL 格式的連續結果日誌
程式備份	按計劃（每日或每週）複製您的程式

您可以設定兩個儲存目標，例如一個伺服器用於影象，另一個用於備份。每個儲存目標可以是 FTP（或 FTPS）伺服器、SFTP 伺服器或 Windows SMB 共享。

進入 Integration → Remote Storage：

左側導航欄列出了概覽、您的兩個儲存目標和三個輸出，每個都有自己的開/關開關。在您開啟至少一個輸出之前，不會傳送任何內容。

第一步：新增儲存目標

1. 在左側導航欄中，點選儲存目標 1。

2. 選擇協議：

   協議	用途	說明
   FTP	大多數網路儲存驅動器（NAS）和 FTP 伺服器	被動模式。勾選使用 TLS (FTPS) 以加密；伺服器證書必須有效
   SFTP	Linux 伺服器，以及通過 SSH（安全遠端登入協議）訪問的任何其他裝置	伺服器的主機金鑰在首次成功測試時學習
   SMB	Windows 檔案共享	SMB 2 和 3。輸入共享資料夾名稱，如果您的網路使用域，則輸入域

3. 填寫主機（僅伺服器名稱或 IP 地址，不含 ftp://、埠或資料夾）、埠、使用者名稱和密碼。

4. 可選設定資料夾。在 FTP 和 SFTP 上，沒有前導 / 的路徑相對於賬戶的主資料夾，例如 inspections/line3。在 SMB 上，它是共享資料夾內的子資料夾。

5. 要重新命名儲存目標，點選名稱旁邊的鉛筆圖示。該名稱會顯示在導航欄和概覽中。

高階：超時、並行上傳包含連線和空閒超時（1 到 600 秒）以及並行上傳。大多數 FTP 伺服器允許每個使用者兩個連線。

使用專用賬戶

請 IT 部門提供一個只能寫入檢測資料夾的賬戶。相機需要建立資料夾和寫入檔案；它不需要刪除任何內容，也絕不會修改伺服器上已有的檔案。

第二步：測試連線

點選測試連線。相機會執行五項檢查，在第一個失敗處停止，並顯示原因和解決方法：

1. 解析主機名
2. 連線到埠（如果選擇了 FTPS，則使用 TLS）
3. 登入（在 SMB 上，同時開啟共享資料夾）
4. 建立資料夾
5. 寫入、追加和刪除一個 1 KB 的測試檔案

訊息	含義
未找到主機名	檢查拼寫，或使用 IP 地址
連線被拒絕	埠錯誤，或伺服器上的服務未執行
超時、無法連線到伺服器	從相機的網路無法訪問伺服器。檢查路由和防火牆
登入被拒絕	使用者名稱或密碼錯誤。在 SMB 上還可能需要域
不允許建立資料夾、不允許寫入	賬戶在該資料夾上許可權不足
未找到共享資料夾	SMB 共享資料夾名稱錯誤
TLS 握手失敗	FTPS 證書不受信任，或伺服器上未啟用 TLS
不允許刪除	無害。測試檔案被遺留下來；上傳不需要刪除許可權

然後點選頁面底部欄中的儲存。

SFTP：檢查主機金鑰指紋

首次成功的 SFTP 測試會信任伺服器的主機金鑰並顯示其指紋。將其與您的 IT 團隊提供的指紋進行比對。如果金鑰發生變化，相機將拒絕上傳並報告主機金鑰已更改。這種情況會在伺服器重灌後發生，或者在另一臺機器冒充該伺服器響應時發生。在您按下忘記並重新測試之前，請與 IT 部門確認。

第三步：選擇要傳送的內容

在側欄中單擊一個輸出，選擇其儲存目標，進行設定，然後開啟已啟用。兩個輸出可以共享一個儲存目標。

影象

要傳送的捕獲 決定上傳的內容：

選項	傳送
所有捕獲	每次檢測
僅失敗	失敗和未檢測結果
僅通過	通過結果
失敗 + 每 N 次通過 1 次	每次失敗，加上每 N 次通過中的 1 次（1 到 10,000）

資料夾和檔名是由令牌構建的模板，每個欄位下方的行顯示其生成的路徑示例。預設值為：

• 資料夾：{camera}/{YYYY}/{MM}/{DD}
• 檔名：{YYYY}{MM}{DD}_{hh}{mm}{ss}{ms}_{trigger_id}_{result}

然後選擇影象本身。原始影象是完全按拍攝時的捕獲。帶標註影象是同一捕獲，並在其上繪製了工具疊加層：框、標籤、熱圖和區域。可開啟其中一個或兩個。每個都有自己的：

• 尺寸：完整 2592×1944，一半 1296×972 或 四分之一 648×486。較小的影象節省伺服器空間和頻寬；疊加層在每種尺寸下繪製相同
• 質量 (1–100)：JPEG 質量，預設為 85
• 隱藏疊加型別（僅限帶標註影象）：排除框、多邊形、弧、線、點、文字、熱圖或掩碼

底部的預估頻寬根據您的設定，按程式執行的速率計算 MB/s 和每天的 GB 數；如果程式尚未執行，則按每分鐘 60 次檢測計算。請對照伺服器和網路的承載能力進行檢查。

影象設定在生產模式下被鎖定

要傳送的捕獲、尺寸、質量、原始和帶標註開關以及隱藏的疊加型別只能在設定模式下更改，因為它們會改變每次檢測所執行的工作。儲存目標、資料夾和檔名可以隨時更改。

資料夾和檔名的令牌

單擊顯示可在資料夾和檔名中使用的令牌，然後單擊一個令牌將其插入到您最後編輯的欄位中。

分組	令牌
日期	{YYYY} {YY} {MM} {DD} {hh} {mm} {ss} {ms} {timestamp}（紀元毫秒）
裝置	{camera}（相機名稱）、{hostname}、{serial}、{model}
檢測	{recipe}、{recipe_id}、{trigger_id}、{capture_id}、{result}、{variant}
PLC / HTTP	{trigger.<key>}，觸發所攜帶的任何欄位，例如 PLC 傳送的零件號

相機強制執行的規則：

• 檔名必須包含 {trigger_id}、{capture_id} 或 {timestamp}，這樣兩個捕獲就不會相互覆蓋
• 資料夾可以使用 / 進行巢狀；檔名則不可以
• {variant} 僅在檔名中有效。如果原始和帶標註都已開啟而您未包含它，則會自動新增 _raw 和 _annotated

將零件號放入檔名

如果 PLC 隨觸發傳送零件號或序列號，請使用 {trigger.<key>} 新增它。這樣，在伺服器上查詢特定零件的任何人都可以按名稱找到其影象，而無需開啟相機。

後設資料

後設資料使用與影象相同的捕獲哪些選項以及相同的檔名，以便兩者相互對應。它包含兩個部分，您可以啟用其中之一或全部：

• 每次捕獲生成一個 JSON 檔案：一個與其影象同名、以 .json 結尾的檔案。它包含捕獲時間、觸發資料、程式、整體結果、每個工具的結果、分數和詳情，以及隨附上傳影象的路徑
• 結果日誌：一個不斷增長的檔案，每次捕獲佔一行，格式為 CSV（可用 Excel 開啟）或 JSONL（每行一條 JSON 記錄，適用於指令碼和資料庫）。選擇 Daily 或 Hourly 以決定何時開始新檔案。日誌檔名必須包含 {DD}（按天）或同時包含 {hh}（按小時）

包含工具詳情會將每個工具的完整結果新增到兩者中。日誌從不混合不同的程式：如果某個週期中列發生了變化，會啟動新檔案，而不是損壞舊檔案。

某些伺服器不支援追加寫入

如果伺服器無法向現有檔案追加內容，相機會提示，並改為每次捕獲寫入一個結果日誌檔案。影象和 JSON 檔案不受影響。

程式備份

設定	選項
備份內容	所有程式，或僅活動程式
備份時間	每天，或在指定星期幾的每週
時間	24 小時制時間，使用相機本機時區（顯示在欄位下方）
包含訓練影象	關閉：生成緊湊的程式包，可執行但無法重新訓練。開啟：生成完整的程式包，可基於此重新訓練；程式包超過 2 GB 的程式將被跳過

每次執行會為每個程式寫入一個程式包，另加一個 manifest.json，列出每個檔案及其對應的程式、版本和校驗和。立即備份使用已儲存的設定立即執行一次。上次執行和下次執行顯示已執行情況以及下次計劃時間。

與其他備份、匯入或匯出發生衝突的執行會等待並儘快執行，而不是失敗。如果備份計劃到期時相機處於關機狀態，待相機恢復後會補執行一次。

備份中包含您的伺服器密碼

每一個程式包，無論是計劃生成的還是手動匯出的，都包含相機的設定，其中包括以明文形式儲存的遠端儲存密碼。任何可以讀取備份資料夾的人都可以讀取這些密碼。請像保護憑據檔案一樣保護該資料夾。

檢查執行狀態

Overview 顯示每個輸出的摘要、自啟動以來已上傳的內容，以及佇列中等待的內容。

狀態	含義	處理方式
傳送中	檔案正常發出	無需操作
重試中	連線失敗；相機正在自動重試	執行測試連線以立即重試
丟棄捕獲	伺服器速度跟不上生產線，佇列已滿，最早的任務被丟棄	傳送更小的影象、僅傳送失敗項，或增加並行上傳數
已阻止	發生永久性錯誤，例如證書失敗。到該儲存目標的上傳已停止	修正設定，然後執行測試連線；測試通過後將恢復上傳

遠端儲存是副本，而非記錄本身

無論伺服器出現何種情況，檢測都會繼續執行，相機自身的庫仍是完整記錄。上傳失敗會記錄在診斷日誌中，但零件仍會被檢測，其結果仍會傳送到 PLC。

後續步驟

• 所有程式，用於手動匯出或匯入程式
• 庫，相機上儲存的捕獲
• 診斷日誌，用於檢視上傳失敗記錄
• 系統設定，用於設定相機名稱、時區和 NTP（令牌和備份時間依賴於此）