安装 Docker 命令行插件
安装 Buildx 命令行插件
AnySync (Docker Compose) 使用了 Docker Buildx 工具，群晖 Container Manager 并未内置该工具，需要自行安装。
1. 指定安装目录
DOCKER_CONFIG=${DOCKER_CONFIG:-/usr/local/lib/docker}
sudo mkdir -p $DOCKER_CONFIG/cli-plugins
[!NOTE]
上述命令默认将在系统全局位置安装。提前运行以下命令以指定为当前用户目录。
DOCKER_CONFIG=$HOME/.docker由于本次部署流程均使用
sudo 以root 用户身份运行，以上命令将导致后续部署流程出错。可以使用以下命令指定为root 用户目录。DOCKER_CONFIG=/root/.docker以下命令将恢复为系统全局位置。
DOCKER_CONFIG=/usr/local/lib/docker
2. 下载并安装可执行文件
DOCKER_BUILDX_VERSION=$(curl -s https://api.github.com/repos/docker/buildx/releases/latest | jq -r .tag_name)
sudo curl -SL https://github.com/docker/buildx/releases/download/${DOCKER_BUILDX_VERSION}/buildx-${DOCKER_BUILDX_VERSION}.$(uname -s)-$(uname -m | sed 's/x86_64/amd64/;s/armv6l/arm-v6/;s/armv7l/arm-v7/;s/aarch64/arm64/') -o $DOCKER_CONFIG/cli-plugins/docker-buildx
[!WARNING]
以下提示代表网络出错，需要重新运行上述命令。
curl: (92) HTTP/2 stream 1 was not closed cleanly: PROTOCOL_ERROR (err 1)
3. 赋予执行权限
sudo chmod +x $DOCKER_CONFIG/cli-plugins/docker-buildx
[!WARNING]
取决于网络情况，下载过程可能出错。建议运行以下命令检查安装状态。如果安装成功，该命令将输出版本号，否则需要重新下载并安装。
sudo docker buildx version
安装 Compose 命令行插件
截至目前，群晖 Container Manager 的 Project（Docker Compose）不兼容 AnySync 的 docker-compose.yml 格式。此处选择以 Docker 命令行插件形式安装新版本的 Docker Compose。
[!TIP]
补充：截至 2025 年，当前最新版本群晖 Container Manager 已预置 Compose 命令行插件。请尝试跳过该步骤，完整流程请等待后续更新。
[!NOTE]
使用额外安装的 Docker Compose 命令所构建的项目将不会在 Container Manager 的网页 GUI 中显示。
群晖 Container Manager 内置命令用法为
docker-compose，而此处作为命令行插件额外安装的命令用法为docker compose，注意区分。同样作为命令行插件，安装方法可以与上述 Buildx 插件互相参考。
1. 下载并安装可执行文件
DOCKER_COMPOSE_VERSION=$(curl -s https://api.github.com/repos/docker/compose/releases/latest | jq -r .tag_name)
sudo curl -SL https://github.com/docker/compose/releases/download/${DOCKER_COMPOSE_VERSION}/docker-compose-$(uname -s)-$(uname -m) -o $DOCKER_CONFIG/cli-plugins/docker-compose
2. 赋予执行权限
sudo chmod +x $DOCKER_CONFIG/cli-plugins/docker-compose
[!WARNING]
运行以下命令检查安装状态。
sudo docker compose version
准备完成。
参考来源
GitHub - docker/buildx: Docker CLI plugin for extended build capabilities with BuildKit