Skip to content

fix: bind Qdrant to 127.0.0.1 to reduce port conflict#12

Merged
superdd-coder merged 1 commit into
mainfrom
fix/docker-port-conflict
Jul 9, 2026
Merged

fix: bind Qdrant to 127.0.0.1 to reduce port conflict#12
superdd-coder merged 1 commit into
mainfrom
fix/docker-port-conflict

Conversation

@superdd-coder

Copy link
Copy Markdown
Owner

问题

用户执行 docker compose up -d 时遇到:

Bind for 0.0.0.0:6343 failed: port is already allocated

Qdrant 端口绑定到 0.0.0.0(所有网络接口),容易被宿主机其他服务占用。

修复

  1. docker-compose.yml: Qdrant 端口改为绑定 127.0.0.1 而非 0.0.0.0
    • App 容器通过 Docker 内部网络 qdrant:6333 访问 Qdrant,不受影响
    • 减少端口对外暴露,降低冲突概率,更安全
  2. .env.template: 添加端口冲突时的排障提示

如果 127.0.0.1:6343 仍然被占用,在 .env 中修改 QDRANT_HTTP_PORT 即可。

@superdd-coder
superdd-coder force-pushed the fix/docker-port-conflict branch from be2281d to b1891aa Compare July 9, 2026 16:34
@superdd-coder
superdd-coder merged commit 2ac9659 into main Jul 9, 2026
4 of 6 checks passed
@superdd-coder
superdd-coder deleted the fix/docker-port-conflict branch July 10, 2026 08:18
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