4XLink 4XLink for NAS 快速安装
快速安装指南

三步完成安装

开始前需确认:

你的 NAS 已安装 Docker(群晖中称为 Container Manager,威联通中称为 Container Station)。

步骤 01

下载 4XLink

任选一种方式获取镜像。

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 下载。

步骤 02

创建容器

在本地镜像中选择 4xvr/4xlink-nas:2.0.3 创建容器,设置以下三项。

  1. 1 网络设为 host

    选择“host / 主机网络”。

  2. 2 添加数据目录

    配置目录 → /data(读写)。

  3. 3 添加视频目录

    视频目录 → /shared/video(只读)。

使用 Compose?

外接硬盘热插拔(可选)

威联通、绿联按品牌添加以下映射:NAS 父目录 → 容器目录。

威联通 QNAP

/share/external/shared/external

- /share/external:/shared/external:ro,rslave

绿联 UGREEN

/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 挂载说明

保存并启动容器。

步骤 03

打开 4XLink

将 NAS-IP 换成你的 NAS 局域网 IP。

http://NAS-IP:18080

点击“添加文件夹”,选择 /shared/video,即可共享视频。

遇到问题?
如何添加 USB 外接硬盘?

手动添加单块 USB 硬盘时,把它的实际路径挂载到 /shared/usb。常见路径如下;威联通、绿联的热插拔映射已列在第二步“创建容器”中。

群晖 Synology /volumeUSB1/usbshare1-1
OpenWrt /tmp/mountd/disk1_part1

实际路径以你的 NAS 为准。在容器的存储空间中新增一项:

USB 实际路径 → /shared/usb,权限选择“只读”。

挂载配置变化后需要重新创建容器,仅重启不会应用新的挂载。之后在 4XLink 中进入 /shared/usb 添加文件夹。多块盘使用不同的容器路径。安全弹出前停止播放并停止使用该盘的容器;重新接入后确认映射有效再启动。群晖基础 Docker 部署不保证自动热插拔,不需要运行 SSH 助手。

添加文件夹时看不到目录,或名称相同?

把 NAS 文件夹挂载到容器的 /shared/video、/shared/usb 等路径,而不是 /docker 或 /usbdisk。多个目录使用不同的容器路径。同名共享会自动区分名称;群晖 @eaDir 缩略图目录不会作为媒体目录列出。只选择需要的视频文件夹,不要共享整个系统盘或应用配置目录。

如何升级?

先备份配置并停止旧容器,保留原来的 /data 和媒体挂载,更新镜像后重新创建容器。不要删除数据卷,也不要为了升级改用新的数据目录。管理页面仅用于可信局域网,不要直接开放到公网。