desstg/115-auto repository overview

⁠115-AUTO

一个跑在 NAS / Docker 里的 115 网盘自动化管理工具：网页管理面板 + Telegram 机器人 + strm 流代理，三合一。

它把 115 网盘里杂乱的视频文件，自动完成「扫描 → 清理垃圾小文件 → 改名去广告 → 按番号分类移动」，还能一键转存分享链接、生成 .strm 给 Kodi / Emby / Jellyfin 刮削播放。

⁠它能干什么

⁠1. 网页管理面板（http://你的NAS_IP:5050）

自动化四步详解：

1. 扫描 —— 列出目录下所有文件
2. 清理小文件 —— 删除小于指定大小（默认 300MB）的无用文件
3. 改名整理 —— 清除文件名里的广告/网站水印字符，把散文件移进同名文件夹
4. 分类移动 —— 按番号前缀自动把视频文件夹归类到指定目录：

⁠2. Telegram 机器人

在 Telegram 里发消息即可操作，支持：

• 💬 AI 对话 —— 直接发文字，DeepSeek 回复（带上下文）
• 📸 图片识别 —— 发图 + ocr 提取文字，或发图 + 问题识别后回答
• 📦 115 转存 —— 发 115 分享链接 / 磁力 / ed2k，自动转存；发 .torrent 文件离线下载
• 🔧 命令菜单（输入 / 即可看到）：

⁠3. strm 流代理（http://你的NAS_IP:5051）

从 115 取视频直链，流式转发给 Kodi / Emby / Jellyfin 等媒体中心直接播放，不用下载到本地。

⁠系统架构

• 后端：Python + Flask（网页）、python-telegram-bot（机器人）
• 网盘：p115client⁠ 操作 115 网盘
• 部署：Docker Compose，适配群晖等任意支持 Docker 的 NAS
• 端口：
  • 5050 → 网页管理面板（容器内 5000）
  • 5051 → strm 流代理（容器内 5001）

⁠安装部署（Docker）

⁠前置准备

1. 一台能装 Docker 的 NAS（群晖 / 威联通 / 极空间等均可）
2. 一个 115 网盘账号

⁠一键启动（零配置，不用任何文件）

不用准备配置文件，直接启动：

docker run -d \
  --name 115-auto \
  --restart unless-stopped \
  -p 5050:5000 \
  -p 5051:5001 \
  -v ./data:/data \
  -v ./strm:/data/strm \
  desstg/115-auto:latest

version: "3.8"
services:
  115-auto:
    image: desstg/115-auto:latest
    container_name: 115-auto
    restart: unless-stopped
    environment:
      - STRM_SYNC_DIR=/data/strm
      # 以下都是可选，也可以通过网页「设置」页填写。取消注释并填值即可：
      # - PAN115_COOKIE=你的cookie
      # - TG_BOT_TOKEN=你的机器人token
      # - DEEPSEEK_API_KEY=sk-xxx
      # - ZHIPU_API_KEY=xxx
      # - TG_PROXY=http://代理地址:端口
    ports:
      - "5050:5000"
      - "5051:5001"
    volumes:
      - ./data:/data
      - ./strm:/data/strm

⁠首次使用（配置都在网页里完成）

1. 打开网页：http://你的NAS_IP:5050
2. 进入「设置」页，粘贴你的 115 Cookie 并保存（唯一必填项）
3. （可选）在「设置」页填 Telegram 机器人 Token，保存后重启容器，机器人就上线
4. 「自动化」→ 目录操作 → 把「默认目录」设成你要整理的目录
5. 「自动化」→ 分类移动 → 给每个分类选好目标目录
6. 跑一次「一键自动」或配置定时任务

⁠配置项（都可选，网页「设置」页也能填）

⁠项目文件

⁠安全说明

• 镜像内只含代码，不含任何敏感信息（Cookie / Token / API Key 都不打包）
• Cookie 和 Token 存在挂载的 data 目录里（.pan115_cookie、.tg_token），只在你自己的 NAS 上
• 发布源码时请排除 .env、.pan115_cookie、.tg_token、nas-bot.json（已通过 .gitignore 排除）

⁠常见问题

Q：网页打不开？ A：确认容器已启动（docker compose ps），且访问的是 http://NAS_IP:5050 而非容器内端口。

Q：115 功能提示 Cookie 无效？ A：Cookie 过期了，去「设置」页重新粘贴最新的 Cookie。

Q：Telegram 机器人没反应？ A：检查网页「设置」页的 Token 是否填对，且填完后重启了容器；国内网络需要配 TG_PROXY 代理。

Q：分类移动后文件没归对？ A：去「自动化 → 分类移动」检查该分类的关键词和目标目录；日本番号是按「字母-数字」格式自动识别的，遇到新番号会自动归到日本类。