影音与下载

Auto Symlink:生成 STRM 与媒体路径映射

  • 0 次阅读
  • 0 条评论
文章摘要

Auto Symlink 面向 CloudDrive2、Alist 等挂载目录,创建和更新软链接或 STRM,并可配合元数据复制、媒体库通知与目录监控组织网盘媒体。它提供网页配置和日志入口,适合把原文件与媒体库读取入口分开管理。

项目介绍

Auto Symlink 可用于媒体文件链接和 STRM 等相关整理任务。下面介绍容器配置、群晖目录映射、启动和首次检查。应先用测试目录确认输出路径,避免将目标目录再次纳入扫描造成循环处理。

services:

  auto_symlink:
    image: shenxianmq/auto_symlink:latest
    container_name: auto_symlink
    restart: unless-stopped
    user: 0:0
    network_mode: bridge
    ports:
      - "8095:8095"
    environment:
      - TZ=Asia/Shanghai
    volumes:
      - /volume1/docker/as/config:/app/config
      - /volume1/CloudNAS:/CloudNAS:rslave
      - /volume1/strm:/strm

补充:部署与使用

配置与操作示例

Compose 部署

以下按上游示例保留所需运行身份与挂载传播;输入路径在生成工具和媒体服务中应保持一致:

群晖目录准备

在群晖 SSH 终端执行下面这一段,再将下方配置保存为 /volume1/docker/auto-symlink/compose.yaml。也可在 Container Manager 中新建项目,选择该目录并粘贴配置。

sudo sh <<'HALO_PREPARE'
set -eu
mkdir -p /volume1/docker/auto-symlink /volume1/docker/auto-symlink/config /volume1/media-links
cd /volume1/docker/auto-symlink
HALO_PREPARE
cd /volume1/docker/auto-symlink

本示例使用数值 0 访问挂载目录,无需查询或填写 UID/GID。

services:
  auto-symlink:
    image: shenxianmq/auto_symlink:latest
    user: "0:0"
    environment:
      TZ: Asia/Shanghai
    ports:
      - "8095:8095"
    volumes:
      - /volume1/CloudNAS:/volume1/CloudNAS:rslave
      - /volume1/media-links:/Media
      - /volume1/docker/auto-symlink/config:/app/config
    restart: unless-stopped

/volume1/CloudNAS 需替换成已正常挂载的网盘路径;/Media 是输出目录,二者不能相同。上游示例使用 root 身份,因此挂载范围应只包含实际需要的数据。启动后访问 http://NAS_IP:8095,按当前 README 处理初始凭据并立即改密。

先生成一份软链接,检查链接指向的绝对路径,确认 Emby 容器也能按同一路径读取原件。STRM 则检查文件保存的访问地址。实时通知对 CloudDrive2 版本和会员能力有要求;不需要该功能时先手动运行验证,不为解决挂载问题将整个卷随意改为全局共享传播。

启动与状态检查

在保存 compose.yaml 和所需 .env 的项目目录执行:

docker compose config --quiet
docker compose up -d
docker compose ps
docker compose logs --tail=100

config 用于检查配置,不会启动服务。示例使用上游浮动发行通道;长期运行可改为项目实际发布的固定标签或已记录的镜像摘要,不猜写版本号。日志中出现的初始密码和访问凭据仅在自己的终端查看。

常见问题

  • 容器看到空目录:先检查挂载传播与授权状态,不立即认定源文件已删除。

  • 索引、软链接和 STRM 都不能替代原文件备份,应用重建前保存规则与输出结构。

更新与备份

保存配置、映射规则和必要输出清单,媒体原件及挂载凭据独立备份。

更新前记录当前镜像或仓库提交,停止会写入的任务并备份持久化数据;阅读版本迁移说明后再拉取并重建。数据库已经迁移时,回退还需要匹配的数据副本。需要暂时停服务可用 docker compose stop,不要把删除卷或清空数据目录当作更新步骤。

官方资料