PanSave 是一套独立部署的影视资源自动化管理系统。
它连接 115 网盘、123 云盘、本地媒体目录、Telegram、影视榜单与 Emby，覆盖资源发现、订阅追更、转存、识别整理、版本管理、STRM 生成和播放维护等环节，帮助用户建立完整的个人影视资源自动化工作流。
本仓库用于维护 PanSave 的产品介绍和使用文档，不提供应用源代码。
频道 / 榜单 / 豆瓣片单 / 手动提交 -> 网盘转存或分享 STRM 保存
网盘文件 / 本地 STRM / 本地媒体 -> 识别整理 -> 分类命名与版本选择
网盘媒体库 -> STRM 同步 -> Emby 入库与播放
Emby 缺集扫描 -> 加入监控 -> 持续补找
各条流程可按需组合。本地媒体文件可以直接交给 Emby 建库，不需要先转存到网盘。
- 支持 115 网盘和 123 云盘，每种网盘可配置多个账号
- 按业务分别选择网盘账号、处理方式和目标目录
- 支持多个 Telegram 机器人、TMDB 和 Emby 配置
- 扫描 Telegram 频道历史消息，按关键词和屏蔽词筛选，确认结果后执行处理
- 支持 Telegram API 模式和公开频道网页模式
- 持续监控频道新消息，订阅猫眼、豆瓣和 TMDB 榜单
- 通过 TMDB 看板加入自定义监控，查看入库状态、缺集情况和处理历史
- 为多个求片用户同步豆瓣片单，先检查 Emby，再搜索和处理所需资源
- 支持管理员提醒和求片用户邮件通知
- 扫描 Emby 媒体库中已入库剧集的缺集情况
- 将缺集条目加入监控，后续继续补找
- 通过机器人提交分享链接、秒传内容和支持的 STRM 文件或压缩包
- 按可用能力选择网盘转存或分享 STRM 保存，并选择目标目录
- 支持 115 分享转存到 115，或通过 SHA1 秒传到 123 云盘
- 支持 115 ED2K、磁力离线下载，查看处理结果和失败原因
- 识别电影、剧集、年份和季集信息，通过 TMDB 确认媒体身份
- 可选接入 AI 辅助标题纠错，帮助处理常规识别未命中的资源
- 按文件目录策略重命名、分类存放，并处理关联字幕
- 支持网盘文件、PanSave 本地 STRM 和本地媒体文件整理
- 支持手动、定时及已配置的转存联动整理，查看识别预览、整理记录和待复核结果
- 按画质、来源、编码等规格设置版本偏好
- 支持懒人规则、自定义策略、特殊组合和多版本保留
- 比较新资源与媒体库已有版本，按规则保留或替换
- 不同媒体分类可使用独立的版本策略，并通过试运行查看选择结果
- 支持 PT / BT 下载目录硬链接入池，整理时保留原下载路径
- 支持监听新增文件，并手动初始化已有文件的硬链接
- 支持本地文件移动整理，复用媒体识别、目录和版本策略
- 硬链接场景需将相关目录的共同父目录一次性挂载到容器
- 为 115、123 网盘媒体库生成 STRM，支持手动增量、定时同步和实时监控
- 按配置处理字幕与已有元数据文件，并与整理后的目录变更联动
- 支持将 123 分享、123 秒传、115 分享和 ED2K 等来源按可用能力生成 STRM
- 支持迁移已有 PanSave STRM 的地址和账号，以及通过字段映射转换支持的其他 STRM 格式
- 按配置联动 STRM 更新与 Emby 媒体库刷新
- 提供内置 Emby 反代，符合条件的播放和下载请求使用 302 直链
- 可按 Emby 用户绑定独立的 115、123 播放账号
- 对经过反代且可识别设备与媒体的 115 直链播放，支持自动同播管理
- 转码请求继续交给 Emby 处理
- 在同一界面浏览本地、115 和 123 文件，执行重命名、移动、复制等操作
- 支持单链接、批量链接、秒传内容和支持的 STRM 输入，查看转存任务与逐项结果
- 支持 123 秒传导出、本地 STRM 转存网盘和本地 STRM 生成
- 按规则处理 115 本地 STRM 的小号分享，支持白名单、输出方式和处理历史
- 按网盘账号设置目录定时清理和回收站清理
- 查看系统日志、整理记录和各类任务处理历史
- 通过 Telegram 机器人或邮件接收已配置的任务结果与异常提醒
- 及时发现账号失效、目录缺失、容量不足和任务阻断等问题
分享 STRM 的生成与播放取决于来源有效性、网盘账号和已启用的处理能力；部分来源需要临时转存、秒传或离线下载，并非所有链接都能直接播放。
- 用网盘管理影视资源，希望把获取、整理、入库和播放接起来
- 用榜单或豆瓣片单追更，希望自动跟踪入库状态和缺集
- 用 PT / BT 下载到本地，希望保留下载路径并整理出清晰的媒体库
- 已经有 STRM 媒体库，需要持续同步、迁移地址或维护分享来源
- 使用多个 Emby 服务或多个网盘账号，希望按不同用途分别配置
PanSave 为新用户提供 30 天试用授权：
- 加入 PanSave Telegram 使用交流群
- 根据群内欢迎消息进入官方机器人私聊
- 点击领取试用按钮，或向机器人发送
/trial - 获取试用授权码后，在 PanSave 授权设置页完成激活
同一 Telegram 用户只能领取一次试用授权。试用相关问题可在群内反馈。
如果 PanSave 对你有所帮助，欢迎通过捐助支持项目持续维护与迭代。完成捐助后，可获得一枚 PanSave 永久授权码。
推荐使用 Docker Compose 部署。PanSave 默认监听 16868 端口，示例使用 host 网络：
services:
pansave:
image: pinyht/pansave:latest
container_name: pansave
restart: unless-stopped
network_mode: host
stop_grace_period: 15m
environment:
TZ: Asia/Shanghai
volumes:
- ./data:/app/data
- ./strm:/strm将以上内容保存为 docker-compose.yml，然后启动：
docker compose up -d启动后访问：
http://localhost:16868
部署在服务器或 NAS 上时，请将 localhost 替换为设备 IP 或域名。
host 网络下不需要配置 ports 映射。应用会直接监听宿主机的 16868 端口；如需修改端口，可增加 APP_ADDR 环境变量：
environment:
TZ: Asia/Shanghai
APP_ADDR: ":16869"请务必保留以下目录挂载：
volumes:
- ./data:/app/data
- ./strm:/strmdata用于持久化数据库、后台登录密钥、Telegram 会话和系统日志等运行数据strm用于保存 STRM 生成结果，规则输出目录可选择/strm或其子目录
data 必须挂载到 Docker 宿主机可靠的本地文件系统，例如 ext4、btrfs 或 xfs。不要将 app.db 直接放在 SMB、NFS 等网络共享目录。
PanSave 主数据库使用 SQLite WAL，运行时可能长期存在 app.db-wal 和 app.db-shm。迁移设备或重建容器时，最安全的方式是先停止容器，再整体备份和迁移 data 目录。在线备份必须使用 SQLite backup API、sqlite3 .backup 等一致性备份方式，不能只复制活动中的 app.db 文件。
首次启动且未显式配置 APP_SECRET 时，PanSave 会在 data/app_secret 自动生成后台登录 Cookie 签名密钥。请将它与 data/app.db 一起持久化，否则重建容器后原有登录状态会失效。
使用本地媒体整理时，还需要挂载存放媒体的目录。硬链接模式应把真实媒体、待整理、整理目标和待复核目录放在同一挂载点下，例如将共同父目录 /host/media 一次性挂载到容器 /media，再在规则中选择其下互不包含的子目录。分别挂载多个子目录会导致跨挂载点硬链接失败。
默认后台账号：
用户名：admin
密码：password
首次登录后，请立即在右上角的“账号设置”中修改用户名或密码。
如果尚未配置授权，登录后会先进入授权设置页。完成授权后，再继续配置 Telegram、网盘、TMDB 和 Emby。
- 登录后台、完成授权，并修改默认管理员账号或密码
- 按需要添加网盘账号，或挂载本地媒体目录
- 使用资源获取时，配置转存策略、Telegram 频道和需要的搜索来源
- 配置 TMDB 和 Emby；需要 AI 辅助识别时再配置 AI 服务
- 按需要启用频道扫描、榜单订阅、豆瓣求片或缺集监控
- 设置文件目录策略、版本策略和整理策略，先预览识别结果，再执行整理
- 按需要配置 STRM 生成、Emby 反代和用户播放账号
- 配置邮件或内置机器人通知，通过任务记录和日志确认处理结果
- 官方网站及帮助文档：https://www.pansave.com
- Telegram 使用交流群：https://t.me/pansavechat
- 捐助与永久授权：https://www.pansave.com/donate
PanSave 是闭源软件。本仓库公开的文档、截图和品牌素材不代表应用源代码以开源许可证授权。
- PanSave 是一个自动化管理工具，用于对接 Telegram、网盘账号、Emby 等已有服务，帮助用户管理自己的自动化流程
- PanSave 不提供、不存储、不分发任何影视资源，也不内置资源内容
- 用户应确保自己的使用行为符合所在地法律法规，以及相关平台和服务提供方的使用条款
- 任何因使用 PanSave 处理第三方内容、链接、频道或媒体资源而产生的版权、合规或平台责任，均由使用者自行承担