群晖 NAS 走代理:Docker 与系统两法

群晖上跑 Download Station、Docker、套件更新,经常卡在"连不上"。给 NAS 配代理有两种层次,选错了会出现"配了但没生效"。

两种做法,作用范围不同

方式影响范围适合
系统级代理部分套件(认环境变量的)套件更新、部分下载工具
容器内代理只影响该容器Docker 应用

很多人只配了系统代理,发现 Docker 里的应用还是不生效——因为容器有自己的网络命名空间,不继承宿主的代理设置。

系统级:控制面板里配

DSM 的代理设置在「控制面板 → 网络 → 常规 → 代理服务器」,填地址和端口即可。

注意:这个设置只对部分套件生效。Download Station、套件中心会用,但命令行和 Docker 不会。

命令行要额外配环境变量:

export http_proxy=http://192.168.1.10:7890
export https_proxy=http://192.168.1.10:7890

想持久化,写进 /etc/profile 或者用计划任务在开机时执行。

Docker 里怎么配

三种方式,按推荐顺序:

一、docker run 加环境变量

docker run -e HTTP_PROXY=http://192.168.1.10:7890 \
           -e HTTPS_PROXY=http://192.168.1.10:7890 \
           镜像名

二、docker-compose 里写

environment:
  - HTTP_PROXY=http://192.168.1.10:7890
  - HTTPS_PROXY=http://192.168.1.10:7890

三、给 Docker 守护进程配全局代理

修改 /var/packages/Docker/etc/dockerd.json,加 http-proxy 字段,然后重启 Docker 套件。这样所有容器默认继承。

为什么配了还是不生效

按这四个顺序查:

  1. 代理地址写的是 127.0.0.1 —— 容器里的 127.0.0.1 是容器自己,不是 NAS。要写 NAS 的局域网 IP
  2. 代理软件只监听回环 —— 需要开「允许局域网连接」,否则 NAS 的请求会被拒
  3. 容器用的是 host 网络 —— host 模式会继承宿主环境,但变量要在启动时传入
  4. 应用不认环境变量 —— 部分程序(比如某些 Java 应用)要单独配置

第一条最常见:在 NAS 上配 127.0.0.1:7890,宿主机自己能通,容器里一定不通。

一个更省事的思路

如果 NAS 上需要加速的只有一两个应用(比如媒体刮削、镜像拉取),与其逐个配代理,不如在路由器层解决——给 NAS 单独指定网关为旁路由,一次配好,所有应用都生效。

这样也避免了"每个容器都要改一遍"的维护成本。

💡 验证方法:进容器执行 curl -s https://api.ipify.org,返回的是代理出口 IP 才算成功;返回你的宽带 IP,说明代理没生效。

延伸阅读:旁路由模式、OpenWrt 全局分流、排除列表怎么配。