Docker 下载
推荐在 NAS 的 SSH 终端执行通过 SSH 登录 NAS 后,粘贴下方命令并按回车。
docker pull docker.io/4xvr/4xlink-nas:2.0.3
自动选择适合 NAS 的 x86-64 / ARM64 版本。
也可在 NAS 的 Docker 应用中搜索 4xvr/4xlink-nas,选择标签 2.0.3 下载。
你的 NAS 已安装 Docker(群晖中称为 Container Manager,威联通中称为 Container Station)。
任选一种方式获取镜像。
在 NAS 的 SSH 终端执行通过 SSH 登录 NAS 后,粘贴下方命令并按回车。
docker pull docker.io/4xvr/4xlink-nas:2.0.3
自动选择适合 NAS 的 x86-64 / ARM64 版本。
也可在 NAS 的 Docker 应用中搜索 4xvr/4xlink-nas,选择标签 2.0.3 下载。
下载后,在 NAS 的“镜像 / 映像”页面导入,无需解压。
在本地镜像中选择 4xvr/4xlink-nas:2.0.3 创建容器,设置以下三项。
选择“host / 主机网络”。
配置目录 → /data(读写)。
视频目录 → /shared/video(只读)。
services:
4xlink-nas:
image: 4xvr/4xlink-nas:2.0.3
pull_policy: never
container_name: 4xlink-nas
restart: unless-stopped
network_mode: host
environment:
# 18080 被占用时可以改为其他端口
NAS_WEB_PORT: "18080"
NAS_BROWSE_ROOT: "/shared"
volumes:
# 4XLink 数据目录,读写
- /path/to/4xlink-data:/data
# NAS 视频目录,只读
- /path/to/videos:/shared/video:ro
# USB 外接硬盘,可选,只读
- /path/to/usb-drive:/shared/usb:ro
stop_grace_period: 30s
威联通、绿联按品牌添加以下映射:NAS 父目录 → 容器目录。
/share/external/shared/external
- /share/external:/shared/external:ro,rslave
/mnt/@usb/shared/external
- /mnt/@usb:/shared/external:ro,rslave
图形界面设为“只读 + rslave”;没有挂载传播选项时使用 Compose。
Compose:在 volumes: 下用对应条目替换 USB 挂载,保留 /data 和视频目录。重新创建容器后,开启 4XLink 的“自动添加”。
/mnt/@usb/sdc1 只对应一块盘;热插拔需映射父目录 /mnt/@usb,不要固定到 sdc1。修改后重新创建容器,不是仅重启。
此配置让 4XLink 可访问该父目录下的所有外接盘。NAS 识别、挂载新盘且挂载传播可用后,2.0.3 可按已有自动添加设置添加新盘、撤下已拔盘;曾关闭或排除的记录不会被强行恢复。已在威联通、绿联测试环境验证,具体支持以型号与系统为准。
源目录必须已存在,NAS 需支持挂载传播;报错时不要改成特权模式或自行修改系统挂载。群晖不能直接套用这两行,使用单盘手动映射。通过 NAS 安全弹出;提示占用时先停止播放或容器,勿强拔。
ro 不保证旧内核上的所有子挂载都只读。 Docker 挂载说明
保存并启动容器。
将 NAS-IP 换成你的 NAS 局域网 IP。
点击“添加文件夹”,选择 /shared/video,即可共享视频。
172. 开头的容器地址;如果修改了 NAS_WEB_PORT,浏览器地址也要使用新端口。host,并确保眼镜与 NAS 连接同一个局域网。/shared/video。NAS_WEB_PORT 设为空闲端口(如 18081),并使用相同的网址端口。手动添加单块 USB 硬盘时,把它的实际路径挂载到 /shared/usb。常见路径如下;威联通、绿联的热插拔映射已列在第二步“创建容器”中。
/volumeUSB1/usbshare1-1
/tmp/mountd/disk1_part1
实际路径以你的 NAS 为准。在容器的存储空间中新增一项:
USB 实际路径 → /shared/usb,权限选择“只读”。挂载配置变化后需要重新创建容器,仅重启不会应用新的挂载。之后在 4XLink 中进入 /shared/usb 添加文件夹。多块盘使用不同的容器路径。安全弹出前停止播放并停止使用该盘的容器;重新接入后确认映射有效再启动。群晖基础 Docker 部署不保证自动热插拔,不需要运行 SSH 助手。
把 NAS 文件夹挂载到容器的 /shared/video、/shared/usb 等路径,而不是 /docker 或 /usbdisk。多个目录使用不同的容器路径。同名共享会自动区分名称;群晖 @eaDir 缩略图目录不会作为媒体目录列出。只选择需要的视频文件夹,不要共享整个系统盘或应用配置目录。
先备份配置并停止旧容器,保留原来的 /data 和媒体挂载,更新镜像后重新创建容器。不要删除数据卷,也不要为了升级改用新的数据目录。管理页面仅用于可信局域网,不要直接开放到公网。