交流群

telegram: https://t.me/autosymlink_channel

简易文档

https://github.com/shenxianmq/AutoSymlink-Readme/tree/main

Auto_Symlink

如果你觉得这个项目对你有帮助，可以考虑赞助我。你的支持将有助于这个项目的持续发展和改进🙏

微信:

支付宝:

小白牙整理

项目简介

Auto_Symlink 是一个自动化工具，专门设计用于管理通过 CloudDrive2/Alist 挂载到本地的网盘。它能够创建软链接，使得像 Emby/Jellyfin/Plex 这样的媒体服务器能够更容易地刮削和读取内容，同时减少对网盘的频繁访问。

主要特性:

• 实时监控: 需要CloudDrive2的会员功能文件通知,监控指定目录，自动进行必要的更新和管理。
• 自动化处理: 创建与更新软链接/strm文件，自动复制与更新元数据。
• 清理功能: 清空无效文件夹和软链接，保持本地云端一致性。
• 转存监控: 在常用工具中，自动监控指定文件夹，转移到目标文件夹，并删除源文件
• 媒体库通知: 支持Emby/Plex通知，当检测到新视频的时候，会自动通知Emby/Plex扫描该视频，极大加块扫库速度
• 封面制作: 自动生成精美的Emby媒体库封面
• Web 界面操作: 提供一个简洁易用的Web界面，用于查看日志、编辑配置和监控系统状态。这使得用户能够更方便地管理和调整 Auto_Symlink 的运行。 更多功能可以去常用工具中自行发掘.

更新记录

v2.1.3 更新（2024-03-28）

• 添加strm本地模式，使用的时候要将对应路径的完整路径映射到emby中
• 转存监控：自动监控源目录文件夹，转移文件到目标文件夹，并删除源文件夹中的文件，适合想要自动把阿里云的资源转存到115网盘的情况
• emby封面制作：自动生成emby封面，支持gif格式

v2.1.2 更新（2024-01-25）

• 添加同步时排除指定文件夹的功能

v2.1.1 更新（2024-01-20）

• 添加字幕提取与转换的功能

v2.0.6 更新（2024-01-03）

• 引入了两种更新元数据的模式：下载模式和复制模式。下载模式的速度大约是复制模式的两倍。用户需要在目录配置中设置cd2地址和cd2挂载根目录。如果需要从本地上传数据到云端，只能使用复制模式。

v2.0.5 更新（2023-12-30）

• 新增了在主界面上下拖动排序的功能，用户可以根据需要调整顺序，系统会保存用户调整后的顺序。

v2.0.3 更新（2023-12-29）

• 修复了用户无法登录以及通知无法修改的问题。

v2.0.2 更新（2023-12-28）

• 支持扫描完成后推送Telegram和Bark的功能。

v2.0 GUI版（2023-12-27）

• 新功能: 引入了图形用户界面（GUI），提供了一个更直观、易用的操作界面。
• Web 界面: 新增了Web界面，允许用户通过浏览器访问来管理配置、查看日志和监控系统状态。
• 改进: 对用户交互进行了优化，现在用户可以更方便地进行配置和管理。
• 插件: 新增了手动同步、手动备份、恢复备份、通知工具、Emby通知、刷新媒体库、清除空文件夹、115cookie等常用工具。

v1.0 非GUI版（2023-11-29）

• 核心功能: 实现了 Auto_Symlink 的基础功能，包括创建软链接、监控指定目录、自动更新和管理软链接/strm文件。
• 实时监控: 加入了实时监控功能，能够自动检测文件夹变化并进行必要的同步操作。
• 自动化处理: 自动化创建和更新软链接及元数据，减少了对网盘的频繁访问。
• 配置文件管理: 提供了 config.yaml 配置文件，允许用户根据需要进行详细配置。
• 兼容性: 支持 Docker 容器运行，方便在不同系统环境中部署和使用。

安装和使用

1. 直接运行 Python 文件:

   • 在首次运行后，config 文件夹中会生成 config.yaml 文件。根据文件中的注释进行配置。
   • 配置完成后，使用命令 python auto_symlink.py 运行。
   • 在 Windows 系统中，需要以管理员模式运行。

2. Docker 运行: 使用以下命令运行 Docker 容器：

   docker run -d \
    --name auto_symlink \
    -e TZ=Asia/Shanghai \
    -v /volume1/CloudNAS:/volume1/CloudNAS:rslave \
    -v /volume2/Media:/Media \
    -v /volume1/docker/auto_symlink/config:/app/config \
    -p 8095:8095 \
    --user 0:0 \
    --restart unless-stopped \
    shenxianmq/auto_symlink:latest

   注意：映射网盘路径时必须使用绝对路径。

Docker 运行指令详解

• -v /your/cloud/path:/cloudpath:rslave: 将你的云盘路径（/your/cloud/path）映射到容器内的路径（/your/cloud/path）。rslave 表示使用相对于宿主机的从属挂载模式。请确保左右路径保持一致，否则生成的软链接不是指向真实路径，导入emby中的时候会导致无法观看。（简单的来说，这里需要填写你映射的云盘路径，且两边都填写一模一样的路径即可。）
• -v /your/media/path:/media: 将你即将创建软连接的位置映射到容器内的 /media 目录。
• -p 8095:8095: 映射8095端口，可方便的查看日志以及管理服务。
• -v /path/to/auto_symlink/config:/app/config: 将 auto_symlink 的配置目录映射到容器内的 /app/config。这样可以使容器中的 auto_symlink 使用外部的配置文件。
• --restart unless-stopped: 设置容器在退出时自动重启。

注意：

• 映射云盘路径时必须使用绝对路径（虽然此处是本工具的docker运行说明，但EMBY也应使用同样的绝对路径，否则软连接将指向错误的位置，从而导致无法播放），以确保软连接可以正确指向原始文件或目录。
• 根据你的实际路径和需求调整 -v 选项中的路径。

• 群晖请使用控制台创建docker，因为群晖的Docker GUI界面无法选择rslave模式

  Web 界面访问和账户信息

账号密码

• 默认账号：admin
• 默认密码：password

在首次登录时，你可以使用这些凭据进行登录。为了安全起见，建议登录后立即更改密码。

Web界面说明

通过映射端口8095，用户可以方便地访问 Auto_Symlink 的Web界面。在任何支持的浏览器中输入 http://[你的服务器地址]:8095 即可访问。

常见问题解答 (FAQ)

Q: auto_symlink 在什么情况下特别有用？

答: 当你正在使用CloudDrive2/Alist等工具管理媒体，并使用EMBY/Jellyfin等工具来管理这些媒体时，本工具将大大降低媒体刮削时访问网盘的频率。

Q: EMBY显示当前没有兼容的流

答: 请确保你EMBY映射的也是绝对路径，需要与 auto_symlink设置的路径保持一致。

Q: 虽然我有元数据，但EMBY扫库还是很慢？

答: 因为我们映射了所有影片的软连接，所以可以尝试先禁用EMBY的FFmpeg进程，CloudDrive2可以在设置黑名单添加/bin/ffprobe，扫库完成后，再删除该黑名单即可。

Q: 我映射后为什么不能在windows下播放？

答: 映射的软连接仅支持绝对路径，windows下的绝对路径肯定与linux不一致，所以请在EMBY内验证。

Q: 为什么运行完毕后，只同步了文件夹？

答: 群晖File Station或部分工具不支持显示软连接，可以尝试用windows或者命令行查看。

Q: 群晖创建容器rslave报错

答: 在群晖的任务计划中添加开机任务：

mount --make-shared /volume1/

mount --make-shared /volume2/

systemctl daemon-reload 添加后手动运行一次，之后开机会自动运行