wx_channel

微信视频号下载助手

一键下载微信视频号所有页面视频，支持批量下载、加密视频解密、自动去重

快速开始 • 核心功能 • 使用场景 • 文档 • 支持项目

✨ 为什么选择这个工具？

你是否遇到过这些问题？

• ❌ 视频号视频无法直接下载保存
• ❌ 想批量下载某个作者的所有视频，但只能一个个点
• ❌ 加密视频下载后无法播放
• ❌ 需要保存视频做备份或二次创作
• ❌ 想离线观看喜欢的视频内容

✅ 这个工具帮你解决

• ✅ 一键下载：点击即可下载，无需复杂操作
• ✅ 批量处理：支持批量下载，一次搞定几十上百个视频
• ✅ 自动解密：加密视频自动解密，下载即可播放
• ✅ 智能去重：自动识别已下载视频，避免重复
• ✅ 无感雷达：默认关闭，通过 config.yaml 中的 radar_enabled 显式启用
• ✅ 完整记录：自动记录所有下载信息，便于管理
• ✅ 命名模板：支持通过 download_filename_template 自定义批量下载文件名

效果演示

修复wx视频号新版本界面，加了我的搜藏点赞的下载。

Web 控制台界面

访问 http://localhost:2025/console 使用 Web 控制台：

• 浏览记录：查看和管理所有浏览过的视频
• 下载记录：查看历史下载记录和统计
• 下载队列：实时管理下载任务
• 批量下载：批量提交下载任务
• 数据导出：导出 JSON/CSV 格式数据

提示：更多功能说明请查看 文档目录 和 Web 控制台指南

Insight 联动

wx_channel 通过 Insight 内置的边缘网关进行远程设备管理、数据采集和任务协同：

• Cloud 版通过 cloud_hub_url 连接 Insight 的 /ws/client
• 本地默认地址为 ws://127.0.0.1:18081/ws/client，config.yaml 中的显式配置优先
• Insight API 与运营台分别使用 18081 和 5176 端口
• 独立 wx_channel_hub 已停止使用，不再作为运行依赖

快速开始

三步开始使用

# 1️⃣ 下载程序
# 访问 https://github.com/nobiyou/wx_channel/releases 下载最新版本

# 2️⃣ 启动程序
wx_channel.exe

# 3️⃣ 打开视频号页面，点击下载按钮
# 就这么简单！

详细步骤

1. 下载并启动

   • 从 Releases 下载最新版本
   • 解压后双击 wx_channel.exe 启动

2. 安装证书（首次使用）

   • 程序会自动尝试安装证书
   • 如果失败，手动安装 downloads/SunnyRoot.cer

3. 开始下载

   • 打开微信视频号页面
   • 页面会自动注入下载按钮
   • 点击按钮即可下载

详细教程：使用文档 | 开发文档 | 更新日志

核心功能

视频下载

数据管理

用户体验

使用场景

内容创作者

• 备份自己的视频号内容
• 下载素材用于二次创作
• 整理视频资料库

学习研究

• 下载教程视频离线学习
• 收集行业案例分析
• 保存学习资料

企业团队

• 备份企业视频号内容
• 下载竞品分析素材
• 整理营销案例库

个人用户

• 保存喜欢的视频内容
• 离线观看视频
• 整理收藏的视频

对比其他方案

安装方式

方式一：下载预编译版本（推荐）

1. 访问 GitHub Releases
2. 下载最新版本的 wx_channel.exe
3. 解压后直接运行

方式二：从源码编译

# 克隆仓库
git clone https://github.com/nobiyou/wx_channel.git
cd wx_channel

# 基本编译
go build -o wx_channel.exe

# 优化体积编译（推荐）
go build -ldflags="-s -w" -o wx_channel_mini.exe

⚙️ 配置选项

基础配置

# 修改代理端口
wx_channel.exe -p 8080

# 查看版本
wx_channel.exe -v

# 卸载证书
wx_channel.exe --uninstall

环境变量

# 下载目录
WX_CHANNEL_DOWNLOADS_DIR=downloads

# 日志配置
WX_CHANNEL_LOG_FILE=logs/wx_channel.log
WX_CHANNEL_LOG_MAX_MB=5

# 并发配置
WX_CHANNEL_DOWNLOAD_CONCURRENCY=5
WX_CHANNEL_DOWNLOAD_TIMEOUT=30

完整配置：配置文档

文档

用户文档

所有使用相关的文档都在 docs/ 目录：

• 快速开始: 安装指南 | 配置说明
• 功能使用: 批量下载 | 监控功能
• 测试指南: 前端测试
• 故障排除: 常见问题

查看所有用户文档: docs/INDEX.md

开发文档

所有开发相关的文档都在 dev-docs/ 目录：

• 修复历史: FIX_HISTORY.md - 所有修复记录 ⭐
• 完整文档: DOCUMENTATION.md - 项目完整文档
• API 文档: api_documentation.md - API 接口文档
• 优化记录: WebSocket、超时、性能等优化文档

查看所有开发文档: dev-docs/INDEX.md

快速入门

• 安装指南 - 详细的安装步骤
• 项目介绍 - 功能特性和工作原理
• 故障排除 - 快速解决问题

进阶功能

• 批量下载 - 批量下载完整指南
• Web 控制台 - Web 界面使用指南（推荐）
• API 文档 - HTTP API 接口
• API 快速开始 - API 快速上手

开发文档

• 构建指南 - 从源码构建
• 配置说明 - 所有配置选项
• 更新日志 - 版本更新记录
• 技术文档 - 更多开发文档

最新版本 v5.7.9

核心升级（v5.7.9）

本次版本聚焦长时间运行稳定性、长标题文件名和版本化页面生命周期：

• 长时间运行保活：增加页面应用层健康探测、心跳确认和断线重连，识别并恢复协议在线但页面失活的情况。
• 自动打开策略：新增 auto_open_channels，标准版和 Radar 版默认关闭，Cloud 版默认开启。
• 长标题命名：移除固定 50 字符限制，按完整下载路径动态计算 Windows UTF-16 预算，保留视频 ID、画质和扩展名。
• 下载链路统一：批量、队列、分片和页面直连下载统一命名与重名规则，数据库保留完整原始标题。
• 公众号请求稳定性：推送列表读取前等待凭证刷新，降低首次 401 /api/mp/msg/list 失败。

✨ 主要特性

• 稳定下载: 集成 Gopeed 引擎，支持高并发、断点续传与元数据自动修正。
• 智能管理: 完备的后台管理系统，支持设备远程控制、任务实时监控与用户权限管理。
• 多端适配: 响应式设计，完美支持 PC、平板与手机端访问。

支持项目

如果这个项目对你有帮助，欢迎：

• ⭐ 给项目点个 Star
• 提交 Bug 报告和功能建议
• 完善文档和教程
• 赞赏支持开发

赞赏支持

赞赏名单

感谢以下用户的支持：

感谢每一位支持者！你们的支持是项目持续更新的动力。

⚠️ 免责声明

本工具仅供学习和研究使用。请遵守相关法律法规，尊重内容创作者的版权。使用本工具下载的内容请勿用于商业用途或非法传播。

许可证

本项目采用 MIT License 许可证。

致谢

• 开发者说明：仓库已内置 SunnyNet v1.0.3 源码，位于 pkg/sunnynet。根模块通过 go.mod 的 replace 指向本地版本，便于其他开发者直接构建与调试。
• SunnyNet - HTTP/HTTPS 代理库
• Go - 编程语言
• 所有贡献者和支持者

联系方式

• GitHub Issues：提交问题
• 个人微信：tutuixiu（备注：视频号下载）
• 项目地址：https://github.com/nobiyou/wx_channel

交流群

Star History

如果这个项目对你有帮助，请给个 ⭐ Star 支持一下！

Made with ❤️ by nobiyou