快速开始
这篇按“第一次部署后怎么用”来写。你不需要一次性配置所有功能，可以按自己的使用场景选择频道扫描、榜单订阅、豆瓣求片或 Emby 缺集扫描。
1. 启动服务
推荐使用 Docker Compose。先在你准备部署 PanSave 的目录里创建 docker-compose.yml：
services:
pansave:
image: pinyht/pansave:latest # PanSave 镜像，默认使用 latest 版本
container_name: pansave # 创建后的容器名固定为 pansave
restart: unless-stopped # 容器异常退出自动重启；手动停止后不会自动拉起
network_mode: host # 使用宿主机网络；应用会直接监听宿主机 16868 端口
stop_grace_period: 15m # 停止容器时最多等待 15 分钟，让已开始的后台任务自然终止
environment: # 容器环境变量
TZ: Asia/Shanghai # 容器时区；建议保持北京时间，保证日志和页面时间一致
volumes: # 数据持久化挂载
- ./data:/app/data # 持久化数据库、登录密钥、Telegram 会话、系统日志等运行数据然后在同一目录执行：
docker compose up -d启动后默认访问：
http://localhost:16868如果部署在 NAS 或服务器上，把 localhost 换成那台机器的 IP 或域名。
更多端口、数据备份、更新和非 host 网络部署说明，见 Docker 部署。
2. 登录系统
首次登录账号：
用户名：admin
密码：password登录后建议立即在右上角“账号设置”里修改用户名或密码。
3. 填写授权码
首次进入系统时，如果还没有授权，系统会先进入“授权设置”。填写授权码并保存后，侧边栏版本号旁会显示“已激活”。
授权只是允许系统正常运行，不会替你配置 Telegram、网盘或 Emby。
授权码的获取和填写方式见 授权码使用。
4. 配置网盘账号
进入“系统配置 / 网盘配置”，添加 123 云盘或 115 网盘账号。
然后进入“资源获取 / 转存策略”，为每个要使用的网盘添加转存目录，并选择一个“整理源目录”。后续自动转存都会优先使用这个目录。
5. 配置 Telegram
进入“系统配置 / Telegram 配置”。
你有两种使用方式：
| 方式 | 适合场景 |
|---|---|
| Telegram API 模式 | 需要读取你账号已加入的频道，包含私有频道或受限频道。 |
| 公开频道模式 | 只处理公开 t.me 频道，不想配置 Telegram 账号登录。 |
如果使用 API 模式，需要填写 Telegram 官方开发者平台申请的 API ID、API Hash 和手机号，并完成验证码登录。
频道管理也在这个页面。频道只是“可用来源池”，是否用于频道扫描、监控策略或豆瓣求片，需要在对应功能里再单独启用。
6. 配置媒体服务
进入“系统配置 / 媒体服务配置”。
- TMDB：用于识别电影、剧集、年份和海报。
- Emby：用于确认资源是否已经入库，以及剧集是否缺集。
如果只想先试频道扫描，可以暂时不配置 TMDB 和 Emby；如果要使用榜单订阅、豆瓣求片、监控清单或 Emby 缺集扫描，就需要先配置它们。
7. 选择一个常用功能验证
验证频道扫描
- 进入“资源获取 / 频道扫描”。
- 启用要扫描的频道。
- 给频道关联一个网盘账号。
- 按需设置关键词、屏蔽词和单轮新增限制。
- 先扫描，再查看结果，确认无误后执行转存。
频道扫描默认不会扫描完就自动转存，这是为了让你先确认命中的资源是否符合预期。
验证榜单或自定义监控
- 进入“资源获取 / 监控策略”，选择 Emby 服务器。
- 启用监控总开关。
- 配置搜索来源，并给来源关联网盘。
- 进入“榜单订阅”选择要追踪的榜单，或在“TMDB 看板”里手动加入监控。
- 到“监控清单”查看条目状态和处理历史。
验证豆瓣求片
- 进入“资源获取 / 豆瓣求片”。
- 选择 Emby 服务器。
- 添加求片用户和豆瓣片单 ID。
- 测试抓取，确认片单能读取。
- 开启总开关后，系统会按固定频率同步片单并处理新条目。
8. 打开通知
进入“系统配置 / 邮箱配置”可以开启邮件通知。系统也会优先通过内置机器人向 Telegram 用户发送重要提醒。
建议至少配置一种通知方式，方便及时知道目录缺失、容量不足、账号失效、登录风险等问题。
9. 看日志定位问题
进入“系统日志”查看最近日志；完整日志文件在 data/log/app.log。如果页面只看到最新窗口，可以直接下载完整文件排查。
常见问题见 常见问题。