{"id":28359800,"url":"https://github.com/systemmin/wxdown","last_synced_at":"2025-10-04T15:09:19.487Z","repository":{"id":240532031,"uuid":"802852894","full_name":"systemmin/wxdown","owner":"systemmin","description":"这是一个用于保存公众号文章到本地离线查看的软件，支持将 HTML 文章保存至本地，并提供 HTML 转 PDF 的功能。此外，软件还支持图片、音频、视频下载，可在 Windows、Mac 和 Linux 系统上运行，使用 Go 语言开发，具备轻量级、小体积、高性能和并发支持的特点。","archived":false,"fork":false,"pushed_at":"2025-04-15T03:46:30.000Z","size":50997,"stargazers_count":197,"open_issues_count":0,"forks_count":30,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-06-22T20:39:32.127Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/systemmin.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-05-19T12:55:02.000Z","updated_at":"2025-06-19T01:28:59.000Z","dependencies_parsed_at":"2025-02-15T05:32:03.531Z","dependency_job_id":null,"html_url":"https://github.com/systemmin/wxdown","commit_stats":null,"previous_names":["systemmin/wxdown"],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/systemmin/wxdown","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/systemmin%2Fwxdown","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/systemmin%2Fwxdown/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/systemmin%2Fwxdown/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/systemmin%2Fwxdown/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/systemmin","download_url":"https://codeload.github.com/systemmin/wxdown/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/systemmin%2Fwxdown/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278328927,"owners_count":25969041,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-04T02:00:05.491Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-05-28T10:09:49.620Z","updated_at":"2025-10-04T15:09:19.474Z","avatar_url":"https://github.com/systemmin.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n\u003cimg src=\"web/logo.png\"\u003e\n\u003cp\u003e\n\n# wxdown\n\n这是一个用于保存公众号文章到本地离线查看的软件，支持将 HTML 文章保存至本地，并提供 HTML 转 PDF 的功能。此外，软件还支持图片、音频、视频下载，可在 Windows、Mac 和 Linux 系统上运行，使用 Go\n语言开发，具备轻量级、小体积、高性能和并发支持的特点。\n\n**不支持批量直接获取文章列表**\n\n## 功能特点\n\n- 保存公众号文章至本地\n- 支持将 HTML 文章转换为 PDF 格式（安装 [wkhtmltopdf](https://wkhtmltopdf.org/downloads.html))\n- 支持将 HTML 文章转换为 Word 格式（安装 [pandc](https://github.com/jgm/pandoc/releases))\n- 图片、音视频管理\n- 支持首页合集、标签合集保存\n- 保存原始地址\n- 跨平台支持：Windows、Mac 和 Linux\n- 使用 Go 语言开发，轻量级、高性能、高并发\n- 提供简单易用的 Web 界面管理\n\n## 使用文档\n\n**移步** [wiki](https://github.com/systemmin/wxdown/wiki)\n\n## 软件版本\n\n### v1.1.0 (当前版本)\n\n替换所有文件（不包含 `data`）\n\n- 解决部分 HTML 转 PDF 乱码问题 [issues 16](https://github.com/systemmin/wxdown/issues/16#) 。\n- 新增 HTML 转 Word 配置 [config.yaml#L38](https://github.com/systemmin/wxdown/blob/master/config.yaml#L38) ，需单独安装 [pandc](https://github.com/jgm/pandoc/releases) 工具。\n- 优化 Mac 默认配置开启转 PDF 功能时，导致 CPU 高占用问题 [issues 13](https://github.com/systemmin/wxdown/issues/13#) 。\n\n[下载地址](https://864000.lanzouu.com/b0hcyau5e) 密码：3ido\n\n### [历史版本](https://github.com/systemmin/wxdown/blob/master/CHANGELOG.md)\n\n## docker 运行\n\n创建挂载目录：\n\n```shell\nmkdir -p /home/wxdown/data\n```\n\n启动容器\n\n```shell\ndocker run -p 81:81 --name wxdown -d registry.cn-hangzhou.aliyuncs.com/wxdown/wxd:latest\n```\n\n拷贝配置文件\n\n```shell\ndocker cp wxdown:/wx/config.yaml /home/wxdown/\n```\n\n拷贝证书（可选）\n\n```shell\ndocker cp wxdown:/wx/certs/ /home/wxdown/\n```\n\n停掉\u0026删除容器\n\n```shell\ndocker stop wxdown \u0026\u0026 docker rm -f wxdown\n```\n\n挂载数据目录\n\n```shell\ndocker run -p 81:81 --name wxdown \\\n\t-v /home/wxdown/data/:/wx/data/ \\\n  \t-v /home/wxdown/config.yaml:/wx/config.yaml \\\n  \t-d registry.cn-hangzhou.aliyuncs.com/wxdown/wxd:latest\n```\n\n## 构建镜像\n\n[docker build](https://github.com/systemmin/wxdown/blob/master/docker/CMD.md)\n\n## 目录结构\n\n```text\nproject/\n│\n├── cmd/\n│   ├── yourapp/\n│   │   └── main.go\n│\n├── internal/\n│   ├── pkg1/\n│   │   ├── file1.go\n│   │   └── file2.go\n│   │\n│   └── pkg2/\n│       ├── file1.go\n│       └── file2.go\n│\n├── pkg/\n│   └── sharedpkg/\n│       ├── file1.go\n│       └── file2.go\n│\n├── config/\n│   └── config.go\n│\n├── web/\n│   ├── static/\n│   │   └── ...\n│   │\n│   ├── templates/\n│   │   └── ...\n│   │\n│   └── main.go\n│\n├── tests/\n│   └── ...\n│\n├── build.bat\n│\n├── config.yaml\n│\n├── Dockerfile\n│\n├── README.md\n│\n├── main.go\n│\n└── go.mod\n```\n\n- `cmd/`: 该目录用于存放项目的可执行文件，每个子目录代表一个可执行文件，命名一般为项目名或者服务名。\n- `internal/`: 该目录用于存放项目内部的私有代码，这些代码只能被当前项目使用，不能被外部包导入。通常会按照功能或模块划分子目录，并在其中编写相应的代码文件。\n- `pkg/`: 该目录用于存放可被其他项目导入和使用的代码包。这些包应该是稳定的、通用的、可复用的功能模块。比如一些工具函数、常用的数据结构等。\n- `config/`: 该目录用于存放项目的配置文件，比如 JSON、YAML 或者 properties 文件等。\n- `web/`: 该目录用于存放 Web 应用相关的代码，如前端静态文件、模板文件以及 Web 服务器的代码。\n- `tests/`: 该目录用于存放项目的测试代码，通常按照包的结构组织测试文件。\n- `build.bat`: window 下批处理打包脚本\n- `config.yaml`: 系统配置文件\n- `docker`: docker 镜像构建相关内容。\n- `README.md`: 项目的说明文档，包括项目的简介、安装、使用方法等信息。\n- `go.mod`: Go modules 的配置文件，用于管理项目的依赖关系。\n\n## 安装教程\n\n1. 确保您的计算机上已安装Go语言环境。\n   ```shell\n   go version 1.22.3\n   ```\n2. 克隆项目仓库：\n   ```shell\n   git clone https://github.com/systemmin/wxdown.git\n   ```\n3. 进入项目目录：\n   ```shell\n   cd wxdown\n   ```\n4. 安装项目依赖：\n   ```shell\n   go mod download\n   ```\n5. 编译项目：\n   ```shell\n   go build -ldflags \"-X main.runMode=binary -X main.version=1.0.0\" -o wxdown.exe  main.go\n   ```\n6. 运行项目：\n\n   ```shell\n   ./wxdown.exe\n   ```\n\n## 本地启动\n\n1. 安装项目依赖：\n\n```shell\ngo mod download\n```\n\n2. 根目录执行\n\n```shell\ngo run main.go\n```\n\n## 许可证\n\n本项目遵循 [Apache-2.0](https://spdx.org/licenses/Apache-2.0.html) 许可证。\n\n## 开发和贡献\n\n本软件使用 Go 语言开发，欢迎开发者贡献代码或提出改进建议。请在 [GitHub](https://github.com/systemmin/wxdown/issues) 上提交 issue 或 pull request。\n\n## 注意事项\n\n**注意：** 请确保遵循网站的使用条款和政策。自行承担风险。\n\n- 本软件完全免费。\n- 请勿传播未经授权的文章或图片。\n- 使用软件造成的影响由使用者承担。\n- 仅供学习交流，严禁用于商业用途，请勿传播下载的数据。\n- 本脚本所获取的资源完全合法，与浏览器能直接获得的资源一致。\n- 在保存、转换文章或管理图片时，请注意版权和法律规定。\n\n## 鼓励作者\n\n**您**的鼓励💪就是我前进的动力🫶鼓励方式有多种，选择你喜欢的😍，当然不鼓励也没关系哦！😄\n\n- [GitHub Start](https://github.com/systemmin/wxdown) ⭐\n- 打赏💰（*量力而行*）\n\n\u003cimg src=\"https://dtking.cn/pay.png\" alt=\"赞赏\" style=\"zoom: 67%;\" /\u003e","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsystemmin%2Fwxdown","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsystemmin%2Fwxdown","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsystemmin%2Fwxdown/lists"}