---
title: "系統更新時 Docker Hub 拉取次數已達上限，該如何處理？"
description: "為什麼系統更新會向 Docker Hub 拉取 image、拉取次數的限制為何，以及如何在 Control Panel 設定 Docker Hub 帳號提高上限"
canonical_url: "https://docs.ardge.com/zh-tw/knowledge/arx-os/docker-pull-limit"
---
# 系統更新時 Docker Hub 拉取次數已達上限，該如何處理？

> 為什麼系統更新會向 Docker Hub 拉取 image、拉取次數的限制為何，以及如何在 Control Panel 設定 Docker Hub 帳號提高上限

## 快速解答

於 **Control Panel › Internet Account** 設定 Docker Hub 帳號，即可將拉取上限自匿名的每 6 小時 100 次，提高至 Docker 帳號的每 6 小時 200 次。若不便設定帳號，亦可等待計數重置後再執行更新。

## 詳細說明

### 為什麼系統更新會觸發拉取限制

ARX 系統以 container 部署服務，系統更新包含更新 container images，而取得 images 須向 Docker Hub 執行拉取（pull）動作。當拉取次數達到 Docker Hub 的限制時，更新即無法繼續。

### Docker Hub 的拉取限制

<table>
<thead>
  <tr>
    <th>
      拉取方式
    </th>
    
    <th>
      計數單位
    </th>
    
    <th>
      每 6 小時上限
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      匿名拉取
    </td>
    
    <td>
      來源 IP
    </td>
    
    <td>
      100 次
    </td>
  </tr>
  
  <tr>
    <td>
      Docker 帳號（免費方案）
    </td>
    
    <td>
      帳號
    </td>
    
    <td>
      200 次
    </td>
  </tr>
  
  <tr>
    <td>
      Docker 帳號（付費方案）
    </td>
    
    <td>
      帳號
    </td>
    
    <td>
      無上限
    </td>
  </tr>
</tbody>
</table>

匿名拉取以來源 IP 計數，因此同一網路環境下的其他裝置會共用這 100 次額度；改以帳號拉取後，計數單位即改為該帳號，不再受其他裝置影響。

## 處理方式

請依實際情況擇一處理：

- **設定 Docker Hub 帳號**：將計數單位由 IP 改為帳號，上限提高至每 6 小時 200 次。設定方式見下方
- **升級 Docker 方案**：付費方案無拉取次數上限
- **等待計數重置**：不進行任何設定時，須待 6 小時的計數週期結束後再重新執行更新

### 在 ARX 設定 Docker Hub 帳號

1. 登入 ARX 管理介面，開啟 **Control Panel**
2. 前往 **Internet Account** 頁面
3. 於 **Docker Hub Auth** 卡片點擊 **Configure**
4. 輸入你的 Docker Hub 帳號與密碼
5. 點擊儲存


## Sitemap

See the full [sitemap](https://docs.ardge.com/sitemap.md) for all pages.