Skip to content

[Feature] Request: Add native HTTP/HTTPS proxy support in MaxKB system settings #4204

@itttttttsssss

Description

@itttttttsssss

MaxKB Version

2.2.1

Please describe your needs or suggestions for improvements

Hi MaxKB team,

First of all, thank you for building such a great open-source AI knowledge base tool! We're actively using MaxKB in our internal environment and it's been very helpful.

📌 Feature Request
We'd like to request a new system configuration option to allow MaxKB to use an HTTP/HTTPS proxy when calling external APIs (e.g., LLM providers like OpenAI, Gemini, or third-party data sources).

🌍 Use Case
Our server is deployed in mainland China, but we need to access overseas LLM APIs (e.g., OpenAI, Gemini,Anthropic) that require traffic to go through a proxy (e.g., corporate proxy or self-hosted forward proxy).
Currently, MaxKB does not respect system-level http_proxy environment variables, and there's no UI or config file option to specify a proxy.
As a result, API calls fail with timeout or connection errors unless we run the entire Docker container in host network mode with a system-wide VPN — which is not ideal for security or multi-tenant environments.

Please describe the solution you suggest

Using network_mode: host in Docker + system-wide proxy → breaks container isolation.
Modifying Docker daemon proxy settings → only affects image pulls, not runtime traffic.
Running a transparent proxy with iptables → complex and fragile.

Additional Information

No response

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions