besticon是一个用Go语言编写的网站图标服务

besticon

这是一个网站图标服务：

• 支持 favicon.ico 和 apple-touch-icon.png

• 简洁的 URL API

• 备用图标生成

• 提供 Docker 镜像和单个二进制文件下载，方便轻松托管

这是什么？

网站过去要么有 favicon.ico，要么没有。随着 apple-touch-icon.png 的引入，为网站查找“图标”变得更加复杂。此服务用于查找网站图标，并在必要时生成图标。

API

GET /icon

此端点始终返回给定网站的图标图像——如果可能，它会重定向到官方图标；如果需要，它会创建并返回一个备用图像。

GET /allicons.json

此端点返回指定网站的所有图标。

示例

• https://besticon-demo.herokuapp.com/allicons.json?url=github.com

• https://besticon-demo.herokuapp.com/allicons.json?url=github.com&formats=png

已知问题和限制

我尽力使这个图标实用，但请注意，它存在一些已知限制：

• 对字母图标的国际化支持不佳 (#13)

欢迎在 https://github.com/mat/besticon/issues 提交其他错误报告并提供帮助。

托管

以下是一些简单的托管选项，例如：

• Render：https://render.com/deploy?repo=https://github.com/mat/besticon

• Heroku：https://heroku.com/deploy

• Google Cloud Run：https://deploy.cloud.run

Docker

Docker 镜像可在 https://hub.docker.com/r/matthiasluedtke/iconserver/ 获取，该镜像基于本仓库中的 Dockerfile 生成。我会尽量在每个版本发布时更新该镜像。

请注意，此 Docker 镜像并未用于运行 https://besticon-demo.herokuapp.com，因此未经充分测试。

监控

Prometheus 指标已在 /metrics 下公开。基于这些指标的 Grafana 仪表盘配置位于 grafana-dashboard.json。

服务器可执行文件

下载二进制文件

部分操作系统的二进制文件可从 https://github.com/mat/besticon/releases/latest 下载。

自行构建

如果您的系统已安装 Go，则可以使用 go get 获取源代码并构建服务器：

$ go get -u github.com/mat/besticon/v3/...

如果您想为其他目标操作系统构建可执行文件，可以添加 GOOS 和 GOARCH 环境变量：

$ GOOS=linux GOARCH=amd64 go get -u github.com/mat/besticon/v3/...

运行中

要使用默认端口 8080 启动服务器，只需执行以下命令：

$ iconserver

要使用其他端口，请使用：

$ PORT=80 iconserver

要监听其他地址（例如 localhost），请使用：

$ ADDRESS=127.0.0.1 iconserver

要启用 CORS 标头，您需要设置 CORS_ENABLED=true。您还可以选择设置其他环境变量，这些变量将作为选项传递给rs/cors 中间件。

$ CORS_ENABLED=true iconserver

现在，当您打开 http://localhost:8080/icons?url=instagram.com 时，您应该会看到类似以下内容：

配置

配置项不多，但需要设置以下环境变量：

许可证

MIT 许可证 (MIT)