项目介绍
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,不要把删除卷或清空数据目录当作更新步骤。