群晖的 Container Manager(原 Docker 套件)看起来很友好,但真正部署服务时,90% 的人会卡在四个地方:权限、路径、端口、网络。

这篇按这四类问题组织,每个都给出报错原文和解决办法。

一、权限问题

现象 1:SSH 里执行 docker 报权限错误

permission denied while trying to connect to the Docker daemon socket

原因:你的 SSH 用户不在 docker 组里。

解决:

# 方法一:切 root
sudo -i

# 方法二:把自己加进 docker 组
sudo synogroup --add docker $(whoami)
sudo chown root:docker /var/run/docker.sock
# 重新登录 SSH 生效

注意:群晖的 usermod -aG docker 有时不生效,用 synogroup 命令更可靠。

现象 2:容器写入文件后,群晖里看不到/改不了

原因:容器内进程的 UID 和群晖用户的 UID 不匹配。

群晖的用户 UID 从 1026 开始:

# 查自己的 UID
id
# 输出示例:uid=1026(yourname) gid=100(users)

解决:启动容器时传入 PUID/PGID(大多数镜像都支持):

docker run -d \
  -e PUID=1026 \
  -e PGID=100 \
  -v /volume1/docker/app:/config \
  linuxserver/someimage:latest

LinuxServer.io 的镜像都支持 PUID/PGID,这是最省事的做法。

现象 3:容器启动后立刻退出,日志显示权限拒绝

Error: EACCES: permission denied, mkdir '/data'

原因:挂载的宿主机目录属主不对。

解决:

# 查看目录属主
ls -ln /volume1/docker/app
# 输出示例:drwxr-xr-x 1 0 0 ...  ← 属主是 root(0)

# 改成你的用户
sudo chown -R 1026:100 /volume1/docker/app

二、路径问题

现象:容器启动成功,但数据重启就丢

原因:没挂载数据卷,或挂载路径写错。

群晖的路径规则:

类型 路径
共享文件夹 /volume1/<共享文件夹名>
Docker 数据 /volume1/@docker
USB 外接盘 /volumeUSB1/usbshare
NVMe 缓存盘 不可用于 Docker 数据

正确的挂载写法:

docker run -d \
  -v /volume1/docker/jellyfin/config:/config \
  -v /volume1/media/movies:/movies \
  jellyfin/jellyfin:latest

错误的写法:

# ❌ 相对路径(会挂到容器内当前目录)
-v ./config:/config

# ❌ 用了共享文件夹的显示名而不是实际路径
-v /docker/jellyfin:/config

怎么确认实际路径:

# 在 File Station 里右键文件夹 → 属性 → 位置
# 或者在 SSH 里
ls /volume1/

坑:Docker 目录塞满存储池 1

默认 Docker 数据在 /volume1/@docker。如果你的存储池 1 是小容量 SSD,很快会满。

改数据目录(Container Manager 7.2+):

  1. 打开 Container Manager
  2. 设置 → 项目位置 → 选择其他存储池

或者用命令行(更彻底):

# 停 Docker
sudo synopkg stop ContainerManager

# 迁移数据
sudo mv /volume1/@docker /volume2/@docker
sudo ln -s /volume2/@docker /volume1/@docker

# 启动
sudo synopkg start ContainerManager

三、端口问题

现象:容器跑起来了,但浏览器打不开

先查这几件事:

# 1. 容器是否在运行
docker ps

# 2. 端口映射是否正确
docker port <容器名>

# 3. 宿主机能否访问
curl -I http://127.0.0.1:<端口>

# 4. 从别的机器能否访问
curl -I http://<群晖IP>:<端口>

群晖占用的端口(别撞车)

端口 服务
5000 / 5001 DSM Web
5005 / 5006 DSM Web(HTTPS 备用)
7000-7009 DSM 内部服务
80 / 443 Web Station(如果装了)
3306 MariaDB(如果装了)
5432 PostgreSQL(如果装了)

解决:换宿主机端口,比如把容器的 80 映射到宿主机的 8080:

-p 8080:80

现象:容器内服务只能本机访问

原因:服务默认绑定 127.0.0.1,而不是 0.0.0.0。

解决:在容器配置里改绑定地址,或者检查镜像的环境变量。

比如 Jellyfin:

# 默认就绑定 0.0.0.0,一般没问题
# 但如果自定义了配置,检查
docker exec -it jellyfin cat /config/network.xml

四、网络问题

场景 1:需要固定 IP

群晖的 Docker 支持自定义网络:

# 创建网络
docker network create \
  --driver bridge \
  --subnet 172.20.0.0/16 \
  --gateway 172.20.0.1 \
  mynet

# 指定 IP 启动容器
docker run -d \
  --network mynet \
  --ip 172.20.0.10 \
  --name myservice \
  myimage:latest

场景 2:容器需要访问宿主机服务

容器内访问宿主机,用 host.docker.internal(群晖 7.2+ 支持):

docker run -d \
  --add-host host.docker.internal:host-gateway \
  myimage:latest

容器内就能用 host.docker.internal:8080 访问宿主机。

场景 3:DNS 解析失败

容器内 ping baidu.com 失败,但宿主机正常。

原因:容器的 DNS 配置没继承宿主机的。

解决:

docker run -d \
  --dns 223.5.5.5 \
  --dns 119.29.29.29 \
  myimage:latest

或者全局配置:

sudo tee /etc/docker/daemon.json << 'EOF'
{
  "dns": ["223.5.5.5", "119.29.29.29"]
}
EOF
sudo synopkg restart ContainerManager

场景 4:想用 host 网络模式

群晖的 Docker 支持 host 网络,但图形界面里看不到这个选项。

命令行:

docker run -d \
  --network host \
  --name adguardhome \
  adguard/adguardhome:latest

注意:host 模式下端口映射参数 -p 无效,服务直接监听宿主机端口。

五、实战:一次完整部署

以部署 Vaultwarden(密码管理器)为例,走一遍完整流程。

1. 准备目录

sudo mkdir -p /volume1/docker/vaultwarden/data
sudo chown -R 1026:100 /volume1/docker/vaultwarden

2. 生成 admin token

# Vaultwarden 的 admin token 需要 argon2 哈希
docker run --rm -it vaultwarden/server /vaultwarden hash
# 输入密码,得到一串哈希,复制下来

3. 启动容器

docker run -d \
  --name vaultwarden \
  --restart unless-stopped \
  -p 8080:80 \
  -v /volume1/docker/vaultwarden/data:/data \
  -e ADMIN_TOKEN='$argon2id$v=19$m=65540,t=3,p=4$...' \
  -e SIGNUPS_ALLOWED=false \
  -e DOMAIN='https://vault.example.com' \
  vaultwarden/server:latest

4. 验证

# 容器状态
docker ps | grep vaultwarden

# 端口
curl -I http://127.0.0.1:8080

# 日志
docker logs --tail 30 vaultwarden

5. 配置反向代理(群晖自带)

DSM → 控制面板 → 登录门户 → 高级 → 反向代理服务器:

项 值
来源协议 HTTPS
来源主机名 vault.example.com
来源端口 443
目标协议 HTTP
目标主机名 localhost
目标端口 8080

然后申请 Let’s Encrypt 证书(控制面板 → 安全性 → 证书)。

六、常用命令速查

# 查看所有容器(含已停止)
docker ps -a

# 查看容器日志(最后 100 行,实时)
docker logs -f --tail 100 <容器名>

# 进入容器
docker exec -it <容器名> sh

# 查看容器资源占用
docker stats

# 清理无用镜像/容器/卷
docker system prune -a --volumes

# 查看容器详细信息
docker inspect <容器名> | jq '.[0].NetworkSettings'

# 导出/导入镜像(离线迁移)
docker save -o app.tar myimage:latest
docker load -i app.tar

一句话总结

群晖上跑 Docker,90% 的问题都在这四类:

  1. 权限 → 用 PUID=1026 PGID=100
  2. 路径 → 用 /volume1/ 绝对路径
  3. 端口 → 避开 DSM 占用的 5000/5001
  4. 网络 → 需要固定 IP 就建自定义网络

记住这四条,剩下的就是查日志。