diff --git a/README.md b/README.md index 910b8bc..59fbe7a 100644 --- a/README.md +++ b/README.md @@ -1,17 +1,31 @@ # dysync.net - 抖音同步工具(抖小云) -`dysync.net` 是一款基于 **.NET Core 6.0** 和 **Vue** 开发的工具,用于同步抖音收藏夹、「我喜欢」的视频及指定博主作品,解决个人收藏视频易失效的问题。支持多账号同步,内置视频信息刮削功能,同步后的视频可直接在 Emby 或 Jellyfin 中播放。 +`dysync.net` 是一款基于 **.NET Core 6.0** 和 **Vue** 开发的工具,用于同步抖音收藏夹、「我喜欢」的视频及指定博主作品,支持多账号同步,内置视频信息刮削功能,同步后的视频可直接在 Emby 或 Jellyfin 中播放。 -> 🔧 问题反馈:使用中遇到任何问题,欢迎添加 QQ:279225040 咨询 +> 🔧 **问题反馈**:使用中遇到问题,欢迎添加 QQ:279225040 咨询,可能回复较慢,请耐心等待。 --- -### 📺 Emby 播放效果预览 +## 📺 Emby 播放效果预览 ![Emby播放效果](docs/emby.png) --- -## 📌 1. 获取抖音关键信息(必做!同步核心凭证) +## 📋 目录 +- [1. 获取抖音关键信息(必做!同步核心凭证)](#1-获取抖音关键信息必做同步核心凭证) + - [1.1 提取抖音 Cookie](#11-提取抖音-cookie) + - [1.2 提取 `sec_user_id`(个人/指定博主)](#12-提取-sec_user_id个人指定博主) +- [2. 路径映射规则(核心!错配会导致无法访问/数据丢失)](#2-路径映射规则核心错配会导致无法访问数据丢失) +- [3. 默认账号密码(首次登录用)](#3-默认账号密码首次登录用) +- [4. 运行方式(推荐 Docker Compose)](#4-运行方式推荐-docker-compose) + - [镜像版本](#镜像版本) + - [构建命令示例](#构建命令示例) +- [5. 软件截图](#5-软件截图) +- [6. 功能和计划](#6-功能和计划) + +--- + +## 1. 获取抖音关键信息(必做!同步核心凭证) Cookie 及 `sec_user_id` 是同步功能的核心,需严格按步骤获取,避免遗漏或错误。 ### 1.1 提取抖音 Cookie @@ -29,27 +43,28 @@ Cookie 及 `sec_user_id` 是同步功能的核心,需严格按步骤获取, 进入自己的抖音主页,浏览器地址栏中 `sec_user_id=` 后的字符串即为个人 ID(如 `https://www.douyin.com/user/sec_user_id=xxx`)。 - **博主 sec_user_id**(同步指定博主作品用): 1. 进入目标博主主页; - 2. 方式1:直接复制地址栏中 `user/` 到 `?from_tab_name`中间部分内容即是博主的 `sec_user_id`; + 2. 方式1:直接复制地址栏中 `user/` 到 `?from_tab_name` 中间部分内容即是博主的 `sec_user_id`; 3. 方式2:按 `F12` → 「Network」→ 任意请求 → 「Headers」→ 提取 `sec_user_id` 字段值。 -> ⚠️ 风控提示:同步博主作品时,**慎用开启全量同步**(一次性下载过多易被抖音限制访问)。 +> ⚠️ **风控提示**:同步博主作品时,**慎用开启全量同步**(一次性下载过多易被抖音限制访问)。 ![提取博主sec_user_id](docs/upers-uid.png) --- -## 📁 2. 路径映射规则(核心!错配会导致无法访问/数据丢失) +## 2. 路径映射规则(核心!错配会导致无法访问/数据丢失) 为实现视频在 Emby/Jellyfin 中正常播放及数据持久化,需正确配置本地路径与容器路径的映射: | 存储类型 | 容器内路径 | 本地路径配置要求 | 用途说明 | |------------------|------------------|----------------------------------------------------------------------------------|------------------------------| | 个人收藏视频 | `/app/collect` | 映射到本地目录(如 NAS:`/volume1/抖音/收藏`、电脑:`D:/抖音/收藏`) | 存储同步后的收藏视频 | | 个人喜欢视频 | `/app/favorite` | 映射到本地目录(建议与收藏视频路径区分,如 `/volume1/抖音/喜欢`) | 存储同步后的「我喜欢」视频 | +| 图文视频 | `/app/images` | 映射到本地目录(建议与收藏视频路径区分,如 `/volume1/抖音/图文视频`) | 存储同步后的「图文视频」 | | 指定博主视频 | `/app/uper` | 映射到本地目录(如 `/volume1/抖音/博主作品`) | 存储同步后的博主视频 | | 数据库文件 | `/app/db` | 映射到本地稳定目录(如 `/volume1/抖音/工具数据库`) | 持久化配置、同步记录(防止容器删除后数据丢失) | | 多账号视频(可选)| `/app/user1`/`/app/user2` 等 | 为每个账号分配独立本地路径(如 `/volume1/抖音/账号A`、`/volume1/抖音/账号B`) | 实现多账号隔离同步 | -> ✅ 关键注意: +> ✅ **关键注意**: > 1. 本地路径需与后续后台「抖音授权」页面配置的「文件存储路径」**完全一致**; > 2. 未配置路径映射时,文件仅存于容器内部,Emby/Jellyfin 无法访问,且容器删除后数据丢失。 @@ -57,56 +72,51 @@ Cookie 及 `sec_user_id` 是同步功能的核心,需严格按步骤获取, --- -## 🔑 3. 默认账号密码(首次登录用) +## 3. 默认账号密码(首次登录用) 首次访问后台管理页面时,使用以下默认账号密码: - **用户名**:`douyin` - **密码**:`douyin2025` -> ⚠️ 安全建议:登录后修改密码。 +> ⚠️ **安全建议**:登录后修改密码。 --- -## 🚀 4. 运行方式(推荐 Docker Compose) +## 4. 运行方式(推荐 Docker Compose) +### 镜像版本 -# Dysync.net Docker 镜像版本说明 - -## 镜像版本 - -| 镜像标签 | 架构 | 功能描述 | 镜像大小 | 适用场景 | -|-----------------------------------|----------------|--------------------------------------------------------------------------|-----------|------------------------------| -| `jianzhichu/dysync.net:latest` | x86_64 (amd64) | **标准版**
- 包含核心功能
- **不含 FFmpeg**
- 不能下载图文视频 | ~200M | 仅需基础功能,追求轻量部署 | -| `jianzhichu/dysync.net:full_latest` | x86_64 (amd64) | **完整版**
- 包含全部核心功能
- **内置 FFmpeg**
- 支持图文视频下载与合成 | ~700M | 需要完整媒体处理能力的场景 | -| `jianzhichu/dysync.net:arm_latest` | ARM64 | **ARM 标准版**
- 核心功能(与 `latest` 一致)
- **适配 ARM 架构** | ~200M | ARM 设备(如树莓派)的轻量部署 | -| `jianzhichu/dysync.net:full_arm_latest` | ARM64 | **ARM 完整版**
- 完整功能(与 `full_latest` 一致)
- **适配 ARM 架构** | ~500M | ARM 设备的完整功能部署 | -| `jianzhichu/dysync.net:beta_1.0` | x86_64 (amd64) | **测试版 v1.0**
- 包含最新开发特性
- 功能可能不稳定
- 不含 FFmpeg | ~200M | 开发测试、尝鲜新功能 | - -## 构建命令示例 - -以下是构建上述各版本镜像的 Docker 命令参考: - -```bash +| 镜像标签 | 架构 | 功能描述 | +|-----------------------------------|----------------|--------------------------------------------------------------------------| +| `latest` | x86_64 (amd64) | **标准版**
- 包含核心功能
- **不含 FFmpeg**
- 不能下载图文视频 | +| `full_latest` | x86_64 (amd64) | **完整版**
- 包含全部核心功能
- **内置 FFmpeg**
- 支持图文视频下载与合成 | +| `arm_latest` | ARM64 | **ARM 标准版**
- 核心功能(与 `latest` 一致)
- **适配 ARM 架构** | +| `full_arm_latest` | ARM64 | **ARM 完整版**
- 完整功能(与 `full_latest` 一致)
- **适配 ARM 架构** | +| `beta_1.0` | x86_64 (amd64) | **测试版 v1.0**
- 测速版
- 不含 FFmpeg | +### 构建命令示例 将下方命令中的「本地路径」替换为你的实际路径,终端执行即可: -```bash -### 方式一:Docker 命令行 +#### 方式一:Docker 命令行 +```bash docker run -d --restart=always \ -v /opt/dysync/coll:/app/collect \ - -v /opt/dysync/favorite \ + -v /opt/dysync/favorite:/app/favorite \ -v /opt/dysync/db:/app/db \ -v /opt/dysync/imgs:/app/images \ -v /opt/dysync/uper:/app/uper \ -p 10103:10101 \ --name dysync_arm_full \ registry.cn-hangzhou.aliyuncs.com/jianzhichu/dysync.net:latest -# 注意:-p 后面的容器端口必须为 10101(源码固定) +# 注意:-p 后面的容器端口,可以用环境变量:ASPNETCORE_URLS = http://+:10108 指定 +``` ### 方式二:Docker Compose 运行(推荐) 创建 docker-compose.yml 文件,复制以下内容,替换「本地路径」后执行 docker-compose up -d: +```bash + version: '3.8' services: @@ -115,27 +125,28 @@ services: container_name: dysync_arm_full # 容器名称 restart: always # 总是重启 ports: - - "10101:10101" # 端口映射 + - "10101:10101" # 端口映射(主机端口:容器端口,容器端口固定为10101) volumes: - - /opt/dysync/db:/app/db # 数据库目录 - - /opt/dysync/coll:/app/collect # 收集目录 - - /opt/dysync/favorite:/app/favorite # 收藏目录(补充了容器内路径) - - /opt/dysync/imgs:/app/images # 图片目录 - - /opt/dysync/uper:/app/uper # 上传目录 - # 下面是多账号路径映射示例(可选) - - /opt/dysync/coll2:/app/collect # 收集目录 - - /opt/dysync/favorite2:/app/favorite # 收藏目录(补充了容器内路径) - - /opt/dysync/imgs2:/app/images # 图片目录 - - /opt/dysync/uper2:/app/uper # 上传目录 - # 配置DNS服务器(可选) + # 基础路径映射 + - /opt/dysync/db:/app/db # 数据库目录(持久化配置和同步记录) + - /opt/dysync/coll:/app/collect # 个人收藏视频目录 + - /opt/dysync/favorite:/app/favorite # 个人喜欢视频目录 + - /opt/dysync/imgs:/app/images # 图文视频目录 + - /opt/dysync/uper:/app/uper # 指定博主视频目录 + + # 多账号路径映射示例(可选,需在后台对应账号配置中指定存储路径) + # - /opt/dysync/account1/collect:/app/user1/collect + # - /opt/dysync/account1/favorite:/app/user1/favorite + # - /opt/dysync/account2/collect:/app/user2/collect + # - /opt/dysync/account2/favorite:/app/user2/favorite network_mode: bridge dns: - - 8.8.8.8 # Google DNS - - 114.114.114.114 # 国内DNS - - 223.5.5.5 - + - 8.8.8.8 # Google DNS(提升海外访问稳定性) + - 114.114.114.114 # 国内DNS(提升国内访问稳定性) + - 223.5.5.5 # 阿里云DNS(备用) ``` + ## 🚀 5. 软件截图 ![输入图片说明](docs/homepage.png)