概述

FaviconDL

> 通过命令行下载任意网站 favicon / Download favicon for any domain via CLI

简介 / Overview

FaviconDL 是一款基于 favicondl.com API 的命令行工具，可一键下载任意网站的高质量 favicon 图标。支持自定义尺寸、多种格式，并提供 PowerShell 与 Bash 双版本，零依赖即可使用。

FaviconDL is a lightweight CLI tool powered by favicondl.com API. Download high-quality favicon images for any domain in any supported size — no API key required.

功能 / Features

功能 Feature	说明 Description
------------	-----------------
多尺寸支持 Multi-size	支持 16 / 32 / 48 / 64 / 128 / 256 / 512 px
302 重定向 redirect	自动跟随重定向，直接下载 PNG 文件
无依赖 Zero dependency	仅需 curl（PowerShell 内置或系统自带）
双端支持 Cross-platform	PowerShell (Windows) + Bash (Linux/macOS)
批量下载 Batch	支持多域名连续下载

安装 / Installation

Windows（PowerShell）

# 下载脚本到本地
curl -L -o "$env:USERPROFILE\favicondl.ps1" "https://raw.githubusercontent.com/sweesama/favicondl.com/main/favicondl.ps1"

# 添加到 PATH（可选）
# 将 $env:USERPROFILE 加入系统 PATH 环境变量

Linux / macOS（Bash）

curl -L -o ~/favicondl.sh "https://raw.githubusercontent.com/sweesama/favicondl.com/main/favicondl.sh"
chmod +x ~/favicondl.sh
sudo ln -s ~/favicondl.sh /usr/local/bin/favicondl

使用方法 / Usage

基本语法 / Syntax

# PowerShell
.\favicondl.ps1 -Domain <域名> [-Size <尺寸>] [-Output <保存路径>]

# Bash
./favicondl.sh <域名> [尺寸] [保存路径]

参数说明 / Parameters

参数 Parameter	必填 Required	默认值 Default	说明 Description
--------------	-------------	--------------	----------------
`-Domain` / `<域名>`	✅	—	目标网站域名，如 `github.com`
`-Size` / `[尺寸]`	❌	`128`	图片尺寸，可选 16/32/48/64/128/256/512
`-Output` / `[路径]`	❌	`./favicon.png`	保存文件路径

示例 / Examples

# 下载 GitHub 128px favicon（默认尺寸）
.\favicondl.ps1 -Domain "github.com"

# 下载 256px 大图
.\favicondl.ps1 -Domain "github.com" -Size 256

# 保存到指定路径
.\favicondl.ps1 -Domain "github.com" -Size 128 -Output "C:\icons\gh.png"

# 批量下载多个域名
.\favicondl.ps1 -Domain "github.com"
.\favicondl.ps1 -Domain "openai.com"
.\favicondl.ps1 -Domain "anthropic.com"

# 下载 GitHub favicon
./favicondl.sh github.com

# 下载 256px 版本
./favicondl.sh github.com 256

# 保存到指定路径
./favicondl.sh github.com 128 ./icons/gh.png

输出示例 / Output Example

Fetching favicon for github.com at 128px...
Saved: ./github_favicon.png (6518 bytes) ✅

API 详情 / API Details

本工具调用 favicondl.com 提供的免费 API，无需注册、无需 API Key。

Under the hood, this tool calls the free favicondl.com API — no registration, no API key required.

端点 / Endpoint

GET https://favicondl.com/api/favicon?domain={domain}&size={size}&format=redirect

参数 / Parameters

参数	类型	说明
------	------	------
`domain`	string	目标域名，如 `github.com`
`size`	integer	图片像素尺寸，可选 16/32/48/64/128/256/512
`format=redirect`	string	返回 302 重定向到实际 PNG 文件

响应 / Response

状态码 Status: 302 Found
Location: 目标网站 favicon URL
最终内容: PNG 图片文件

适用场景 / Use Cases

场景 Scenario	说明 Description
-------------	-----------------
🌍 GEO 外链提交	为目录站提交准备网站 logo
🎨 设计素材采集	快速获取竞品或参考网站的图标资源
🔍 SEO / 书签	为书签页面、导航页批量获取网站图标
📱 App Icon 备选	快速预览主流网站的品牌图标设计
🤖 AI Agent 工作流	集成进自动化脚本，定向抓取网站图标

错误处理 / Error Handling

错误类型 Error	原因 Cause	解决方案 Solution
--------------	-----------	-----------------
`HTTP 404`	目标网站无 favicon	换用 Google Favicon 备选方案
`HTTP 5xx`	API 服务端异常	稍后重试或检查网络连接
文件写入失败	路径无权限或磁盘满	更换输出路径或以管理员运行

项目 Project	地址 Link
------------	----------
🌐 FaviconDL 官网	https://favicondl.com
📦 NPM 版本	https://www.npmjs.com/package/favicondl
💻 源码仓库	https://github.com/sweesama/favicondl.com
🐟 水产市场发布	https://openclawmp.cc/asset/s-5a9fb4e7ff343062

更新日志 / Changelog

v1.0.0

首发版本 / Initial release
支持 PowerShell + Bash 双端
支持 7 种尺寸（16-512px）
302 重定向自动下载 PNG

版本历史

共 1 个版本

v1.0.4 当前

2026-03-31 04:41 安全安全

安全检测

腾讯云安全 (Keen)

安全，无风险

查看报告

腾讯云安全 (Sanbu)