从网络受限到畅通无阻:群晖 Docker 代理配置经验分享

前言:配置前要做好这些准备#

在开始之前,先跟你确认几件事:

1. SSH 能用吗? 确保你的群晖 NAS 开启了 SSH,而且能通过终端连接
2. 代理服务器准备好了吗? 局域网里得有个可用的 HTTP/HTTPS 代理,把 IP 和端口记好(比如 192.168.1.100:7890)
3. ⚠️ 重要提醒: 配置代理并重启 Docker 会停掉所有运行中的容器!先保存好数据,别像我当时那样手忙脚乱

方法一 服务覆盖文件(强烈推荐)#

说实话,这是我试了 N 种方法之后,发现最稳定、最适合 DSM 7.x 的方式。

原理就是给 Docker 守护进程设置环境变量,让它走代理。听着很复杂?其实步骤很简单。

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

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

1
[Service]
2
Environment="HTTP_PROXY=http://YOUR_PROXY_IP:PORT"
3
Environment="HTTPS_PROXY=http://YOUR_PROXY_IP:PORT"
4
Environment="NO_PROXY=localhost,127.0.0.1"

1
[Service]
2
Environment="HTTP_PROXY=http://192.168.1.100:7890"
3
Environment="HTTPS_PROXY=http://192.168.1.100:7890"
4
Environment="NO_PROXY=localhost,127.0.0.1"

1
sudo systemctl daemon-reload

1
sudo synosystemctl restart pkgctl-ContainerManager

1
systemctl show --property=Environment pkg-ContainerManager-dockerd.service

方法二.json 文件配置#

这个方法是 Docker 的通用配置方式,在大多数 Linux 系统上都能用。

1
sudo vi /etc/docker/daemon.json

1
{
2
  "proxies": {
3
    "default": {
4
      "httpProxy": "http://YOUR_PROXY_IP:PORT",
5
      "httpsProxy": "http://YOUR_PROXY_IP:PORT",
6
      "noProxy": "localhost,127.0.0.1"
7
    }
8
  }
9
}

1
{
2
  "http-proxy": "http://YOUR_PROXY_IP:PORT",
3
  "https-proxy": "http://YOUR_PROXY_IP:PORT",
4
  "no-proxy": "localhost,127.0.0.1"
5
}

1
{
2
  "proxies": {
3
    "default": {
4
      "httpProxy": "http://192.168.1.100:7890",
5
      "httpsProxy": "http://192.168.1.100:7890",
6
      "noProxy": "localhost,127.0.0.1"
7
    }
8
  }
9
}

1
sudo synosystemctl restart pkgctl-ContainerManager

关于 SOCKS5 代理的吐槽#

说实话,Docker 守护进程的代理配置不直接支持 SOCKS5。

我当时也是踩了这个坑,以为直接配置 SOCKS5 就能行,结果试了半天都是白费功夫。

如果你非要用 SOCKS5,有两个办法:

1. 搞个转换代理: 在群晖或者局域网其他设备上跑个转换工具(比如 privoxy、squid),把 HTTP/HTTPS 请求转成 SOCKS5
2. 容器里搞定: 如果只是某个容器需要代理,可以在容器内配置环境变量 ALL_PROXY 或 SOCKS_PROXY,或者装个 proxychains

总结回顾一下核心要点#

老实讲,在群晖 DSM 7.x 上配置 Docker 代理,我推荐你用 systemd 服务覆盖文件 的方式。为什么?因为它跟群晖的服务管理机制更贴合,稳定性真的好很多。

不管你选哪种方法:

✅ 操作前一定要备份数据 ✅ 仔细核对代理服务器信息 ✅ 配置完记得验证

现在就可以开始:

1. 确认你的代理服务器 IP 和端口
2. 选一个配置方法(推荐方法一)
3. 照着步骤一步步来
4. 重启 Docker 服务并验证

相信我,配置完之后,你会发现 Docker 真的很香!镜像想拉就拉,容器想访问外网就访问,再也不用卡在网络问题上崩溃了。

如果你在配置过程中遇到任何问题,随时来问我,我们一起搞定它!