qicfan/qmediasync Docker 镜像 - 轩辕镜像

介绍

• 基于 115 开放平台接口来同步生成 STRM 和下载、上传元数据，并且提供直链解析服务，不依赖其他项目。

• 原理：定时同步 115 的文件列表生成目录树来和本地文件树对比：

• 1. 本地存在网盘不存在则删除本地文件（由设置项控制）
• 2. 本地不存在网盘存在则创建本地文件（STRM 或元数据下载）
• 3. 本地存在且网盘存在，则判断文件是否一致（文件 pick_code 是否相同），一致则不处理，不一致则更新

• 实测 3W 多文件大概 22T 的库需要 5 分钟左右完成目录树生成和对比，首次下载元数据需要的时间不定，可能在 1-2 个小时左右。

• 定时任务设定不能小于 0.5 小时间隔

• 默认用户名 admin,密码 admin123

功能列表

• 115 开放平台接入
• STRM 生成
• 元数据下载
• 使用 CookieCloud 同步 115 网页 Cookie（后续可以调用 115 api）
• 接入 *** 通知
• 目录下新建隐藏文件.meta 记录原始信息（供以后使用）
• 元数据新增同名的隐藏文件.name.meta 记录原始信息（供以后使用）
• 同步时上传网盘不存在的元数据（STRM 设置开启）
• 同步时删除网盘不存在的 STRM 文件（STRM 设置开启）
• 同步时删除网盘不存在且本地为空的文件夹（STRM 设置开启）
• 首页增加上传下载队列状态
• 增加上传下载任务列表(暂时不做，只有第一全量同步时有需求，后续增量基本显示不出来就搞完了)
• 增加监控多个目录
• 增加同步记录删除(v0.6)
• 增加单个同步目录手动同步(v0.6)
• 如果同步目录正在同步队列中，则跳过本次执行(v0.6)
• 123云盘开放平台接入
• 接入资源库(待定，需要获取 115 Cookie 才能使用转存等服务)
• emby 302（待定，优先级低，需要对 emby 或 jellyfin 的 js 也做修改）
• 刮削 & 整理

快速开始

使用 Docker Run

bash
# 运行容器
docker run -d \
  --name q115-strm \
  -p ***:*** \
  -v $(pwd)/q115-strm/config:/app/config \
  -v /vol1/1000/网盘:/media \
  -e TZ=Asia/Shanghai \
  --restart unless-stopped \
  qicfan/115strm:latest

使用 Docker Compose

1. 创建 docker-compose.yml 文件（见下方示例）

services:
    q115-strm:
        image: qicfan/115strm:latest
        container_name: q115-strm
        restart: unless-stopped
        ports:
            - "***:***"
        volumes:
            - /vol1/1000/docker/q115-strm/config:/app/config
            - /vol2/1000/网盘:/media
        environment:
            - TZ=Asia/Shanghai

networks:
    default:
        name: q115-strm

2. 运行以下命令：

bash
# 启动服务
docker-compose up -d

# 查看日志
docker-compose logs -f

# 停止服务
docker-compose down

目录映射说明

环境变量

端口说明

• *******: Web 服务端口

版本标签

• latest - 最新发布版本
• v1.0.0 - 具体版本号（对应 GitHub Release）

首次使用

1. 启动容器后访问: [***]
2. 默认登录信息需要查看日志或配置文件
3. 登录后进行 115 账号配置

数据备份

重要数据位于 /vol1/1000/docker/q115-strm/config 目录，请定期备份：

bash
# 备份数据
cp -r /vol1/1000/docker/q115-strm/config /vol1/1000/docker/q115-strm/config-backup-$(date +%Y%m%d)

123云盘客户端使用示例

在代码中使用123云盘客户端：

go
package main

import (
    "context"
    "fmt"
    "log"
    "time"

    "your-project/open123" // 替换为实际的导入路径
)

func main() {
    // 创建客户端实例
    client := open123.NewClient("your-access-token")

    // 设置特定接口的QPS限制（可选）
    // 例如，限制文件上传创建接口的QPS为5
    client.SetRateLimit("/upload/v1/file/create", 5)

    // 创建文件上传请求
    req := &open123.FileUploadCreateRequest{
        ParentFileID: 0,           // 根目录
        Filename:     "测试文件.txt",
        Etag:         "0a05e3dcd8ba1d***bc8611d0a1",
        Size:         44321,
    }

    // 设置超时上下文
    ctx, cancel := context.WithTimeout(context.Background(), 30*time.Second)
    defer cancel()

    // 调用文件上传创建接口
    resp, err := client.FileUploadCreate(ctx, req)
    if err != nil {
        log.Fatalf("文件上传创建失败: %v", err)
    }

    // 检查响应结果
    if resp.Code != 0 {
        log.Fatalf("请求失败: %s", resp.Message)
    }

    // 输出响应数据
    fmt.Printf("文件ID: %d\n", resp.Data.FileID)
    fmt.Printf("上传ID: %s\n", resp.Data.UploadID)
    fmt.Printf("分片大小: %d\n", resp.Data.PartSize)
    fmt.Printf("文件是否已存在: %t\n", resp.Data.AlreadyExist)
}

QPS控制功能说明

123云盘客户端支持对每个接口单独设置QPS限制，以防止请求过于频繁导致被限流。

• 使用 SetRateLimit 方法为特定接口设置QPS限制
• 第一个参数是接口路径（例如 /upload/v1/file/create）
• 第二个参数是每秒允许的最大请求数
• 如果不为某个接口设置QPS限制，则不会对该接口进行速率限制

故障排查

查看日志

bash
# 查看容器日志
docker logs q115-strm

# 查看应用日志
docker exec q115-strm ls -la /app/config/logs/

重启服务

bash
# 重启容器
docker restart q115-strm

# 或使用docker-compose
docker-compose restart

更新镜像

bash
# 停止并删除旧容器
docker stop q115-strm && docker rm q115-strm

# 拉取最新镜像
docker pull qicfan/115strm:latest

# 重新启动
docker run -d \
  --name q115-strm \
  -p ***:*** \
  -v $(pwd)/q115-strm/config:/app/config \
  -v $(pwd)/q115-strm/data:/app/data \
  -v $(pwd)/q115-strm/logs:/app/config/logs \
  -e TZ=Asia/Shanghai \
  --restart unless-stopped \
  qicfan/115strm:latest