## Debian 安裝 Docker CE >警告：切勿在沒有配置 Docker APT 源的情況下直接使用 apt 命令安裝 Docker. ### 準備工作 #### 系統要求 Docker CE 支持以下版本的 [Debian](https://www.debian.org/intro/about) 操作系統： * Buster 10 (Docker CE 17.11 Edge +) * Stretch 9 * Jessie 8 (LTS) * Wheezy 7.7 (LTS) #### 卸載舊版本 舊版本的 Docker 稱為 `docker` 或者 `docker-engine`，使用以下命令卸載舊版本： ```bash $ sudo apt-get remove docker \ docker-engine \ docker.io ``` #### Debian 7 Wheezy Debian 7 的內核默認為 3.2，為了滿足 Docker CE 的需求，應該安裝 [`backports`](https://backports.debian.org/Instructions/) 的內核。 ### 使用 APT 安裝 由于 apt 源使用 HTTPS 以確保軟件下載過程中不被篡改。因此，我們首先需要添加使用 HTTPS 傳輸的軟件包以及 CA 證書。 Debian 8 Jessie 或者 Debian 9 Stretch 使用以下命令: ```bash $ sudo apt-get update $ sudo apt-get install \ apt-transport-https \ ca-certificates \ curl \ gnupg2 \ lsb-release \ software-properties-common ``` Debian 7 Wheezy 使用以下命令： ```bash $ sudo apt-get update $ sudo apt-get install \ apt-transport-https \ ca-certificates \ curl \ lsb-release \ python-software-properties ``` 鑒于國內網絡問題，強烈建議使用國內源，官方源請在注釋中查看。 為了確認所下載軟件包的合法性，需要添加軟件源的 GPG 密鑰。 ```bash $ curl -fsSL https://mirrors.ustc.edu.cn/docker-ce/linux/debian/gpg | sudo apt-key add - # 官方源 # $ curl -fsSL https://download.docker.com/linux/debian/gpg | sudo apt-key add - ``` 然后，我們需要向 `source.list` 中添加 Docker CE 軟件源： ```bash $ sudo add-apt-repository \ "deb [arch=amd64] https://mirrors.ustc.edu.cn/docker-ce/linux/debian \ $(lsb_release -cs) \ stable" # 官方源 # $ sudo add-apt-repository \ # "deb [arch=amd64] https://download.docker.com/linux/debian \ # $(lsb_release -cs) \ # stable" ``` >以上命令會添加穩定版本的 Docker CE APT 源，如果需要測試或每日構建版本的 Docker CE 請將 stable 改為 test 或者 nightly。 Debian 7 需要進行額外的操作： 編輯 `/etc/apt/sources.list` 將 deb-src 一行刪除或者使用 # 注釋。 ```bash deb-src [arch=amd64] https://download.docker.com/linux/debian wheezy stable ``` #### 安裝 Docker CE 更新 apt 軟件包緩存，并安裝 `docker-ce`。 ```bash $ sudo apt-get update $ sudo apt-get install docker-ce ``` ### 使用腳本自動安裝 在測試或開發環境中 Docker 官方為了簡化安裝流程，提供了一套便捷的安裝腳本，Debian 系統上可以使用這套腳本安裝： ```bash $ curl -fsSL get.docker.com -o get-docker.sh $ sudo sh get-docker.sh --mirror Aliyun ``` 執行這個命令后，腳本就會自動的將一切準備工作做好，并且把 Docker CE 的 Edge 版本安裝在系統中。 ### 啟動 Docker CE ```bash $ sudo systemctl enable docker $ sudo systemctl start docker ``` Debian 7 Wheezy 請使用以下命令啟動 ```bash $ sudo service docker start ``` ### 建立 docker 用戶組 默認情況下，`docker` 命令會使用 [Unix socket](https://en.wikipedia.org/wiki/Unix_domain_socket) 與 Docker 引擎通訊。而只有 `root` 用戶和 `docker` 組的用戶才可以訪問 Docker 引擎的 Unix socket。出于安全考慮，一般 Linux 系統上不會直接使用 `root` 用戶。因此，更好地做法是將需要使用 `docker` 的用戶加入 `docker` 用戶組。 建立 `docker` 組： ```bash $ sudo groupadd docker ``` 將當前用戶加入 `docker` 組： ```bash $ sudo usermod -aG docker $USER ``` 退出當前終端并重新登錄，進行如下測試。 ### 測試 Docker 是否安裝正確 ```bash $ docker run hello-world Unable to find image 'hello-world:latest' locally latest: Pulling from library/hello-world ca4f61b1923c: Pull complete Digest: sha256:be0cd392e45be79ffeffa6b05338b98ebb16c87b255f48e297ec7f98e123905c Status: Downloaded newer image for hello-world:latest Hello from Docker! This message shows that your installation appears to be working correctly. To generate this message, Docker took the following steps: 1. The Docker client contacted the Docker daemon. 2. The Docker daemon pulled the "hello-world" image from the Docker Hub. (amd64) 3. The Docker daemon created a new container from that image which runs the executable that produces the output you are currently reading. 4. The Docker daemon streamed that output to the Docker client, which sent it to your terminal. To try something more ambitious, you can run an Ubuntu container with: $ docker run -it ubuntu bash Share images, automate workflows, and more with a free Docker ID: https://cloud.docker.com/ For more examples and ideas, visit: https://docs.docker.com/engine/userguide/ ``` 若能正常輸出以上信息，則說明安裝成功。 ### 鏡像加速 鑒于國內網絡問題，后續拉取 Docker 鏡像十分緩慢，強烈建議安裝 Docker 之后配置 [國內鏡像加速](mirror.md)。 ### 參考文檔 * [Docker 官方 Debian 安裝文檔](https://docs.docker.com/engine/installation/linux/docker-ce/debian/)