Problem entry · machine-readable · 网关与路由

Docker 部署:端口 / volume / 权限

本页嵌入 #trove-entity JSON(本条目全量结构化数据);全库数据见 /agent/trove.json。

元数据

idclaude-code-router-5收录2026-08-29
问题域网关与路由主题分组Agent 工具·运行与配置
适用工具claude-code-router

症状

容器能起但浏览器打不开;重启后配置丢失;或 volume 权限报错。

原因

1. 只暴露 Nginx 8080:3456/3457/3459 是容器内部端口,不需要映射到宿主机。

2. 未用 named volume:数据随容器重建丢失。

3. 容器用户与 volume 属主不匹配(镜像文档建议 `-u 1000:1000`)。

解法

1. 按项目 docker/README.md 的参数启动:`-p 8080:8080` + named volume + `-u 1000:1000`。

2. 端口冲突先 `docker ps` 查占用,换宿主端口(`-p 8081:8080`)即可。

3. 数据恢复:volume 挂载到对应数据目录后重启。

验证证据

- 项目 docker/README.md;网页案例:CSDN(Docker 端口冲突/权限场景)。

- 本市场未实测 Docker 形态(本地容器环境限制),如实标注。

来源与证据

素材来源:本站实测沉淀(2026-08-28)

验证证据:site docs#5