# 链接规则

## 软链接设置

本教程将指导你快速完成软链接的相关设置

### 前言

为了让 Plex / Emby / Jellyfin 等媒体库管理工具 (以下用 Plex 指代) 拥有更好的刮削效果，同时也为了PT网站的正常保种，通常会选择链接的方式创建一个专供媒体库管理工具刮削的资源及文件夹结构。链接的方式有很多，较常见的为硬链接及软链接。Vertex使用的为软链接，软链接可以跨硬盘进行资源的链接，为便于理解，可以简单地将软链接理解为Windows的快捷方式。源文件删除，软链接无法使用，对软链接的任何修改包括删除都不影响源文件。

### 准备工作

* 能够通过SSH方式远程登录的设备，需在“下载服务-服务器”中添加该设备；
* 将源文件所在文件夹挂载给媒体库管理工具，保证媒体库管理工具能够正常访问源文件。

### 添加链接规则

**路径：“追光迷影-链接规则”**

1. 别名：取一个顺眼的名字；
2. 服务器：选择准备工作中添加的服务器；
3. 链接目标目录替换：重点内容，见下方对应标题；
4. 生成链接文件目录：重点内容，见下方对应标题；
5. 其余内容请根据自己需求进行设置；
6. 新增完成。

## 链接目标目录替换

### 软链接

**替换目的：将文件在下载器容器内的路径转换为在 Plex 容器内的路径。**

举个栗子： 假设我们将 **/mnt/disk/** 挂载为qBittorrent的 **/Downloads/** 同时将 **/mnt/disk/** 挂载为媒体库管理工具的 **/影视资源/**

此时，我们用 qBittorrent 下载了一个文件 **境界的彼方-过去篇.mp4** 保存至 **/Downloads/番剧/**

* 在 qBittorrent 中，该资源的路径为 **/Downloads/番剧/境界的彼方/境界的彼方-过去篇.mp4**
* 在 Plex 中该资源的路径为 **/影视资源/番剧/境界的彼方/境界的彼方-过去篇.mp4**

很容易发现 qBittorrent 与 Plex 的路径, 不同的地方就是 **Downloads** 和 **影视资源**

> 此时，链接目标目录替换规则就应该填写：**Downloads##影视资源** 这也是写出替换规则最简单的办法, 找出一个文件, 分别列出这个文件在 Plex 容器与 qBittorrent 容器中的目录, 然后找出不同的地方 {.is-success}

### 硬链接

**替换目的：将文件在下载器容器内的路径转换为在执行硬链接的环境内的路径。**

若服务器连接的是群晖 / UNRAID 等宿主机 填写规则为 **下载器路径##宿主机实际路径**

若服务器连接的是宿主机内的其它虚拟机 填写规则为 **下载器路径##文件在虚拟机内的目录**

## 生成链接文件目录

**即软链接文件存放的目录**

该存放目录应当为**宿主机的真实路径**，即你要将软链接文件存放在宿主机的哪个位置。 接上个栗子： 可以看出来栗子里我们的宿主机真实路径是 **/mnt/disk/** 为了便于管理，我在宿主机中新建了一个文件夹 **/软链接/** 用于存放软链接

> 此时，生成链接文件目录就应该填写：**/mnt/disk/软链接/** {.is-success}

## 最后

以上配置全部完成之后，记得将宿主机的 **/mnt/disk/软链接/** 路径挂载给 Plex，**源文件所在位置的挂载目录也不能删除**，因为 Plex 需要根据软链接去寻找真实文件路径，如果将源文件挂载删除将导致视频无法播放。

***

PS： 为了方便管理我想对软链接文件做分类怎么办？ 类似这种： /mnt/disk/软链接/国产剧/ /mnt/disk/软链接/国产电影/ /mnt/disk/软链接/欧美电影/ ······

**方法：**

“追光迷影-豆瓣任务-编辑-分类”中的**资料库路径**添加对应的分类即可，可通过新建多个分类设置项进行软链接文件的分类存放。 详细设置请查看追剧 -> 配置流程 -> 添加豆瓣账号 -> 分类 -> 资料库路径。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.vertex-app.top/zhu-yao-mo-kuai/lian-jie-gui-ze.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
