Skip to content

docs(faq): use IP_WHITE_LIST for private-network model endpoints - #1580

Open
FenjuFu wants to merge 1 commit into
mainfrom
docs/faq-ip-whitelist-local-model
Open

docs(faq): use IP_WHITE_LIST for private-network model endpoints#1580
FenjuFu wants to merge 1 commit into
mainfrom
docs/faq-ip-whitelist-local-model

Conversation

@FenjuFu

@FenjuFu FenjuFu commented Jul 29, 2026

Copy link
Copy Markdown
Member

Relates to #1551.

Why

Adding a custom OpenAI-compatible model on a private-network endpoint (e.g. http://192.168.60.13:9090/v1/chat/completions) fails with "URL validation failed". As confirmed on #1551, the console backend runs the endpoint through its SSRF / private-IP policy before sending the validation request, so a reachable endpoint is still rejected.

The FAQ's existing advice was to clear the NETWORK_SEGMENT_BLACK_LIST — the wrong and less safe fix. #1562 added an explicit IP_WHITE_LIST allowlist for exactly this case, and that's the intended opt-in.

Changes

Update the two affected entries in faq/models.md:

  • Rewrite "添加本地模型报错 IP 在黑名单?" to cover the "URL validation failed" symptom and show the correct whitelist SQL (verified against the V1.43__add_ip_white_list_config.sql migration: category = 'IP_WHITE_LIST', code = 'ip_white_list').
  • Update the "如何配置本地服务" entry to point at the whitelist instead of editing the blacklist.

Both call out the two things that trip people up: the value must go into both config_info and config_info_en (the config table is selected by request locale), and the blacklist should be left intact.

Docs-only; no code change.

Adding a custom model on a private address (e.g. 192.168.x.x) fails with
"URL validation failed" because the SSRF/private-IP policy rejects it
before the validation request is sent. The FAQ previously told users to
clear the NETWORK_SEGMENT_BLACK_LIST, which is the wrong, less safe
workaround.

Update the two model FAQ entries to use the IP_WHITE_LIST allowlist added
in #1562: whitelist the exact IP/CIDR in both config_info and
config_info_en, and keep the blacklist intact.

Signed-off-by: FenjuFu <92919259+FenjuFu@users.noreply.github.com>
@gemini-code-assist

Copy link
Copy Markdown
Contributor

Caution

The consumer version of Gemini Code Assist on GitHub has been sunset. All code review activity has officially ceased.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant