nexus/wiki/concepts/Docker-Daemon-Proxy.md

title, type, tags, date

title	type	tags	date
Docker Daemon Proxy	concept	docker proxy systemd container	2026-05-14

Docker Daemon Proxy

Aliases

• Docker Daemon Proxy
• Docker 守护进程代理
• Dockerd Proxy
• HTTP_PROXY for Docker Daemon
• Docker Daemon HTTP 代理

Definition

Docker Daemon Proxy 是指通过 systemd 环境变量（HTTP_PROXY/HTTPS_PROXY）为 Docker 守护进程（dockerd）配置显式代理，使所有 docker pull、docker build 和容器出站流量走指定代理服务器。这是透明代理失效时（尤其在群晖 DSM/Ubuntu Server 环境中）的推荐替代方案。

When to Use

• 透明代理（V2RayA/Clash）对 Docker Daemon 网络栈无效
• 需要可靠、可预测的 docker pull 代理行为
• 生产环境/多容器部署中需要与系统路由表解耦
• 群晖 DSM 7.x（服务名 pkg-ContainerManager-dockerd）

Implementation Pattern

Step 1: Create systemd override directory

sudo mkdir -p /etc/systemd/system/pkg-ContainerManager-dockerd.service.d/

Step 2: Create proxy config file

sudo vi /etc/systemd/system/pkg-ContainerManager-dockerd.service.d/http-proxy.conf

Step 3: Write environment variables

[Service]
Environment="HTTP_PROXY=http://127.0.0.1:20171"
Environment="HTTPS_PROXY=http://127.0.0.1:20171"
Environment="NO_PROXY=localhost,127.0.0.1,192.168.*,*.synology.me"

Step 4: Reload and restart

sudo systemctl daemon-reload
sudo systemctl restart pkg-ContainerManager-dockerd

Key Distinction from Transparent Proxy

维度	透明代理（Transparent Proxy）	Docker Daemon Proxy
作用层级	iptables（内核网络层）	systemd 环境变量
生效范围	所有出站流量（NAS 本机）	仅 Docker Daemon 进程
DSM 兼容性	可能失效（网络栈差异）	稳定可靠
对其他服务的影响	可能影响 NAS 其他网络服务	仅影响 Docker
维护难度	高（修改系统路由表）	低（配置分离）

Related Sources

• 群晖NAS科学上网方法 — DSM 7.x 环境下的 Docker Daemon Proxy 完整配置
• Ubuntu-Server科学上网 — Ubuntu Server 环境下的 Docker Daemon Proxy 配置

Related Concepts

• 透明代理 — V2RayA 的默认透明代理机制（在 DSM 中对 Docker Daemon 失效）
• V2RayA — Docker Daemon Proxy 的上游代理服务提供者
• 分流模式 — V2RayA 的流量路由策略
• iptables — 透明代理依赖的内核规则