群晖 Docker 部署避坑指南:权限、路径、端口、网络四类问题
群晖的 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+):
- 打开 Container Manager
- 设置 → 项目位置 → 选择其他存储池
或者用命令行(更彻底):
# 停 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% 的问题都在这四类:
- 权限 → 用
PUID=1026PGID=100 - 路径 → 用
/volume1/绝对路径 - 端口 → 避开 DSM 占用的 5000/5001
- 网络 → 需要固定 IP 就建自定义网络
记住这四条,剩下的就是查日志。
分享到微信
在微信里打开这篇文章,点右上角「···」→「分享到朋友」
手机扫码打开
加载中…