nanxun/douyin
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

readme

Browse Source
This commit is contained in:
lijianyou
2025-10-19 12:35:20 +08:00
parent a196552987
commit b91d4253e7
1 changed files with 77 additions and 92 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+77 -92
View File
@@ -1,100 +1,115 @@
# dysync.net - 抖音同步工具（我收藏的、我喜欢的，指定博主） # dysync.net - 抖音同步工具（收藏/喜欢/指定博主，无缝对接Emby/Jellyfin）
`dysync.net` 是一款基于 **.NET Core 6.0** 和 **Vue** 开发的工具，用于同步抖音收藏夹以及我喜欢的视频，解决个人收藏和喜欢的视频容易失效的问题。支持多账号同步，并已预设刮削信息，同步后的视频可直接在 Emby 或 Jellyfin 中播放。 `dysync.net` 是一款基于 **.NET Core 6.0** 和 **Vue** 开发的工具，用于同步抖音收藏夹、「我喜欢」的视频及指定博主作品，解决个人收藏视频易失效的问题。支持多账号同步，内置视频信息刮削功能，同步后的视频可直接在 Emby 或 Jellyfin 中播放。
> 如在使用中有任何问题，欢迎添加 QQ：279225040 进行咨询。 > 🔧 技术咨询：使用中遇到任何问题，欢迎添加 QQ：279225040 咨询
--- ---
#### 先放一张Emby的图 ### 📺 Emby 播放效果预览
![输入图片说明](docs/emby.png) ![Emby播放效果](docs/emby.png)
### 1. 获取抖音 Cookie 以及用户sec_user_d以及指定博主的sec_user_id
Cookie 是同步功能的关键，请严格按照以下步骤获取：
1. 打开 **抖音网页版** (https://www.douyin.com/) 并登录。
2. 进入你的**收藏夹**页面。
3. 按 `F12` 打开浏览器「开发者工具」，切换到「Network (网络)」标签。
4. 在搜索框中输入 `v1/web/aweme/listcollection`。
5. 点击任意一条筛选出的请求，在右侧「Headers (标头)」中找到 `Cookie` 字段，**完整复制**其内容。
![输入图片说明](docs/getcookies.png)
![输入图片说明](docs/secUserId.png)
6. 进入博主主页浏览器地址栏中的便是博主的sec_user_id，复制其值。也可以在博主主页按 `F12` 打开「开发者工具」，切换到「Network (网络)」标签，点击任意一条请求，在右侧「Headers (标头)」中找到 `sec_user_id` 字段，复制其值。博主作品同步功能不建议开启全量同步（一次性下载作品量过多容易被风控）
![输入图片说明](docs/upers-uid.png)
### 2. 路径映射规则
为了方便管理和播放，请理解并正确配置路径映射：
![输入图片说明](docs/upersuidset.png)
* **视频存储路径**：容器内路径为 `/app/collect`。你需要将此路径映射到你本地的一个目录（如 NAS 或电脑硬盘）。**这个本地路径必须与后续在「抖音授权」页面配置的「文件存储路径」完全一致**。
* **数据库存储路径**：容器内路径为 `/app/db`。映射此路径用于持久化工具的配置和同步记录，防止容器删除后数据丢失。
* **多账号配置**：如需同步多个账号，需为每个账号指定一个独立的容器内路径（如 `/app/user1`, `/app/user2`），并分别进行映射。
> **重要**：如果不进行路径映射，所有文件将保存在容器内部，无法直接在 EMBY/JF 中访问。
--- ---
## 🔑 默认账号密码 ## 📌 1. 获取抖音关键信息（必做！同步核心凭证）
Cookie 及 `sec_user_id` 是同步功能的核心，需严格按步骤获取，避免遗漏或错误。
首次登录后台管理页面时使用： ### 1.1 提取抖音 Cookie
1. 打开 **抖音网页版** (https://www.douyin.com/) 并登录目标账号；
2. 进入「我的收藏」页面，确保页面加载完成；
3. 按 `F12` 打开浏览器「开发者工具」，切换到「Network (网络)」标签；
4. 刷新页面，在搜索框中输入 `v1/web/aweme/listcollection` 筛选请求；
5. 点击任意一条筛选结果，在右侧「Headers (标头)」中找到 `Cookie` 字段，**完整复制整段内容**（不可删减字符）。
* **用户名**：`douyin` ![获取Cookie步骤](docs/getcookies.png)
* **密码**：`douyin2025` ![提取个人sec_user_id](docs/secUserId.png)
> **建议**：登录后请修改密码，保障账号安全。 ### 1.2 提取 `sec_user_id`（个人/指定博主）
- **个人 sec_user_id**（同步自己的收藏/喜欢用）：
进入自己的抖音主页，浏览器地址栏中 `sec_user_id=` 后的字符串即为个人 ID（如 `https://www.douyin.com/user/sec_user_id=xxx`）。
- **博主 sec_user_id**（同步指定博主作品用）：
1. 进入目标博主主页；
2. 方式1：直接复制地址栏中 `sec_user_id=` 后的内容；
3. 方式2：按 `F12` → 「Network」→ 任意请求 → 「Headers」→ 提取 `sec_user_id` 字段值。
> ⚠️ 风控提示：同步博主作品时，**禁止开启全量同步**（一次性下载过多易被抖音限制访问），建议分批次同步。
![提取博主sec_user_id](docs/upers-uid.png)
--- ---
## 🚀 运行方式 ## 📁 2. 路径映射规则（核心！错配会导致无法访问/数据丢失）
为实现视频在 Emby/Jellyfin 中正常播放及数据持久化，需正确配置本地路径与容器路径的映射：
你可以选择以下任一方式启动服务。**推荐使用 Docker Compose**，因为它更易于管理和维护。 | 存储类型 | 容器内路径 | 本地路径配置要求 | 用途说明 |
|------------------|------------------|----------------------------------------------------------------------------------|------------------------------|
| 个人收藏视频 | `/app/collect` | 映射到本地目录（如 NAS：`/volume1/抖音/收藏`、电脑：`D:/抖音/收藏`） | 存储同步后的收藏视频 |
| 个人喜欢视频 | `/app/favorite` | 映射到本地目录（建议与收藏视频路径区分，如 `/volume1/抖音/喜欢`） | 存储同步后的「我喜欢」视频 |
| 指定博主视频 | `/app/uper` | 映射到本地目录（如 `/volume1/抖音/博主作品`） | 存储同步后的博主视频 |
| 数据库文件 | `/app/db` | 映射到本地稳定目录（如 `/volume1/抖音/工具数据库`） | 持久化配置、同步记录（防止容器删除后数据丢失） |
| 多账号视频（可选）| `/app/user1`/`/app/user2` 等 | 为每个账号分配独立本地路径（如 `/volume1/抖音/账号A`、`/volume1/抖音/账号B`） | 实现多账号隔离同步 |
> ✅ 关键注意：
> 1. 本地路径需与后续后台「抖音授权」页面配置的「文件存储路径」**完全一致**；
> 2. 未配置路径映射时，文件仅存于容器内部，Emby/Jellyfin 无法访问，且容器删除后数据丢失。
![路径配置示例](docs/upersuidset.png)
---
## 🔑 3. 默认账号密码（首次登录用）
首次访问后台管理页面时，使用以下默认账号密码：
- **用户名**：`douyin`
- **密码**：`douyin2025`
> ⚠️ 安全建议：登录后立即修改密码，避免未授权访问。
---
## 🚀 4. 运行方式（推荐 Docker Compose，更易维护）
### 方式一：Docker 命令行 ### 方式一：Docker 命令行
将下方命令中的「本地路径」替换为你的实际路径，终端执行即可：
将下方命令中的本地路径替换为你的实际路径，然后在终端中执行。
```bash ```bash
docker run -d --restart=always \ docker run -d --restart=always \
-v /你的/本地/视频1/路径:/app/collect \ -v /你的/本地/收藏视频路径:/app/collect \
-v /你的/本地/视频2/路径:/app/favorite \ -v /你的/本地/喜欢视频路径:/app/favorite \
-v /你的/本地/数据库/路径:/app/db \ -v /你的/本地/数据库路径:/app/db \
-v /你的/本地/数据库/路径:/app/uper \ -v /你的/本地/博主视频路径:/app/uper \
-p 10101:10101 \ -p 10101:10101 \
--name dysync2025 \ --name dysync2025 \
registry.cn-hangzhou.aliyuncs.com/jianzhichu/dysync.net registry.cn-hangzhou.aliyuncs.com/jianzhichu/dysync.net
# 注意：-p 后面的容器端口必须为 10101（源码固定）
###-p 后面的第二个端口 必须10101（源码里面写死了）
```
### 方式 2：Docker-Compose 运行（推荐） ### 方式二：Docker Compose 运行（推荐）
创建 docker-compose.yml 文件，复制以下内容，替换「本地路径」后执行 docker-compose up -d：
```yml ```yaml
version: '3.8' version: '3.8'
services: services:
dysync: dysync:
image: registry.cn-hangzhou.aliyuncs.com/jianzhichu/dysync.net image: registry.cn-hangzhou.aliyuncs.com/jianzhichu/dysync.net
container_name: dysync2025 # 容器名称，可自定义 container_name: dysync2025 # 容器名称可自定义
restart: always # 容器异常退出时自动重启 restart: always # 容器异常退出时自动重启
ports: ports:
- "10101:10101" # 端口映射：本地端口:容器端口（容器端口10101不可修改） - "10101:10101" # 端口映射：本地端口:容器端口（容器端口10101不可修改）
volumes: volumes:
# 第一个账号的收藏的视频存储路径（本地路径:容器路径） # 第一个账号：收藏视频存储路径（本地路径:容器路径）
- /本地视频路径1:/app/collect - /本地/收藏视频路径:/app/collect
# 第一个账号的喜欢的视频存储路径（本地路径:容器路径） # 第一个账号：喜欢视频存储路径（本地路径:容器路径）
- /本地视频路径1:/app/favorite - /本地/喜欢视频路径:/app/favorite
# 数据库存储路径 # 数据库存储路径（持久化配置和同步记录）
- /本地数据库路径:/app/db - /本地/数据库路径:/app/db
- /指定博主视频路径:/app/uper # 指定博主视频存储路径
# 第二个账号的视频存储路径（多账号示例，需在后台对应配置） - /本地/博主视频路径:/app/uper
- /本地视频路径2:/app/yeyeye # 多账号示例：第二个账号视频存储路径（需在后台对应配置）
# （可选）如需添加环境变量，取消下方注释并配置 - /本地/第二个账号视频路径:/app/yeyeye
# （可选）环境变量配置（取消注释并修改）
# environment: # environment:
# - ENV_VAR_NAME=value # - ENV_VAR_NAME=value
# （可选）如需自定义网络，取消下方注释并配置 # （可选）自定义网络配置（取消注释并修改）
# networks: # networks:
# - custom_network # - custom_network
@@ -102,34 +117,4 @@ services:
# networks: # networks:
# custom_network: # custom_network:
# driver: bridge # driver: bridge
```
```
### 方式 3：自己编译运行
##### 前端源码在/app里面
```
yarn install
yarn dev
yarn run build
### 运行可能报错，less包如果报错，运行下面的命令即可
yarn remove less && yarn add less@4.1.3 -D
```
##### 后台编译要先安装.netcore环境 netcore sdk
```bash
dotnet --version # 输出安装的 .NET Core 版本，说明安装成功
dotnet build
dotnet build -c Release # 生成文件在 bin/Release/netX.X/ 目录
### 调试模式运行
dotnet run
```
## 软件截图
![输入图片说明](docs/homepage.png)
![输入图片说明](docs/datalist.png)
![输入图片说明](docs/logs.png)
![输入图片说明](docs/set.png)