From 73396cd5d4a3a9ad4e93e25174f942bc6af14b3c Mon Sep 17 00:00:00 2001
From: JianFeeeee <JianFeeeee@users.noreply.gitcode.com>
Date: Fri, 11 Sep 2026 11:00:40 +0800
Subject: [PATCH] docs: document NAVI_FAVICON_PROXY and pass it through compose
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

新增的 favicon 抓取代理变量此前只存在于代码里：
- .env.example 补充说明与示例（默认留空，自动复用 SearXNG 的 outgoing.proxies）
- docker-compose.yml 透传该变量
- README 环境变量表补一行
---
 .env.example       | 6 ++++++
 README.md          | 1 +
 docker-compose.yml | 4 ++++
 3 files changed, 11 insertions(+)

diff --git a/.env.example b/.env.example
index e30da55..c2bd171 100644
--- a/.env.example
+++ b/.env.example
@@ -15,3 +15,9 @@ NAVI_SYNC_TOKEN=
 
 # 管理后台/API 写操作令牌（建议生成随机长串）
 NAVI_ADMIN_TOKEN=
+
+# ── 历史条目的站点图标（一般不用填）──
+# 服务端会后台抓取每个历史 host 的 favicon 并缓存到 data/item-icons/。
+# 内网地址只直连；外网站点直连失败时会自动复用下面 searxng-settings.yml
+# 里 outgoing.proxies 的代理。仅当需要单独指定时才取消注释：
+# NAVI_FAVICON_PROXY=http://<proxy-ip>:7890
diff --git a/README.md b/README.md
index af121f2..0cbcdeb 100644
--- a/README.md
+++ b/README.md
@@ -133,6 +133,7 @@ icon: fas fa-star    # Font Awesome
 | `NAVI_ADMIN_TOKEN` | 管理后台/API 写操作令牌 | 空（不鉴权） |
 | `SEARXNG_BASE_URL` | 对外访问地址，影响搜索结果链接 | `http://localhost:3003` |
 | `NAVI_PORT` | compose 对外端口 | `3003` |
+| `NAVI_FAVICON_PROXY` | 抓历史图标用的代理；留空自动复用 `searxng-settings.yml` 的 `outgoing.proxies` | 空 |
 
 ## 浏览器扩展
 
diff --git a/docker-compose.yml b/docker-compose.yml
index 0d2da39..a224071 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -22,6 +22,10 @@ services:
       # ---- 对外访问地址（公网域名，影响搜索结果页链接）----
       # 例如 https://nav.example.com （不含 /search 子路径）
       - SEARXNG_BASE_URL=${SEARXNG_BASE_URL:-http://localhost:3003}
+
+      # ---- 历史条目图标抓取（可选）----
+      # 留空则自动复用 searxng-settings.yml 里 outgoing.proxies 的代理
+      - NAVI_FAVICON_PROXY=${NAVI_FAVICON_PROXY:-}
     healthcheck:
       test: ["CMD", "curl", "-fs", "http://localhost:8080/healthz"]
       interval: 30s